agentvisor a2a

Interact with the external A2A (Agent-to-Agent) agents configured under a2a_gateway.agents in agentvisor.yaml.

Synopsis

agentvisor a2a <subcommand> [options]

Subcommands

Subcommand	Description
probe	Test connectivity to a configured A2A agent

---

probe

Run a staged connectivity check against one configured A2A agent, using the same config file the full runtime would load — without starting Temporal, the policy engine, or a sandbox. This turns an "edit your config, set an env var, boot the full runtime, and see what happens" round trip into one command.

agentvisor a2a probe <name> [options]

Arguments

Argument	Description
<name>	Agent name, exactly as it appears under a2a_gateway.agents[].name in the loaded config

Options

Option	Default	Description
--timeout	10s	Maximum time to wait for the probe to complete

What It Checks

Probe runs three stages:

1. connect — a real TCP connection (and, for https://, a TLS handshake using the same trust configuration the real client would use)
2. agent-card — fetches /.well-known/agent-card.json
3. tasks/list — lists the agent's tasks

An agent that doesn't implement tasks/list (a JSON-RPC method-not-found response) is reported unsupported, not failed — it's still a reachable, working agent overall.

An agent configured with a principal-bound credential (principal_passthrough, token_exchange) has no principal available in a CLI context, so probe only runs the connect stage and reports the credential path as skipped, not failed.

Exit Codes

Code	Meaning
0	Agent is reachable
1	A required stage failed
2	Usage or config error (unknown agent name, credential resolution failure)

Example Output

$ agentvisor a2a probe research-agent --config agentvisor.yaml
Agent      research-agent
Endpoint   https://research-agent.example.com
TLS        verify-full (system roots)

  ✓ connect          11ms
  ✓ agent-card        38ms  ResearchAgent (1.2.0)
  ✓ tasks/list         7ms

  ✓ A2A agent "research-agent" is reachable

Examples

# Probe a configured A2A agent
agentvisor a2a probe research-agent --config agentvisor.yaml

# Use a longer timeout for a slow upstream
agentvisor a2a probe internal-agent --timeout 30s

See Also

• A2A Gateway — Configuring a2a_gateway.agents and credentials