A2A Tool

Connect to remote agents via the Agent-to-Agent protocol.

Overview

The A2A tool connects to a remote agent exposed over the A2A (Agent-to-Agent) protocol. Unlike handoff, which only targets local agents declared in the same config, a2a reaches out to an agent running on the network.

Configuration

toolsets:
  - type: a2a
    url: "http://localhost:8080/a2a"
    # Optional: custom tool name (defaults to a sanitized form of the URL / agent card name)
    name: research_agent
    # Optional: custom HTTP headers (typically for auth)
    headers:
      Authorization: "Bearer ${A2A_TOKEN}"
      X-Tenant: "acme"

Properties

Property	Type	Required	Description
`url`	string	✓	A2A server endpoint URL (must include scheme).
`name`	string	✗	Tool name registered for the remote agent. Defaults to a name derived from the server’s agent card.
`headers`	map[string]string	✗	Extra HTTP headers sent with every request (useful for `Authorization`, tenant selection, tracing, \u2026).