Agentic Data Plane

rpk ai trigger

Manage the triggers on an agent: the configured ways an agent is invoked from the outside (Microsoft Teams, or a cron schedule).

A trigger belongs to exactly one agent, and its resource name carries that parent: agents/{agent}/triggers/{trigger}. So create and list take the parent agent, while get, update, delete and runs take the full two-segment name they print.

The trigger id is server-assigned unless you pass --id. The kind (--teams-* or --cron-*) is fixed at creation; to change it, delete and recreate.

adp-api is a registry: it stores the trigger config but never validates the credentials or resolves the secret refs. A trigger that is accepted here can still be reported unhealthy by the component that operates it.

Usage

rpk ai trigger [flags]

Subcommands

Command Description

rpk ai trigger apply

Reconcile triggers 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 trigger create

Create a trigger on <agent>, given as the agent id (my-agent) or its resource name (agents/my-agent). Exactly one kind: the --teams-* flags register a Microsoft Teams entry point, the --cron-* flags a schedule.

rpk ai trigger delete

Delete one trigger. <name> is the full resource name, for example, agents/my-agent/triggers/t1a2b3c4.

rpk ai trigger diff

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

rpk ai trigger get

Get one trigger. <name> is the full resource name, for example, agents/my-agent/triggers/t1a2b3c4.

rpk ai trigger list

List every trigger on <agent>, given as the agent id (my-agent) or its resource name (agents/my-agent).

rpk ai trigger runs

List the recorded fires of a cron trigger, newest first. <name> is the full trigger resource name, for example, agents/my-agent/triggers/t1a2b3c4.

rpk ai trigger update

Update one trigger. <name> is the full resource name, for example, agents/my-agent/triggers/t1a2b3c4.

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.