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 profile’s bearer token is attached when the target is a registry agent or an explicit URL on the profile’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.

Usage

rpk ai agent a2a [command]

Examples

# Discover what an agent can do
rpk ai agent a2a card financial-advisor

# Ask 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_ID

Flags

Value Type Description

Value	Type	Description
`-h, --help`	-	help for a2a.
`-o, --format`	string	output format: table\|wide\|json\|yaml\|markdown (env: RPAI_FORMAT) (default "table").
`--no-color`	-	disable colored output (env: NO_COLOR).
`-c, --rpai-config`	string	path to rpai config (env: RPAI_CONFIG) (default "/var/lib/redpanda/.rpai/config").
`-s, --rpai-endpoint`	string	override the selected environment’s AI Gateway URL for this invocation.
`-p, --rpai-profile`	string	rpai profile name (env: RPAI_PROFILE).
`-v, --rpai-verbose`	-	verbose debug logging to stderr (env: RPAI_VERBOSE).
`--token`	string	static bearer token override (ambient RPAI_TOKEN is ignored under rpk ai) Use "rpk ai agent a2a [command] --help" for more information about a command.

-h, --help

help for a2a.

-o, --format

string

output format: table|wide|json|yaml|markdown (env: RPAI_FORMAT) (default "table").

--no-color

disable colored output (env: NO_COLOR).

-c, --rpai-config

string

path to rpai config (env: RPAI_CONFIG) (default "/var/lib/redpanda/.rpai/config").

-s, --rpai-endpoint

string

override the selected environment’s AI Gateway URL for this invocation.

-p, --rpai-profile

string

rpai profile name (env: RPAI_PROFILE).

-v, --rpai-verbose

verbose debug logging to stderr (env: RPAI_VERBOSE).

--token

string

static bearer token override (ambient RPAI_TOKEN is ignored under rpk ai) Use "rpk ai agent a2a [command] --help" for more information about a command.