FruxonDocs
ApiAgent reviews

Reviews one of the agent's conversations now.

Name the conversation by a run in it (`executionRecordId`) or by its topic (`topicId`, whose most recent conversation is reviewed). A conversation is the agent's runs in one session up to a four-hour quiet gap; a run with no session is reviewed alone. The reviewer reads the agent as it ran, what was said, and what the agent did with its tools, and each finding goes where it belongs: evidence for a card that already says it, a new card, a draft in the agent's knowledge base, or — for failures outside the agent — a record only. Cards from a review an admin asked for show at once. Needs reviewing on, with a model, and budget left today; the call is charged to that budget, never to the agent's. Synchronous: expect it to take as long as one call to the chosen model, and a little more when a finding needs tools found or a knowledge-base match confirmed. Agent admins only.

POST
/v1/tenants/{tenant}/agents/{agent}:review

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The agent ID.

tenant*string

The tenant identifier

Request Body

Which conversation to review.

executionRecordId?string|null

A run in the conversation — its conversation is reviewed; a run with no session is reviewed alone.

Formatuuid
topicId?string|null

A topic — its most recent conversation is reviewed.

Formatuuid
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/agents/string:review" \  -H "Content-Type: application/json" \  -d '{}'
{
  "unit": {
    "id": "00000000-0000-0000-0000-000000000000",
    "kind": "CONVERSATION",
    "status": "PENDING",
    "sessionId": "string",
    "topicId": "00000000-0000-0000-0000-000000000000",
    "runIds": [
      "00000000-0000-0000-0000-000000000000"
    ],
    "firstRunAt": 0,
    "lastRunAt": 0,
    "revision": 0,
    "summary": "string",
    "findingsCount": 0,
    "reviewedAt": 0,
    "requestedBy": "string"
  },
  "findings": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "unitId": "00000000-0000-0000-0000-000000000000",
      "category": "MISSING_CAPABILITY",
      "severity": "LOW",
      "title": "string",
      "need": "string",
      "whatHappened": "string",
      "turns": [
        0
      ],
      "disposition": "MERGED",
      "dispositionDetail": "string",
      "recommendationId": "00000000-0000-0000-0000-000000000000",
      "knowledgeBaseId": "00000000-0000-0000-0000-000000000000",
      "knowledgeDocumentId": "00000000-0000-0000-0000-000000000000",
      "question": "string",
      "createdAt": 0
    }
  ],
  "recommendations": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "kind": "ADD_TOOLS",
      "category": "MISSING_CAPABILITY",
      "severity": "LOW",
      "status": "CANDIDATE",
      "title": "string",
      "summary": "string",
      "need": "string",
      "patch": {
        "tools": [],
        "instructionText": "string",
        "replaceAnchor": "string",
        "adviceMarkdown": "string",
        "feature": "string"
      },
      "evidenceCount": 0,
      "firstSeenAt": 0,
      "lastSeenAt": 0,
      "baseRevision": 0,
      "appliedRevision": 0,
      "previousRevision": 0,
      "appliedBy": "string",
      "appliedAt": 0,
      "dismissedBy": "string",
      "dismissedAt": 0,
      "dismissReason": "NOT_RELEVANT",
      "dismissNote": "string",
      "obsoleteReason": "string",
      "version": 0
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}