psicólogo

Operations

Lista as hipóteses do Psicólogo sobre os agentes

Request

Cada hipótese cita os eventos que a sustentam (evidenceEventIds) — é isso que a torna auditável em vez de aceita por fé.

Security

bearer

Path

projectIdstringrequired

GET

/projects/{projectId}/hypotheses

Payload

// No request payload

Responses

Bodyapplication/json

Array [

idstringrequired

Example:"01JC4Z0000HIPOTESE000000001"

projectIdstringrequired

Example:"01JC4Z0000PROJETO0000000001"

sessionIdstringrequired

Example:"01JC4Z8QK3M7YV2N5T9B0PXHRA"

analysisIdstringrequired

A rodada de análise que gerou esta hipótese.

Example:"01JC4Z0000ANALISE0000000001"

agenteAlvostringrequired

Sobre qual agente é a hipótese.

Example:"dev-api"

observacaostringrequired

Example:"The agent reopened the same task three times."

hipotesestringrequired

Example:"The instructions don't say when to consider the task done."

sugestaostringrequired

Example:"Add an explicit definition-of-done criterion to the instruction."

confiancaPercentnumber, [ 0 .. 100 ]required

Confiança declarada pelo próprio modelo. Não é medição, é autorrelato.

Example:72

evidenceEventIdsArray of stringsrequired

Eventos do log que sustentam a hipótese. É isso que torna a evidência auditável em vez de aceita por fé.

Example:

[
  "01JC4Z8QK3M7YV2N5T9B0PXHRB"
]

terminationAnalysisobject or null(AnaliseDeTerminoResponseDto)required

Presente só em hipóteses sobre uma sessão encerrada de forma anormal.

statusstringrequired

Enum:"proposed""accepted""dismissed"

Example:"proposed"

decidedByobject or nullrequired

Example:null

decidedAtobject or null, (date-time)required

Example:null

createdAtstring, (date-time)required

Example:"2026-07-26T18:00:00.000Z"

updatedAtstring, (date-time)required

Example:"2026-07-26T18:00:00.000Z"

]

Response

[
  {
    "id": "01JC4Z0000HIPOTESE000000001",
    "projectId": "01JC4Z0000PROJETO0000000001",
    "sessionId": "01JC4Z8QK3M7YV2N5T9B0PXHRA",
    "analysisId": "01JC4Z0000ANALISE0000000001",
    "agenteAlvo": "dev-api",
    "observacao": "The agent reopened the same task three times.",
    "hipotese": "The instructions don't say when to consider the task done.",
    "sugestao": "Add an explicit definition-of-done criterion to the instruction.",
    "confiancaPercent": 72,
    "evidenceEventIds": [
      "01JC4Z8QK3M7YV2N5T9B0PXHRB"
    ],
    "terminationAnalysis": {
      "causa": "heartbeat_timeout",
      "estadoDaSessao": "closed_abnormally",
      "analise": "The agent stopped responding after a 90s tool call."
    },
    "status": "proposed",
    "decidedBy": null,
    "decidedAt": null,
    "createdAt": "2026-07-26T18:00:00.000Z",
    "updatedAt": "2026-07-26T18:00:00.000Z"
  }
]