Agentic Data Plane

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.

Usage

rpk ai agent a2a [flags]

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-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

Subcommands

Command Description

rpk ai agent a2a card

Fetch the A2A agent card: the JSON discovery document describing the agent’s identity, skills, supported transports and capabilities. Use -o json to feed the raw card to other tools.

rpk ai agent a2a send

Send a text message to an agent over A2A and print the reply. The message comes from the positional argument, or from stdin when the argument is omitted or "-" (so you can pipe a prompt in).

rpk ai agent a2a task

Manage tasks created by agent-to-agent (A2A) conversations. Task IDs come from rpk ai agent a2a send replies.

Global flags

Value Type Description

--config

string

Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml.

-X, --config-opt

stringArray

Override rpk configuration settings; -X help for detail or -X list for terser detail.

--ignore-profile

bool

Ignore rpk.yaml and redpanda.yaml; use default settings.

--profile

string

rpk profile to use.

-v, --verbose

bool

Enable verbose logging.