Skip to main content

Prompt definitions

Prompts define system instructions, a model, available tools, and context controls. Standard Agents Builder discovers them in agents/prompts/.

Callable tools

A prompt’s tools array accepts:
  • A callable name as a string.
  • A SubpromptConfig with result filters and input mappings.
  • A PromptToolConfig with scoped environment values and static options.
Static options reach the tool handler during execution. The prompt detail API retains these values in tools[].options. An exposed agent referenced in tools performs a handoff in the current thread.

Persistent subagents

Declare persistent child relationships in an owning agent side’s subagents array. Subagent relationship configuration in a prompt’s tools array is a definition-time error. The runtime injects lifecycle tools for enabled side-owned relationships. The receiving child’s side A prompt schema defines its invocation arguments. See Subagents for relationship configuration.

Context and validation

See definePrompt for the full reference.