AgentCard specification

  • Release version: Australia
  • Updated May 13, 2026
  • 1 minute to read

    • View the definition and field reference for the A2A discovery manifest used by the ServiceNow AI Agent Studio.

    The AgentCard is the A2A discovery manifest that identifies the agent to any conforming orchestrator. It is served at the agent's well-known discovery endpoint and is what ServiceNow AI Agent Studio reads when you register the external agent.

    AgentCard definition

    AgentCard(
   name            = "Config Converse A2A Middleware",
   description     = "Middleware service that bridges other agents with Config
                     Converse using A2A protocol to configure products based on
                     context provided by other agents. Provides industry-standard
                      A2A protocol interface with JSON-RPC transport.",
   url             = <base_url>,           # your Logik tenant base URL
   version         = "1.0.0",
   protocol_version= "0.3.0",
   preferred_transport = TransportProtocol.jsonrpc,
   default_input_modes = ConfigConverseAgent.SUPPORTED_CONTENT_TYPES,
   default_output_modes= ConfigConverseAgent.SUPPORTED_CONTENT_TYPES,
   capabilities    = capabilities,
   skills          = [skill],
   security_schemes= {
      "bearer": HTTPAuthSecurityScheme(
           type          = "http",
           scheme        = "bearer",
           bearer_format = None,
          description   = "Logik phantom token. Obtain from Logik Admin UI
                           under Settings -> Runtime Clients. Token must
                           have CONFIG permission."
       )
   },
   security        = [{"bearer": []}]
)

    Field reference

    Table 1. A2A AgentCard field reference
    Field Type Description
    name string Human-readable display name shown in AI Agent Studio.
    url string (URL) Base URL of the running middleware. Must be reachable from ServiceNow.
    version semver Agent implementation version. Increment on breaking changes.
    protocol_version string A2A protocol version this agent complies with. Currently 0.3.0.
    preferred_transport enum Set to jsonrpc. Orchestrators should default to JSON-RPC when contacting this agent.
    default_input_modes list[string] MIME types accepted as input. Populated from ConfigConverseAgent.SUPPORTED_CONTENT_TYPES.
    default_output_modes list[string] MIME types returned as output. Matches input modes.
    capabilities object Structured capability flags declared by the agent to the orchestrator.
    skills list[skill] One or more skill descriptors defining what tasks this agent can perform.
    security_schemes object Declares the bearer scheme. Key must match the entry in the security list.
    security list[object] Enforces bearer auth on all agent interactions.