Prompt definitions
Prompts define system instructions, a model, available tools, and context controls. Standard Agents Builder discovers them inagents/prompts/.
Callable tools
A prompt’stools array accepts:
- A callable name as a string.
- A
SubpromptConfigwith result filters and input mappings. - A
PromptToolConfigwith scoped environment values and static options.
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’ssubagents 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.