A2A.AgentExtension (A2A v0.3.0)

Copy Markdown View Source

Declaration of a protocol extension supported by an agent.

Mirrors the AgentExtension object from the A2A v1.0 spec. Used both as a struct embedded in AgentCard.capabilities.extensions and as the value returned by an A2A.Extension module's declaration/1 callback.

Fields

  • :uri — unique identifier for the extension (required)
  • :description — human-readable description of how the agent uses it
  • :required — if true, clients must declare support via the A2A-Extensions request header; otherwise the server returns ExtensionSupportRequiredError (-32008). Defaults to false.
  • :params — optional extension-specific configuration parameters

Examples

%A2A.AgentExtension{
  uri: "https://a2a-protocol.org/extensions/timestamp",
  description: "Adds timestamps to messages and artifacts"
}

%A2A.AgentExtension{
  uri: "https://a2a-protocol.org/extensions/secure-passport",
  description: "Personalization via signed passport",
  required: true,
  params: %{"version" => "1.0"}
}

Summary

Types

t()

Types

t()

@type t() :: %A2A.AgentExtension{
  description: String.t() | nil,
  params: map() | nil,
  required: boolean(),
  uri: String.t()
}