+ * This class provides configuration options for setting up an A2A server, including agent + * metadata, capabilities, and server settings. + * + *
+ * Properties can be configured in application.yml or application.properties:
+ * a2a: + * server: + * enabled: true + * name: My A2A Agent + * description: A sample A2A agent + * version: 1.0.0 + * url: ... + * capabilities: + * streaming: true + * push-notifications: false + * state-transition-history: true + *+ * + */ +@ConfigurationProperties(prefix = "a2a.server") +public class A2AServerProperties implements Serializable { + + @Serial + private static final long serialVersionUID = -608274692651491547L; + + /** + * Whether the A2A server is enabled. + */ + private boolean enabled = false; + + /** + * The unique agent id + */ + private String id; + + /** + * The name of the agent. + */ + private String name; + + /** + * A description of what the agent does. + */ + private String description; + + /** + * The version of the agent. + */ + private String version; + + /** + * The base URL where the agent can be reached. + */ + private String url; + + /** + * Information about the provider of the agent. + */ + private Provider provider; + + /** + * An optional URL pointing to the agent's documentation. + */ + private String documentationUrl; + + /** + * Agent capabilities configuration. + */ + private Capabilities capabilities = new Capabilities(); + + /** + * Authentication details required to interact with the agent. + */ + private Authentication authentication = new Authentication(); + + /** + * Security scheme details used for authenticating with this agent. + */ + private Map
+ * This class defines what features the agent supports, such as streaming responses,
+ * push notifications, and state history.
+ */
+ public static class Capabilities implements Serializable {
+
+ private static final long serialVersionUID = 2371695651871067858L;
+
+ /**
+ * Whether the agent supports streaming responses.
+ */
+ private boolean streaming = true;
+
+ /**
+ * Whether the agent supports push notifications.
+ */
+ private boolean pushNotifications = false;
+
+ /**
+ * Whether the agent maintains state transition history.
+ */
+ private boolean stateTransitionHistory = true;
+
+ /**
+ * Returns whether streaming is supported.
+ *
+ * @return true if streaming is supported, false otherwise
+ */
+ public boolean isStreaming() {
+ return streaming;
+ }
+
+ /**
+ * Sets whether streaming is supported.
+ *
+ * @param streaming true to enable streaming support, false to disable
+ */
+ public void setStreaming(boolean streaming) {
+ this.streaming = streaming;
+ }
+
+ /**
+ * Returns whether push notifications are supported.
+ *
+ * @return true if push notifications are supported, false otherwise
+ */
+ public boolean isPushNotifications() {
+ return pushNotifications;
+ }
+
+ /**
+ * Sets whether push notifications are supported.
+ *
+ * @param pushNotifications true to enable push notification support, false to
+ * disable
+ */
+ public void setPushNotifications(boolean pushNotifications) {
+ this.pushNotifications = pushNotifications;
+ }
+
+ /**
+ * Returns whether state transition history is supported.
+ *
+ * @return true if state transition history is supported, false otherwise
+ */
+ public boolean isStateTransitionHistory() {
+ return stateTransitionHistory;
+ }
+
+ /**
+ * Sets whether state transition history is supported.
+ *
+ * @param stateTransitionHistory true to enable state transition history, false to
+ * disable
+ */
+ public void setStateTransitionHistory(boolean stateTransitionHistory) {
+ this.stateTransitionHistory = stateTransitionHistory;
+ }
+
+ }
+
+ /**
+ * Configuration for agent provider information.
+ */
+ public static class Provider implements Serializable {
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * The name of the provider.
+ */
+ private String name;
+
+ /**
+ * The URL of the provider.
+ */
+ private String url;
+
+ public String getName() {
+ return name;
+ }
+
+ public void setName(String name) {
+ this.name = name;
+ }
+
+ public String getUrl() {
+ return url;
+ }
+
+ public void setUrl(String url) {
+ this.url = url;
+ }
+ }
+
+ /**
+ * Configuration for agent authentication.
+ */
+ public static class Authentication implements Serializable {
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * The type of authentication.
+ */
+ private String type;
+
+ public String getType() {
+ return type;
+ }
+
+ public void setType(String type) {
+ this.type = type;
+ }
+ }
+
+ /**
+ * Configuration for security scheme.
+ */
+ public static class SecurityScheme implements Serializable {
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * The type of security scheme.
+ */
+ private String type;
+
+ public String getType() {
+ return type;
+ }
+
+ public void setType(String type) {
+ this.type = type;
+ }
+ }
+
+ /**
+ * Configuration for agent skill.
+ */
+ public static class Skill implements Serializable {
+ private static final long serialVersionUID = 1L;
+
+ /**
+ * The name of the skill.
+ */
+ private String name;
+
+ /**
+ * The description of the skill.
+ */
+ private String description;
+
+ /**
+ * Set of tag words describing classes of capabilities for this specific skill.
+ * Example: ["cooking", "customer support", "billing"]
+ */
+ private List