Agentic Data Plane
beta

rpk ai agent create

Create an agent

Usage

rpk ai agent create <name> [flags]

Flags

Value Type Description

--description

string

longer description of the agent’s purpose.

--display-name

string

display name.

-h, --help

-

help for create.

--llm-provider

string

name of the LLM provider resource the agent uses.

--max-iterations

int32

maximum agent loop iterations per invocation.

--mcp-server

strings

MCP server resource name the agent may call (repeatable).

--model

string

model the agent runs (e.g. claude-sonnet-4-6).

--self-managed

-

register a metadata-only self-managed agent (the platform won’t run it).

--spec-file

string

path to a JSON/YAML ManagedAgentSpec; enables subagents/agent_card that scalar flags can’t express (mutually exclusive with --self-managed and the spec flags).

--system-prompt

string

system prompt for the agent.

--tag

stringToString

metadata tag key=value (repeatable) (default []).

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