Streaming

rpk connect agent run

This command is experimental and subject to change.

Execute a Redpanda Connect agent as part of a pipeline that has access to tools via the Model Context Protocol (MCP). The command first reads resource definitions from the mcp subdirectory and exposes them as tools. It then runs the agent defined in redpanda_agents.yaml along with any Python agent modules.

Use this reference to:

  • Find the syntax for executing agents

  • Identify secret management options

  • Look up security-related flags

Usage

rpk connect agent run [OPTIONS]

Example

rpk connect agent run ./repo

To disable all secret lookups:

rpk connect agent run --secrets none: ./repo

Flags

Option Description

--secrets

Attempt to load secrets from a provided URN. If more than one entry is specified, they are attempted in order until a value is found. Environment variable lookups are specified with the URN env:, which by default is the only entry. To disable all secret lookups, specify a single entry of none: (default: env:).

--redpanda-license

Provide an explicit Redpanda license, which enables enterprise functionality. By default, licenses found at the path /etc/redpanda/redpanda.license are applied.

--help, -h

Show help for the command.

--chroot

(Linux only) Chroot into the provided directory after parsing configuration. Common /etc/ files are copied to the chroot directory, and the directory is made read-only.

--chroot-passthrough

(Linux only) Specify additional files to be copied into the chroot directory. Can be specified multiple times. Only valid when --chroot is used.