rpk ai agent a2a
Interact with an agent over the A2A (Agent-to-Agent) protocol.
The AGENT argument is either a registry agent name (resolved to the agent’s A2A endpoint via its runtime status) or a full A2A endpoint URL (anything starting with http:// or https://).
Authentication: your environment’s bearer token is attached when the target is a registry agent or an explicit URL on the environment’s dataplane host. Explicit URLs on other hosts are called without credentials so your token never leaves the platform (a note on stderr says so when this happens).
Output formats: table (default, human-readable) and -o json / -o yaml.
Streams (--stream, task watch) emit one JSON event per line under both
json and yaml.
Exit codes: 0 success (including tasks waiting for more input), 4 task ended failed/canceled/rejected, 1 anything else.
Examples
This section provides examples of how to use rpk ai agent a2a.
Discover what an agent can do
rpk ai agent a2a card financial-advisorAsk a question (waits for the reply)
rpk ai agent a2a send financial-advisor "How did tech stocks do today?"Continue the same conversation
rpk ai agent a2a send financial-advisor --context-id CTX "And yesterday?"Stream the reply as it is produced
rpk ai agent a2a send financial-advisor --stream "Summarize the market"Inspect, watch, or cancel a long-running task
rpk ai agent a2a task get financial-advisor TASK_ID
rpk ai agent a2a task watch financial-advisor TASK_ID
rpk ai agent a2a task cancel financial-advisor TASK_IDGlobal flags
| Value | Type | Description |
|---|---|---|
|
string |
Redpanda or |
|
stringArray |
Override |
|
bool |
Ignore |
|
string |
|
|
bool |
Enable verbose logging. |
