Guides/Agent Configuration

Agent Configuration

Per-agent settings for autonomy, read-only mode, resources, capabilities, execution timeout, and runtime.

Autonomy Mode

Master toggle that enables or disables all scheduled operations for an agent.

•Toggle from the Dashboard, Agents page, or Agent Detail view

•When disabled, all schedules for that agent are paused

•API — GET /api/agents/{name}/autonomy and PUT /api/agents/{name}/autonomy

Read-Only Mode

Prevents modification of source files (*.py, *.js, etc.) inside the agent container.

•Toggle in the Agent Header

•Uses PreToolUse hooks to intercept Write, Edit, and NotebookEdit tool calls

•Allowed patterns: output/*, content/* (generated files are permitted)

•API — GET /api/agents/{name}/read-only and PUT /api/agents/{name}/read-only

Resource Allocation

Per-agent memory and CPU limits.

•Configure memory limit (MB) and CPU limit in the Config tab of Agent Detail

•Full capabilities mode — grants containers system-level access (Docker socket, network tools) when needed

Execution Timeout

Configurable time limit for agent executions.

•Range: 60–7200 seconds (default: 900 seconds / 15 minutes)

•Applies to all trigger methods: task, chat, schedule, MCP, and paid endpoints

•Slot TTL is set to the timeout value plus a 5-minute buffer

•API — GET /api/agents/{name}/timeout and PUT /api/agents/{name}/timeout

Per-Agent API Key

Controls which API key the agent uses for Claude.

•Toggle between the platform API key and the user's own Claude subscription

•The agent container is recreated when this setting changes

Model Selection

Choose the Claude model used for tasks and scheduled executions.

•Available models: Opus 4.5/4.6, Sonnet 4.5/4.6, Haiku 4.5

•Custom model input is supported

•Selection is persisted to localStorage; model_used is recorded in the execution audit trail

Runtime

Set via runtime.type in template.yaml.

•claude-code (default)

•gemini-cli

For Agents

Agents inherit their configuration at container creation time. Changes to resource allocation, API key, or runtime trigger a container recreate. Changes to autonomy, read-only mode, timeout, and model selection take effect on the next execution without restarting the container.

Agent Logs Credential Management