AgentConnect
Decisions

Get a routing evaluation

One routing evaluation with its frozen Decision and routing snapshot, target constraint (agents, participation, and mention or implicit only), input and history, answer, model, usage, the raw provider request and response JSON (from daemons that support it, each capped at 16K characters), and every target's admission status while the host still retains the bodies (bounded to 64 KiB); once stripped, detailsExpired is true and only the summary and snapshot remain. Proxied from the evaluation host, never stored or logged, and returned only after the conversation audience check; before any session there names an audience the bodies need edit access to the conversation's owner agent. Returns 404 when the evaluation is gone or unreadable and 503 when the host is offline or must be upgraded, including a reply that names no namespace.

GET
/v1/orgs/{orgId}/bots/{id}/decision-routing/evaluations/{seq}

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

orgId*string
id*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
seq*integer
Range0 <= value <= 9007199254740991

Query Parameters

channelId*string
Length1 <= length <= 512

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/orgs/string/bots/497f6eca-6276-4993-bfeb-53cbbbba6f08/decision-routing/evaluations/0?channelId=string"
{  "seq": 0,  "at": "string",  "channel": "string",  "messageId": "string",  "title": "string",  "decisionId": "string",  "outcome": "routed",  "reason": "string",  "evaluated": true,  "answer": {    "type": "boolean",    "value": true,    "probability": 0  },  "matchedKeys": [    "string"  ],  "matchedRuleIds": [    "string"  ],  "usedOtherwise": true,  "fallback": "constrained",  "targets": [    {      "agentId": "string",      "effect": "participant",      "via": "mention",      "participant": true,      "disposition": "pending",      "reason": "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"      }    },    "routing": {      "decisionId": "string",      "rules": [        {          "id": "string",          "when": {            "type": "choice",            "thresholds": {              "property1": 0,              "property2": 0            }          },          "action": {            "type": "agent",            "agentId": "string"          }        }      ],      "enabled": true,      "otherwise": {        "type": "default_agent"      },      "steps": [        {          "decisionId": "string",          "rules": [            {              "id": "string",              "when": {                "type": "choice",                "thresholds": {                  "property1": 0,                  "property2": 0                }              },              "action": {                "type": "agent",                "agentId": "string"              }            }          ],          "id": "string"        }      ]    },    "defaultAgentId": "string"  },  "constraint": [    {      "agentId": "string",      "participant": true,      "via": "mention"    }  ],  "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  }}