Agentic Data Plane

rpk ai agent

Manage agents registered with the Redpanda AI platform.

Agents are either managed (adp runs them; configured via a model, LLM provider, system prompt and MCP servers) or self-managed (a metadata-only record tracking a user-hosted agent). create makes a managed agent by default; pass --self-managed for the metadata-only variant.

The credential subcommand provisions client-id/secret pairs an agent uses to authenticate against the gateway. The a2a subcommand talks to a running agent over the A2A protocol (fetch its card, send messages, manage tasks).

Usage

rpk ai agent [flags]

Subcommands

Command Description

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://).

rpk ai agent apply

Reconcile agents from one or more YAML manifests. For each manifest: create the resource if absent, otherwise update every field that differs from the live resource.

rpk ai agent create

Create an agent. Defaults to a managed agent populated from the spec flags; --self-managed registers the metadata-only variant.

rpk ai agent credential

Manage an agent’s credentials (create, list, delete).

rpk ai agent delete

Delete an agent.

rpk ai agent diff

Dry-run of apply for agents. Prints, per manifest, whether apply would create, update (and which fields), or leave the resource unchanged.

rpk ai agent get

Get an agent.

rpk ai agent list

List agents.

rpk ai agent start

Start a managed agent, setting its desired state to running.

rpk ai agent stop

Stop a managed agent, setting its desired state to stopped.

rpk ai agent transcript

Inspect an agent’s conversation transcripts (list, get).

rpk ai agent update

Update an agent.

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.