// conceitos · 06
Multi-agente e grupos
Multi-agente existe no alpha, mas ainda é uma área experimental. Cada agente é uma pasta (agents/<id>/) com config, identidade e memória próprias. Credenciais são g…
Estrutura de um agente
agents/cto/
agent.yaml # role, default_provider, channels.telegram.token
SOUL.md · VOICE.md · PERSONA.md # identidade (evolui sozinha)
.okami/
memory.db · taste.json · persona_signals.json
sessions/<chat>.jsonl # transcript append-only
checkpoints/journal.jsonlCriar e rotear
okami agent new ui # cria agents/ui/ (workspace próprio)
okami agent list # lista os agentes
okami route telegram:123 # mostra o roteamento origem → profileO roteamento usa bindings com tiers de regex: tier 0 exato → tier 1 regex → tier 2 wildcard; o primeiro match vence, com fallback pro agente default. O mapping origem→sessão é persistido.
Conversa em grupo experimental (turn-taking)
Vários agentes num mesmo chat conversando como uma reunião. Um moderador barato (enum constrained → confiável até num modelo fraco) escolhe quem fala a seguir — ou ninguém. Mecanismos contra o spam:
- Eligibility gating: filtra por cooldown, participação recente e @menção (que força).
- Silêncio intencional: o eleito pode responder
PASS(nada a acrescentar). - Cap bot-to-bot: máximo de falas de agente seguidas sem humano.
- 1 modelo por agente: cada um fala no seu provider, com janelas isoladas.
cd examples/company # cto / ui / backend de exemplo
okami room "CTO, e o frontend?" # brainstorm multi-agente