Referência de configuração

Chaves de topo

params default_provider string · obrigatório Provider usado quando nenhum é passado. providers map · obrigatório Cada entrada é um provider (ver abaixo). memory map Backend de memória, embedder e limites de arquivo. contracts map Contratos verificáveis (ex.: contracts.ui). approvals map mode + always_allow (go/no-go). sandbox map Política de execução do run_shell/processos. voice map STT (Whisper) e TTS (Edge) para canais com áudio. learning map auto_skill e auto_tune. persona map observe (persona evolutiva). agents map default + bindings (roteamento multi-agente). groups list Salas multi-agente (membros + moderador). gateway map auto_resume, max_sessions. mcp map mcp.servers — servidores MCP externos. hooks map evento → lista de comandos (event hooks). tools map tools.surfaces — allow/deny de tools por canal.

providers.<id>

Cada provider é descrito de forma agnóstica e resolvido via LiteLLM em runtime. model é a string no formato LiteLLM (ex.: openai/<modelo>, openai-codex/<modelo>, claude-subscription/<modelo>).

params model string Modelo no formato LiteLLM (obrigatório). api_base string Endpoint OpenAI-compat (local/proxy). api_key_env string Nome da env var com a chave (aceita várias por vírgula). api_key string Chave literal — use só para dummy local (ex.: lm-studio). api_keys list Pool de chaves p/ rotação/failover em rate-limit. auth api_key | oauth_subscription Tipo de autenticação. api_key transport litellm | claude_cli | codex_oauth | minimax_oauth Transporte de acesso. litellm tier strong | weak | local | unknown Capacidade — parametriza o andaime adaptativo. fallback list Providers de backup em cadeia se este falhar (529/timeout/vazio). context_window int Janela do modelo em tokens (0 = default por tier). 0 reasoning_effort minimal|low|medium|high Esforço de raciocínio (modelos reasoning). Trocável por /think. capability.tool_mode json_text|json_constrained|native Como o modelo emite ações. json_text capability.vision bool Modelo aceita imagem (multimodal). false native_tools bool Tool-calling nativo (experimental, opt-in). false models list Ids alternativos disponíveis no plano. notes string Nota livre (aparece no doctor).

memory

params backend sqlite-fts5 | holographic | honcho | [lista] Backend ativo; uma lista vira memória em camadas. sqlite-fts5 embedder.enabled bool Liga embeddings (degrada p/ BM25 se offline). true embedder.api_base / .model string Servidor e modelo de embedding (OpenAI-compat). holographic.dim int Dimensão dos vetores HRR/VSA. 1024 honcho.base_url / .api_key string Endpoint/credencial do Honcho (api_key via ${ENV}). files.{soul,voice,persona} int Limite de chars dos arquivos de identidade. 6000 files.{agents,user,memory} int Limite de chars dos arquivos de core. 4000

contracts.ui

params library string Lib de UI declarada (ex.: shadcn, heroui). component_source string Import esperado (ex.: @/components/ui). forbid_inline_hex bool Reprova cor hex inline. true forbid_raw_css bool Reprova <style> cru e style={{...}} inline. true require_component_source bool Exige import da lib declarada. true (se há source)

approvals · sandbox

params approvals.mode manual|smart|off|yolo Modo de aprovação (off é fail-closed). manual approvals.always_allow list Categorias auto-aprovadas (persistido). sandbox.profile dev|hardened|hardened-strict Atalho de postura. dev sandbox.backend local|docker|auto Backend de execução. local sandbox.mode read-only|workspace-write|yolo Política de mutação. workspace-write sandbox.network bool Rede liberada (real só no docker; yolo liga). false sandbox.timeout int (s) Teto de relógio por comando. 60 sandbox.egress_allow list Allowlist de hosts de saída (proxy filtrante). sandbox.require_isolation bool Exposto sem Docker → shell DESABILITADO (não degrada). false

voice · learning · persona

params voice.stt.backend / .model string Whisper local (tiny…large). voice.tts.enabled / .backend / .voice — TTS: edge (grátis) | minimax; voz (ex.: pt-BR-AntonioNeural). learning.auto_skill bool Destila skill de tarefa não-trivial (passa pelo scan). false learning.auto_tune bool Calibra o capability profile pelos stats de uso. false persona.observe bool Liga a persona evolutiva (VOICE/PERSONA). true

Abrir esta página nos docs interativos