Agent Config
The agent section configures the LLM model, system prompt, tools, and behavior.
Basic Configuration
Configuration Options
| Field | Required | Description |
|---|---|---|
model | Yes | Model identifier (provider/model-id) |
system | Yes | System prompt filename (without .md) |
input | No | Variables to interpolate in system prompt |
tools | No | List of tools the LLM can call |
skills | No | List of Octavus skills the LLM can use |
agentic | No | Allow multiple tool call cycles |
maxSteps | No | Maximum agentic steps (default: 10) |
temperature | No | Model temperature (0-2) |
thinking | No | Extended reasoning level |
anthropic | No | Anthropic-specific options (tools, skills) |
Models
Specify models in provider/model-id format:
System Prompt
The system prompt sets the agent's persona and instructions:
Example prompts/system.md:
Agentic Mode
Enable multi-step tool calling:
How it works:
- LLM receives user message
- LLM decides to call a tool
- Tool executes, result returned to LLM
- LLM decides if more tools needed
- Repeat until LLM responds or maxSteps reached
Extended Thinking
Enable extended reasoning for complex tasks:
| Level | Token Budget | Use Case |
|---|---|---|
low | ~5,000 | Simple reasoning |
medium | ~10,000 | Moderate complexity |
high | ~20,000 | Complex analysis |
Thinking content streams to the UI and can be displayed to users.
Skills
Enable Octavus skills for code execution and file generation:
Skills provide provider-agnostic code execution in isolated sandboxes. When enabled, the LLM can execute Python/Bash code, run skill scripts, and generate files.
See Skills for full documentation.
Temperature
Control response randomness:
Guidelines:
0 - 0.3: Factual, consistent responses0.4 - 0.7: Balanced (good default)0.8 - 1.2: Creative, varied responses> 1.2: Very creative (may be inconsistent)
Provider Options
Enable provider-specific features like Anthropic's built-in tools and skills:
Provider options are validated against the model—using anthropic: with a non-Anthropic model will fail validation.
See Provider Options for full documentation.
Thread-Specific Config
Override config for named threads: