Agents
Choose the right agent for your workload. Each agent runs inside an isolated sandbox and connects to your LLM via your API key.
Why Deictic? Recommended
- Any LLM provider: Use Anthropic, OpenAI, DeepSeek, Google, or any OpenAI-compatible endpoint (e.g., coding67.com, OpenRouter).
- Custom tools: Define your own tool schemas. The agent will call them during execution.
- Custom system prompt: Control agent behavior with your own instructions.
- Model-agnostic: Switch between claude-sonnet-4-5, gpt-4, deepseek-v4-pro, etc. without changing your integration.
For detailed deictic agent documentation, see the Deictic Agent Docs
Agent Comparison
| Agent | LLM Vendor | Custom Tools | Custom Prompt | Best For |
|---|---|---|---|---|
| deicticDefault | Any LLM provider | ✅ | ✅ | Most use cases. Ideal when you want model choice, custom tooling, or use a proxy/gateway like coding67.com. |
| claude-code | Anthropic only | — | — | Claude-native workflows where you want the official Anthropic experience. |
| codex | OpenAI only | — | — | OpenAI-native workflows where you want the official OpenAI experience. |
Agent Details
Deictic
deicticDefaultFirst-party agent built for flexibility. Works with any LLM API key and supports custom tools and system prompts.
Supported models: Anthropic, OpenAI, DeepSeek, Google, or any OpenAI-compatible API
Claude Code
claude-codeAnthropic's official Claude Code CLI. Uses Claude's built-in coding capabilities.
Supported models: Model must start with 'claude-'
Codex
codexOpenAI's Codex CLI. Uses OpenAI's built-in coding capabilities.
Supported models: Model must start with 'gpt-' or 'o'
Usage Example
Specify the agent when creating a session:
POST /v1/sessions
{
"agent": { "kind": "deictic" },
"template": "standard",
"llm": {
"vendor": "anthropic",
"model": "claude-sonnet-4-5"
},
"secrets": ["my-llm-keys"],
"user_id": "user_123",
"ttl_seconds": 3600
}The secrets array references your stored LLM API key bundle. See Secrets API for setup.