// guias · 08
Ferramentas builtin por superfície
Tools são a superfície de ação do agente. Cada tool tem categoria, tier e sensibilidade; o harness registra chamada, aprovação, resultado, efeito e eventos.
Matriz de sensibilidade
| nível | exemplos | tratamento |
|---|---|---|
| safe | read_file, list_dir, recall_memory, process_log | executa direto; não muda estado |
| sensitive | write_file, edit_file, remember_user, process_kill, spawn, browse click/fill | go/no-go conforme modo de aprovação |
| dangerous | run_shell, process_start | sempre passa por aprovação fora de yolo |
Superfícies
Arquivos & shellRead-before-edit, checkpoints e sandbox.BrowserFetch read-only ou Playwright.Voz & mídiaSTT, TTS, voice bridge e imagem.Memóriaremember, recall e USER.md.Skill/MCP/subagenteuse_skill, spawn e tools MCP dinâmicas.Controlerespond, task_complete, task_blocked, need_input.
Como a tool vira evidência
- O modelo emite uma ação estruturada.
- O harness valida schema e sensibilidade.
- A aprovação humana entra se necessário.
- A tool roda sob sandbox/policy.
- Resultado vai para
events.jsonl,audit.jsonle, se for grande,.okami/tool_outputs/. - ExitCriteria decide se a tarefa pode concluir.