Gli agenti producono lavoro
più velocemente di chiunque
possa revisionarlo.

La revisione umana era il ciclo. Alla scala degli agenti, è il collo di bottiglia.

FEEDBACK LOCALIZZATO

Un difetto che non sa localizzare è un difetto che non può correggere.
SeaOtter fissa l’esatto intervallo e indica il file.

Il critico non dice solo che qualcosa è sbagliato. Localizza il problema così che l’agente possa rivedere la riga, la pagina, la slide, la cella, il frame o il timestamp esatto che ha fallito.

INVIA → VALUTA

Invii il lavoro, lo ottenga valutato — sincrono o asincrono.

Un agente esegue una POST con il lavoro appena prodotto e SeaOtter lo valuta rispetto alla Sua policy di accettazione. I controlli piccoli e veloci restituiscono il verdetto inline. Quelli più pesanti restituiscono un job id che l’agente può sondare, streammare o ricevere via webhook — così una revisione lunga non blocca mai l’agente che l’ha richiesta.

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, o stream, o attenda il webhook

Stessa policy, stesso OtterScore, stesso record di audit firmato — qualunque trasporto scelga l’agente.

PER AGENTI · MCP QUICKSTART

Colleghi il Suo agente al critico ostile in 60 secondi.

Tre passaggi: generi una chiave, aggiunga un server MCP, poi il Suo agente chiama otter_score / otter_iterate nel proprio ciclo — stesso OtterScore, stessa policy di accettazione, a velocità macchina. Il critico valuta; il Suo agente rivede in base ai difetti finché la fascia non supera il gate. È il ciclo che ha appena visto nella flotta sopra: ogni artefatto segnalato (route_to_fix, l’arco ambra) rientra nel gate via otter_iterate e viene rilasciato solo quando ready_to_ship è true. Nessun umano nel ciclo interno — la firma nominativa è l’ultimo gate, non l’unico.

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":"..." }
# Consegnare `key` all’agente come 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

# invia il tuo lavoro -> verdetto autorevole
v = otter_score(
      work="...the artifact your agent produced...",
      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 }

# rivedi in base a flaws[]/upgrades[], quindi reinvia LO STESSO run
d = otter_iterate(
      run_id=v["run_id"],
      work="...revised draft addressing the flaws...",
      prompt="addressed sourcing + tone")
# -> { run_id, verdict:{band:"ship",...},
#      delta:{resolved_flaws,new_flaws,persisted_flaws,
#             score_change:+18.0}, ready_to_ship:true }

# continua a iterare finché ready_to_ship è false.

Equivalente Pure-HTTP (nessun MCP): POST /api/v1/eval/runs → { run_id, first_iteration.critic_verdict }, poi POST /api/v1/eval/runs/{run_id}/iterate { "decision":"re_prompt", "new_artifact_parts":[…] } → { verdict, delta }. Un guasto del critico fallisce in CHIUSO (band:quarantine) — mai un passaggio silenzioso.

DUE MODALITÀ DI CONTROLLO

One-shot o agentico. Lei sceglie la profondità.

Non ogni output richiede lo stesso livello di scrutinio. Un controllo one-shot è un singolo passaggio di critico ostile — veloce, poco compute, restituito inline. Un controllo agentico esegue il lavoro in una sandbox usa-e-getta con sondaggi multipli — più lento, più compute, restituito in asincrono. Instradi il lavoro economico su one-shot e quello ad alta criticità su agentic, con la stessa policy.

Entrambe le modalità restituiscono lo stesso verdetto OtterScore e scrivono lo stesso record di audit firmato.

PREZZI BASATI SULL'USO

Paghi per il lavoro svolto.

Si paga per la valutazione effettivamente eseguita, non per numero di utenze. Un controllo one-shot è economico e a tariffa fissa; un controllo agentico è a consumo in base al compute e al tempo in sandbox. È ciò che rende economico valutare ogni output — e l’intera flotta — invece di razionare la revisione a un campione.

La distribuzione enterprise resta shadow → enforce → managed; la valutazione a consumo misura il lavoro sottostante. Un preventivo concreto in £ è disponibile su richiesta.