Agent Spec Reference

Agent Studio stores each workspace agent as a structured specification. Most users edit the form view. Advanced users may inspect or edit YAML.

Field Groups

Group	Purpose
Display	Name, label, and description shown in the dashboard.
Model	The model route used for the agent.
Prompt	Instructions and included knowledge context.
Capabilities	Tools and connectors the agent may use.
Session	Whether the agent can be discovered or dispatched.
Policy	Guardrails for the agent's environment and channel.

Agent names should be stable and machine-readable. Use lowercase letters, numbers, and hyphens.

website-support
support-triage
internal-help

Each published agent has a version. Change the version when behavior changes or when a published version already exists.