List Agent Trace Summary Versions

GET

https://api.getzep.com/api/v4/agents/:agent_uuid/traces/:trace_uuid/summary/versions

GET

/api/v4/agents/:agent_uuid/traces/:trace_uuid/summary/versions

from zep_cloud import Zep
client = Zep(
    api_key="YOUR_API_KEY_HERE",
)
client.agent.trace.list_summary_versions(
    agent_uuid="agent_uuid",
    trace_uuid="trace_uuid",
)

{
  "items": [
    {
      "agent_uuid": "string",
      "assertion_uuid": "string",
      "created_at": "string",
      "creation_reason": "close",
      "first_occurred_at": "string",
      "first_sequence": 1,
      "last_occurred_at": "string",
      "last_sequence": 1,
      "omitted_sequence_ranges": [
        {
          "first_sequence": 1,
          "last_sequence": 1,
          "reason": "narrower_authorization_boundary"
        }
      ],
      "outcome": "succeeded",
      "parent_version_uuid": "string",
      "structured_summary": {
        "ambiguities": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "text": "string"
          }
        ],
        "approach": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "text": "string"
          }
        ],
        "artifacts": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "name": "string",
            "version": "string"
          }
        ],
        "candidate_lessons": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "text": "string"
          }
        ],
        "corrections": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "text": "string"
          }
        ],
        "coverage": {
          "excerpted_events": [
            {
              "content_bytes": 1,
              "event_id": "string",
              "omitted_byte_ranges": [
                {
                  "end": 1,
                  "start": 1
                }
              ],
              "sequence": 1
            }
          ],
          "first_sequence": 1,
          "last_sequence": 1,
          "omitted_sequence_ranges": [
            {
              "first_sequence": 1,
              "last_sequence": 1,
              "reason": "narrower_authorization_boundary"
            }
          ]
        },
        "effective_steps": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "text": "string"
          }
        ],
        "environments": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "name": "string",
            "version": "string"
          }
        ],
        "errors": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "text": "string"
          }
        ],
        "event_time_basis": "string",
        "first_event_time": "string",
        "ineffective_steps": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "text": "string"
          }
        ],
        "last_event_time": "string",
        "objective": "string",
        "recoveries": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "text": "string"
          }
        ],
        "reported_outcome": "succeeded",
        "result": {
          "citations": [
            {
              "event_id": "string",
              "sequence": 1
            }
          ],
          "text": "string"
        },
        "task_family": "string",
        "tools": [
          {
            "citations": [
              {
                "event_id": "string",
                "sequence": 1
              }
            ],
            "name": "string",
            "version": "string"
          }
        ],
        "verification": {
          "citations": [
            {
              "event_id": "string",
              "sequence": 1
            }
          ],
          "details": [
            {
              "citations": [
                {
                  "event_id": "string",
                  "sequence": 1
                }
              ],
              "text": "string"
            }
          ],
          "status": "unverified",
          "verifier_ids": [
            "string"
          ]
        }
      },
      "text": "string",
      "trace_uuid": "string",
      "uuid": "string",
      "verification": "none",
      "version": 1
    }
  ],
  "next_cursor": "string",
  "total_size": 1
}

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

Query parameters

page_sizeintegerOptional1-100Defaults to 50

The maximum number of items in one page. The SDK method returns a pager. In Python, .items holds only the first page. In TypeScript, .data holds only the first page. To read every page, iterate the pager: use for or list(...) in Python, or for await in TypeScript. In Go, the method returns one page, and Iterator() reads all pages.

cursorstringOptional

Opaque page cursor

Response

itemslist of objectsOptional

next_cursorstringOptional

total_sizeintegerOptional

Errors

503

Service Unavailable Error