Agentes produzem trabalho
mais rápido do que qualquer um
consegue revisar.

A revisão humana era o ciclo. Em escala de agentes, é o gargalo.

FEEDBACK LOCALIZADO

Uma falha que você não consegue localizar é uma falha que você não consegue corrigir.
SeaOtter fixa o trecho exato e nomeia o arquivo.

O crítico não apenas diz que algo está errado. Ele localiza o problema para que o agente revise a linha, página, slide, célula, quadro ou timestamp exato que falhou.

ENVIAR → AVALIAR

Envie trabalho, receba a avaliação — síncrono ou assíncrono.

Um agente faz POST do trabalho recém-produzido e a SeaOtter avalia contra sua política de aceitação. Verificações pequenas e rápidas retornam o veredicto inline. Verificações mais pesadas retornam um job id que o agente consulta, transmite ou recebe por webhook — assim uma revisão longa nunca bloqueia o agente que a solicitou.

curl -s https://dev-api.seaotter.ai/api/v1/eval/score \
  -H "Authorization: Bearer $OTTER_KEY" -H 'Content-Type: application/json' \
  -d '{ "mode":"one_shot", "modality":"text",
        "policy_id":"acme-prod-acceptance",
        "artifact_parts":[{"mime_type":"text/plain","text":"..."}] }'
# 200 { "band":"route_to_fix", "flaws":[...], "upgrades":[...] }

POST /api/v1/eval/jobs
  { "mode":"agentic", "modality":"code",
    "policy_id":"acme-prod-acceptance",
    "artifact_ref":"gs://...", "max_passes":6,
    "webhook":"https://acme.internal/otter-callback" }
# 202 { "job_id":"job_8f21", "status":"running" }
GET /api/v1/eval/jobs/job_8f21   # poll, ou stream, ou aguarde o webhook

Mesma política, mesmo OtterScore, mesmo registro de auditoria assinado — qualquer que seja o transporte escolhido pelo agente.

PARA AGENTES · INÍCIO RÁPIDO MCP

Conecte seu agente ao crítico hostil em 60 segundos.

Três passos: gere uma chave, adicione um servidor MCP, então seu agente chama otter_score / otter_iterate no próprio loop — mesmo OtterScore, mesma política de aceitação, em velocidade de máquina. O crítico avalia; seu agente revisa frente às falhas até a faixa liberar. Este é o loop que você acabou de ver na frota acima: todo artefato sinalizado (route_to_fix, o arco âmbar) reentra no gate via otter_iterate e só libera quando ready_to_ship for true. Sem humano no ciclo interno — a assinatura nomeada é o último gate, não o único.

curl -s -X POST https://dev-api.seaotter.ai/api/v1/agent-keys \
  -H "Authorization: Bearer $SEAOTTER_USER_JWT" \
  -H 'Content-Type: application/json' \
  -d '{"name":"my-agent"}'
# -> { "id":"...", "key":"sk-otter-...",
#      "key_prefix":"sk-otter-abcde", "created_at":"..." }
# Entregue `key` ao agente como OTTERLOOP_API_KEY.

{
  "mcpServers": {
    "otterloop": {
      "command": "python",
      "args": ["-m", "otterloop.mcp_server"],
      "env": {
        "OTTERLOOP_API_URL": "https://dev-api.seaotter.ai",
        "OTTERLOOP_API_KEY": "sk-otter-...",
        "OTTERLOOP_POLICY_ID": "enterprise-default"
      }
    }
  }
}
# tools: otter_list_policies · otter_score · otter_iterate
#        otter_score_workflow · otter_get_feedback_artifact

# envie seu trabalho -> veredicto autoritativo
v = otter_score(
      work="...o artefato que seu agente produziu...",
      modality="text",
      prompt="Draft the Q3 incident postmortem",
      policy_id="enterprise-default")
# -> { run_id, score, band:"route_to_fix",
#      flaws:[{criterion,severity,detail,anchor}],
#      upgrades:[...], ready_to_ship:false }

# revise frente a flaws[]/upgrades[], então reenvie o MESMO run
d = otter_iterate(
      run_id=v["run_id"],
      work="...rascunho revisado tratando as falhas...",
      prompt="addressed sourcing + tone")
# -> { run_id, verdict:{band:"ship",...},
#      delta:{resolved_flaws,new_flaws,persisted_flaws,
#             score_change:+18.0}, ready_to_ship:true }

# continue iterando enquanto ready_to_ship for false.

Equivalente puro HTTP (sem MCP): POST /api/v1/eval/runs → { run_id, first_iteration.critic_verdict }, então POST /api/v1/eval/runs/{run_id}/iterate { "decision":"re_prompt", "new_artifact_parts":[…] } → { verdict, delta }. Uma indisponibilidade do crítico falha FECHADO (band:quarantine) — nunca passa silenciosamente.

DOIS MODOS DE VERIFICAÇÃO

One-shot ou agêntico. Você define a profundidade.

Nem toda saída precisa do mesmo escrutínio. Uma verificação one-shot é uma passada única do crítico hostil — rápida, baixo cômputo, retornada inline. Uma verificação agêntica executa o trabalho em um sandbox descartável, com acesso à internet, e o investiga por múltiplas passagens — mais lenta, mais cômputo, retornada de forma assíncrona. Direcione trabalho barato para one-shot e trabalho de alto impacto para agêntico, sob a mesma política.

Ambos os modos retornam o mesmo formato de veredicto do OtterScore e gravam o mesmo registro de auditoria assinado.

PREÇOS BASEADOS EM USO

Pague pelo trabalho realizado.

Você paga pela avaliação que realmente executar, não por número de assentos. Uma verificação one-shot é barata e de preço fixo; uma verificação agêntica é cobrada pelo cômputo e tempo de sandbox necessários. É isso que torna econômico avaliar toda a saída — e toda a frota — em vez de racionar a revisão para uma amostra.

A implantação Enterprise começa em sombra → aplica → gerenciada; a avaliação baseada em uso mede o trabalho subjacente. Uma composição de £ concreta está disponível mediante solicitação.