Agent Config Reference
Look up Agent fields, defaults, value ranges, and capability toggles
The Agent create and update endpoints correspond to the base settings and orchestration cards in the editor. name is required and 1-100 characters; description is at most 500 characters.
Basics & Runtime
| Field | Type | Default | Description |
|---|---|---|---|
name | string | Required | Agent name, 1-100 characters |
description | string or null | null | At most 500 characters |
model_id | UUID | null | Chat model authorized for the current team |
system_prompt | string or null | null | Supports {{variable_name}} |
max_iterations | integer | 5 | Tool call rounds, 1-200 |
visibility | private or team | team (create endpoint) | Access scope |
status | draft or published | draft | Publish endpoint toggles status |
RAG & Tools
| Field | Type | Default | Description |
|---|---|---|---|
rag_mode | off, auto or agentic | agentic | Off, auto retrieval, or Agent-decided retrieval |
knowledge_base_configs | array | [] | Each entry contains knowledge base, retrieval mode, Top K, and threshold |
tools_config | array | [] | Built-in, custom, MCP, or Skill |
variables | array | [] | User input fields |
enable_user_input_request | boolean | false | Allow requesting structured input during conversations |
Memory, Compression & Attachments
| Field | Type | Default | Limit/Description |
|---|---|---|---|
enable_memory | boolean | false | Enable cross-conversation memory |
max_memories_per_retrieval | integer | 10 | 1-50 |
auto_extract | boolean | true | Automatically extract important information |
context_compression_config.enabled | boolean | true | Compress context before requests |
recent_raw_turns | integer | 3 | 1-12 |
warning_ratio / auto_compact_trigger_ratio / blocking_ratio | number | 0.7 / 0.8 / 0.92 | 0.1-1.0; target ratio must be lower than trigger ratio |
enable_attachments | boolean | false | Allow files and images |
max_file_size | bytes | 10MB | 1KB-50MB |
max_files | integer | 5 | 1-10 |
max_content_length | integer | 100000 | 1000-500000 characters |
Media Generation
Images default to 1024×1024 with at most 4 per request; videos default to 5 seconds with a maximum of 10 seconds and 16:9 aspect ratio, polling interval 3000ms, synchronous wait 120s. All media models must be authorized for the current team.
How is this guide?