// guias · 05
API HTTP headless
okami serve expõe o agente por HTTP sem framework extra, usando http.server da stdlib. É propositalmente pequeno: healthcheck e um endpoint de chat. A API é fail-cl…
Subir a API
okami config set OKAMI_API_TOKEN <token-forte>
okami serve --host 127.0.0.1 --port 8765Endpoints
| endpoint | contrato |
|---|---|
| GET /health | retorna { ok: true } |
| POST /chat | body { "agent": "okami", "message": "..." }; exige Authorization: Bearer <token> |
Exemplo curl
curl -s http://127.0.0.1:8765/chat \
-H 'Authorization: Bearer <token-forte>' \
-H 'content-type: application/json' \
-d '{"agent":"okami","message":"crie um resumo do repo"}'Resposta
{
"reply": "texto final ou razão de bloqueio",
"state": "complete|blocked|needs_input|failed",
"usage": { "input_tokens": 1234, "output_tokens": 321 }
}Roteamento de agente
O campo agent seleciona agents/<id> se existir; se não existir, a API usa a config global e workspaces/default. Isso permite colocar vários agentes atrás do mesmo endpoint sem duplicar processo.