Agentic Data Plane
Preview

rpk ai agent create

Create an agent.

Usage

rpk ai agent create [flags]

Flags

Value Type Description

--description

string

longer description of the agent’s purpose.

--display-name

string

display name.

--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 (for example, claude-sonnet-4-6).

--self-managed

bool

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

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.