Share feedback
Answers are generated based on the documentation.

A2A Tool

Table of contents

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 ${env.A2A_TOKEN}"
      X-Tenant: "acme"

Properties

PropertyTypeRequiredDescription
urlstring✓A2A server endpoint URL (must include scheme).
namestring✗Tool name registered for the remote agent. Defaults to a name derived from the server's agent card.
headersmap[string]string✗Extra HTTP headers sent with every request (useful for Authorization, tenant selection, tracing, \u2026).
Tip

See also

For full details on the A2A protocol and serving agents as A2A endpoints, see A2A Protocol.