litellm/scripts/trace_codegen/schemas/traces/Trace.json

347 lines
7.2 KiB
JSON

{
"$defs": {
"AgentNode": {
"description": "One distinct agent in a trace: 200 invocations of `researcher` are one node.",
"properties": {
"duration_ms": {
"format": "double",
"type": "number"
},
"invocations": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
},
"llm_calls": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
},
"name": {
"type": "string"
},
"parent_agent": {
"type": [
"string",
"null"
]
},
"spend": {
"format": "double",
"type": [
"number",
"null"
]
},
"tool_calls": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
}
},
"required": [
"name",
"parent_agent",
"invocations",
"llm_calls",
"tool_calls",
"duration_ms",
"spend"
],
"type": "object"
},
"Span": {
"properties": {
"agent": {
"type": "string"
},
"duration_ms": {
"format": "double",
"type": "number"
},
"error": {
"type": [
"string",
"null"
]
},
"error_truncated": {
"type": "boolean"
},
"framework": {
"type": "string"
},
"input_preview": {
"type": "string"
},
"input_tokens": {
"format": "uint32",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"litellm_request_id": {
"type": [
"string",
"null"
]
},
"model": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"output_tokens": {
"format": "uint32",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"parent_span_id": {
"type": [
"string",
"null"
]
},
"span_id": {
"type": "string"
},
"spend": {
"format": "double",
"type": [
"number",
"null"
]
},
"start_offset_ms": {
"format": "double",
"type": "number"
},
"status": {
"$ref": "#/$defs/SpanStatus"
},
"type": {
"$ref": "#/$defs/SpanType"
}
},
"required": [
"span_id",
"parent_span_id",
"name",
"type",
"agent",
"framework",
"start_offset_ms",
"duration_ms",
"status",
"error",
"error_truncated",
"input_preview",
"model",
"input_tokens",
"output_tokens",
"litellm_request_id",
"spend"
],
"type": "object"
},
"SpanStatus": {
"enum": [
"ok",
"error",
"unset"
],
"type": "string"
},
"SpanType": {
"enum": [
"agent",
"llm",
"tool",
"chain",
"framework",
"retriever",
"embedding",
"reranker",
"guardrail",
"evaluator",
"prompt",
"decision"
],
"type": "string"
},
"TraceSummary": {
"properties": {
"agent_count": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
},
"agent_invocations": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
},
"agent_names": {
"items": {
"type": "string"
},
"type": "array",
"x-python-optional": true
},
"duration_ms": {
"format": "double",
"type": "number"
},
"error_count": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
},
"frameworks": {
"items": {
"type": "string"
},
"type": "array",
"x-python-optional": true
},
"input_preview": {
"type": "string"
},
"input_tokens": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
},
"llm_calls": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
},
"models": {
"items": {
"type": "string"
},
"type": "array"
},
"name": {
"type": "string"
},
"output_tokens": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
},
"resolution_limited": {
"type": "boolean",
"x-python-optional": true
},
"service": {
"type": "string"
},
"span_count": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
},
"spend": {
"format": "double",
"type": [
"number",
"null"
]
},
"start_time": {
"type": "string"
},
"status": {
"$ref": "#/$defs/SpanStatus"
},
"tool_calls": {
"format": "uint64",
"maximum": 18446744073709551615,
"minimum": 0,
"type": "integer"
},
"trace_id": {
"type": "string"
},
"trace_ref": {
"type": "string",
"x-python-optional": true
}
},
"required": [
"resolution_limited",
"trace_id",
"trace_ref",
"name",
"service",
"agent_names",
"frameworks",
"input_preview",
"start_time",
"duration_ms",
"status",
"span_count",
"agent_count",
"agent_invocations",
"llm_calls",
"tool_calls",
"error_count",
"input_tokens",
"output_tokens",
"models",
"spend"
],
"type": "object"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"agents": {
"items": {
"$ref": "#/$defs/AgentNode"
},
"type": "array"
},
"next_cursor": {
"type": [
"string",
"null"
],
"x-python-optional": true
},
"spans": {
"items": {
"$ref": "#/$defs/Span"
},
"type": "array"
},
"summary": {
"$ref": "#/$defs/TraceSummary"
}
},
"required": [
"summary",
"agents",
"spans",
"next_cursor"
],
"title": "Trace",
"type": "object"
}