Correct Agent Trace Task Family

POST

https://api.getzep.com/api/v4/agents/:agent_uuid/traces/:trace_uuid/correct-task-family

POST

/api/v4/agents/:agent_uuid/traces/:trace_uuid/correct-task-family

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.trace.correct_task_family(
    agent_uuid="agent_uuid",
    trace_uuid="trace_uuid",
    expected_revision=1,
    reason="string",
    task_family="string",
)

{
  "task": {
    "completed_at": "string",
    "created_at": "string",
    "error": {
      "code": "string",
      "details": {},
      "message": "string",
      "param": "string",
      "request_id": "string"
    },
    "progress": {
      "stage": "string"
    },
    "result": {},
    "started_at": "string",
    "status": "string",
    "type": "string",
    "updated_at": "string",
    "uuid": "string"
  },
  "trace": {
    "abandoned_at": "string",
    "agent_uuid": "string",
    "attempt_family_uuid": "string",
    "closed_at": "string",
    "created_at": "string",
    "internal": {
      "assertion_uuid": "string",
      "closing_sequence": 1,
      "current_summary_version": 1,
      "last_task_uuid": "string",
      "next_sequence": 1,
      "processing_state": "idle"
    },
    "learn_from": true,
    "learn_from_reason": "string",
    "metadata": {},
    "objective": "string",
    "outcome": "succeeded",
    "parent_trace_uuid": "string",
    "revision": 1,
    "source": {
      "connection_uuid": "string",
      "import_uuid": "string",
      "imported_at": "string",
      "kind": "trace_import",
      "provider": "string",
      "provider_project_id": "string",
      "run_uuid": "string",
      "scores": {},
      "source_changed": false,
      "source_revision": "string",
      "source_url": "string",
      "trace_ended_at": "string",
      "trace_id": "string",
      "trace_started_at": "string"
    },
    "status": "open",
    "task_family": "string",
    "task_family_inference": {
      "assigned_at": "string",
      "classifier_version": "string",
      "confidence": 1.1,
      "descriptor_version": 1,
      "learning_reusable": true,
      "state": "string"
    },
    "task_family_source": "string",
    "trace_id": "string",
    "updated_at": "string",
    "uuid": "string",
    "verification": "none"
  }
}

Authentication

AuthorizationApi-Key

Type “Api-Key” followed by a space and the project API key.

Path parameters

agent_uuidstringRequired

Agent UUID

trace_uuidstringRequired

Trace UUID

Request

Request body

expected_revisionintegerRequired>=1

The current Trace revision used for optimistic concurrency.

reasonstringRequired

Why the terminal Trace classification is being corrected.

task_familystring or nullRequired

Replacement task-family slug. Set to null to clear it.

Response

Accepted

taskobjectOptional

traceobjectOptional

Errors

400

Bad Request Error

409

Conflict Error