AgentConnect
Decisions

Get a chat API gate's evaluation

Reads one frozen gate verdict from the serving daemon: the Decision as it was asked, the call it judged, the answer, the chain trace, and the provider JSON while retained. Only callers who can edit the agent may read it.

GET
/v1/orgs/{orgId}/agents/{agentId}/api/{protocol}/evaluations/{seq}

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string
agentId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
protocol*string

Value in

  • "ai-sdk-ui"
  • "ag-ui"
seq*integer
Range0 < value <= 9007199254740991

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/orgs/string/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/api/ai-sdk-ui/evaluations/1"
{  "seq": 0,  "at": "string",  "messageId": "string",  "title": "string",  "decisionId": "string",  "outcome": "triggered",  "reason": "string",  "answer": {    "type": "boolean",    "value": true,    "probability": 0  },  "matchedKeys": [    "string"  ],  "latencyMs": 0,  "requestedModel": "string",  "actualModel": "string",  "usage": {    "inputTokens": 0,    "outputTokens": 0  },  "detailsExpired": true,  "snapshot": {    "decisionId": "string",    "providerId": "string",    "model": "string",    "question": {      "type": "choice",      "instructions": "string",      "criteria": {        "property1": "string",        "property2": "string"      }    },    "condition": {      "type": "choice",      "thresholds": {        "property1": 0,        "property2": 0      }    },    "sessionMode": "string"  },  "input": {    "agent": {      "name": "string",      "description": "string"    },    "currentMessage": {      "id": "string",      "sender": {        "id": "string"      },      "text": "string",      "quote": {        "sender": "string",        "text": "string"      },      "threadId": "string",      "time": "string",      "truncated": true    },    "history": [      {        "id": "string",        "sender": {          "id": "string"        },        "text": "string",        "quote": {          "sender": "string",          "text": "string"        },        "threadId": "string",        "time": "string",        "truncated": true      }    ],    "historyOmitted": 0,    "context": {      "partial": true,      "reasons": [        "string"      ],      "omittedMessages": 0    }  },  "fullAnswer": {    "type": "boolean",    "value": true,    "probability": 0  },  "chain": [    {      "stepId": "string",      "decisionId": "string",      "evaluation": {        "status": "answered",        "answer": {          "type": "boolean",          "value": true,          "probability": 0        },        "model": "string",        "usage": {          "inputTokens": 0,          "outputTokens": 0        }      }    }  ],  "steps": [    {      "stepId": "string",      "decisionId": "string",      "providerId": "string",      "model": "string",      "question": {        "type": "choice",        "instructions": "string",        "criteria": {          "property1": "string",          "property2": "string"        }      },      "condition": {        "type": "choice",        "thresholds": {          "property1": 0,          "property2": 0        }      },      "rawRequest": {        "text": "string",        "truncated": true      },      "rawResponse": {        "text": "string",        "truncated": true      }    }  ],  "rawRequest": {    "text": "string",    "truncated": true  },  "rawResponse": {    "text": "string",    "truncated": true  },  "evidence": {    "snapshotSeq": 0,    "suppliedBackground": 0  }}