Built-in Capabilities
Built-in Tools
| Tool | Purpose |
|---|---|
STOP_TOOL (agent_stop) | Ends the tool loop; the agent answers directly |
REASONING_TOOL (reasoning) | Explicit reasoning step (non-native-thinking mode) |
UPDATE_STEP_TOOL (update_step) | Revise the task plan: replan / mark_done / add_step / remove_step |
PROCESS_MESSAGE | Reports agent progress to the user (enabled by function_config.agent_middle_message) |
Built-in tools bypass the agent.tool_call / agent.tool_return lifecycle events and are excluded from stall-signature cancellation.
Built-in Metadata Types
Stream metadata (MessageWithMetadata.metadata) uses type + extra_type:
type | extra_type | Meaning |
|---|---|---|
function_call | — | Tool start/finish (is_done) |
reasoning_chunk | cot_chunk | Thinking-mode reasoning streaming |
reasoning / structured_reasoning | — | Reasoning summaries |
reflection | — | Post-stop reflection results |
error | loop_reasoning | Loop-detection error notice |
step | decompose / intro / leave / stall / compress | Step-loop lifecycle (see Step Loop) |
Built-in Adapters
See Model Adapters — the OpenAI-compatible adapter (serves OpenAI, DeepSeek, Azure and any OpenAI-compatible endpoint via base_url/model) and the Anthropic adapter (protocol="anthropic").
Built-in Strategies
| Strategy | Category | Notes |
|---|---|---|
ReActAgentStrategy | agent-mixed | Default strategy class; node-driven Step loop once the step-loop workflow is active (see Agent Strategy) |
HybridReActAgentStrategy | agent-mixed | MoE XML-style results; deprecated, removed in v0.14.0 |
NoActionAgentStrategy | workflow | Skip tool calling |
Built-in Event Hooks
Cookie Security Hook
When config.cookie.enable_cookie = True, responses are scanned for configured cookie values; on a match the session terminates with a generic error to prevent data leakage (see Security).
Post-Process Hook
strategy.on_post_process() runs after successful execution for all strategy categories — final instructions, summarization, or cleanup.
Built-in Workflows
Pre-composed pipelines in amrita_core.builtins.workflows (see Workflow Engine):
| Workflow | Pipeline |
|---|---|
SIMPLE_CHAT | Plain chat, no agent (default) |
REACT_BLOCK / SIMPLE_REACT / REACT_ONLY | Legacy ReAct loop |
STEP_REACT_BLOCK / SIMPLE_STEP_REACT / STEP_REACT_ONLY | Step-driven ReAct (opt-in) |
CHATOBJECT_STEP_REACT | Internal archived step-loop (used by the ChatObject runner) |
workflow=None(theChatObjectdefault) resolves to the simple chat pipeline. The step-driven family runs only when you pass it explicitly — e.g.get_chatobject(..., workflow=SIMPLE_STEP_REACT)orworkflow=_step_workflow_rendered(see The Step Loop).CHATOBJECT_STEP_REACTis normally selected for you — pass it only when you compose custom pipelines and need the archived block variant.