Agentic Data Plane

rpk ai budget create

Create a Budget.

This command was introduced in ai version 0.2.94.

Usage

rpk ai budget create NAME [flags]

Examples

This section provides examples of how to use rpk ai budget create.

rpk ai budget create openai-monthly --pooling-mode shared --filter-provider-names openai --period monthly --limit-usd 100 --warn-at-usd 80
rpk ai budget create team-monthly --pooling-mode shared --filter-agent-tags '{"key":"team","values":["payments","billing"]}' --period monthly --limit-usd 100 --warn-at-usd 80
rpk ai budget create invoice-monthly --pooling-mode per-agent --filter-agent-name agents/invoice --period monthly --limit-usd 10 --warn-at-usd 8
rpk ai budget create preview -f budget.yaml --dry-run

Flags

Value Type Description

--display-name

string

Display name.

--filter-agent-name

string

Filter agent name.

--filter-agent-tags

Budget.filter_agent_tags

See Budget.filter_agent_tags. (repeatable; key (bare values comma-split) or protojson object; replaces the full list on update).

--filter-provider-names

Budget.filter_provider_names

See Budget.filter_provider_names. (repeatable; replaces the full list on update).

--pooling-mode

string

Pooling mode. (one of: per-agent, shared; required).

--period

string

Period. (one of: daily, weekly, monthly; required).

--limit-microcents

int

Limit microcents.

--warn-at-microcents

int

Warn at microcents.

--notification-user-ids

Budget.notification_user_ids

See Budget.notification_user_ids. (repeatable; replaces the full list on update).

--tags

stringArray

Tags. (repeatable key=value; replaces the full map on update).

-f, --filename

string

manifest to create from (YAML or JSON; "-" for stdin); flags override file values.

--dry-run

bool

print the request that would be sent (with the computed update mask) and exit without calling the server.

--limit-usd

string

positive USD amount with up to 8 decimal places; alternative to --limit-microcents (for example, 12.50). (New in 0.2.98)

--warn-at-usd

string

positive USD amount with up to 8 decimal places; alternative to --warn-at-microcents (for example, 12.50). (New in 0.2.98)

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.