Agent Configuration

Create agent.toml

name = "research-assistant"
description = "Research with source-backed answers"
llm = "deepseek-v4-pro"
max_steps = 32

prompt = """
Be concise and cite the evidence you use.
"""

capabilities = [
  "web_search_&_browse",
  "sandbox",
  "skills",
  "composio:github",
  "custom:550e8400-e29b-41d4-a716-446655440000"
]

[[skills]]
repo = "rebyteai/skills"
path = "research/deep-research"

Fields

Unknown fields are rejected.

Field	Required	Initial value	Constraint
name	Yes	—	Trimmed string, 1–100 characters.
description	No	Not set	Trimmed string, up to 500 characters.
llm	No	deepseek-v4-pro	A supported Agent model ID.
max_steps	No	32	Integer from 1 through 128.
prompt	No	Empty	Inline instructions, up to 100,000 characters.
prompt_file	No	—	UTF-8 instructions loaded relative to agent.toml.
capabilities	No	Seven default internal tools	Up to 64 unique capability strings.
skills	No	Empty	Up to 128 unique repo and path pairs.

prompt and prompt_file are mutually exclusive. A loaded prompt_file may not exceed 100,000 characters.

Use a model ID listed in Agents.

Capabilities

Capability strings map to Agent API tool references:

web_search_&_browse → {"kind":"internal","name":"web_search_&_browse"}
composio:github     → {"kind":"composio","toolkit":"github"}
custom:<uuid>       → {"kind":"custom","serverId":"<uuid>"}

See Skills & Tools for the supported capability types.

Skills

[[skills]]
repo = "owner/repository"
path = "skills/research"

repo omits .git. path is a repository-relative directory and does not end in SKILL.md.