Get a trace
curl --request GET \
--url https://app.egma.ai/v1/traces/{traceId} \
--header 'Authorization: Bearer <token>'{
"trace": {
"traceId": "<string>",
"startedAt": "2023-11-07T05:31:56Z",
"endedAt": "2023-11-07T05:31:56Z",
"durationNs": "<string>",
"spanCount": 123,
"turnCounts": {
"human": 123,
"agent": 123
},
"toolSpanCount": 123,
"erroredSpanCount": 123,
"source": "simulation",
"pov": "persona",
"environment": "<string>",
"connectionType": "<string>",
"providerCallId": "<string>",
"agentPlatform": "<string>",
"platformAgentId": "<string>",
"platformAgentName": "<string>",
"platformAgentVersion": "<string>",
"runId": "<string>",
"agentId": "<string>"
},
"turns": [
{
"spanId": "<string>",
"parentSpanId": "<string>",
"name": "<string>",
"kind": "<string>",
"status": "<string>",
"startedAt": "2023-11-07T05:31:56Z",
"durationNs": "<string>",
"text": "<string>",
"audioUrl": "<string>",
"toolName": "<string>",
"toolArguments": "<string>",
"toolResult": "<string>",
"pov": "persona",
"spans": "<array>",
"toolProvenance": "mocked"
}
],
"spans": [
{
"spanId": "<string>",
"parentSpanId": "<string>",
"name": "<string>",
"kind": "<string>",
"status": "<string>",
"startedAt": "2023-11-07T05:31:56Z",
"durationNs": "<string>",
"text": "<string>",
"audioUrl": "<string>",
"toolName": "<string>",
"toolArguments": "<string>",
"toolResult": "<string>",
"pov": "persona",
"spans": "<array>",
"toolProvenance": "mocked"
}
],
"spansTruncated": true,
"metrics": [
{
"measure": "<string>",
"unit": "<string>",
"derived": true,
"pov": "persona",
"samples": [
123
],
"spanIds": [
"<string>"
],
"mean": 123,
"p50": 123,
"p90": 123,
"partial": true,
"reportedBy": "<string>",
"otherPov": {
"pov": "persona",
"derived": true,
"samples": [
123
],
"spanIds": [
"<string>"
],
"partial": true,
"reportedBy": "<string>"
}
}
],
"simulationId": "<string>",
"gradingState": "not_requested",
"workBlock": {
"error": "allowance_spent",
"message": "<string>"
},
"grades": [
{
"projectGraderId": "<string>",
"graderDefinitionId": "<string>",
"graderDefinitionVersion": 2,
"parameterValues": {},
"graderName": "<string>",
"score": 0.5,
"details": {
"rationale": "<string>",
"assertions": [
{
"key": "<string>",
"decision": "met",
"score": 0.5,
"rationale": "<string>",
"citedSpanIds": [
"<string>"
],
"citedTurns": [
2
],
"error": "<string>"
}
],
"error": "<string>"
},
"passThreshold": 0.5,
"result": "passed",
"gradedAt": "2023-11-07T05:31:56Z"
}
],
"gradeHistory": [
{
"projectGraderId": "<string>",
"graderDefinitionId": "<string>",
"graderDefinitionVersion": 2,
"parameterValues": {},
"graderName": "<string>",
"score": 0.5,
"details": {
"rationale": "<string>",
"assertions": [
{
"key": "<string>",
"decision": "met",
"score": 0.5,
"rationale": "<string>",
"citedSpanIds": [
"<string>"
],
"citedTurns": [
2
],
"error": "<string>"
}
],
"error": "<string>"
},
"passThreshold": 0.5,
"result": "passed",
"gradedAt": "2023-11-07T05:31:56Z"
}
],
"combinedScore": 0.5
}{
"error": "<string>",
"message": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}Traces
Get a trace
GET
/
v1
/
traces
/
{traceId}
Get a trace
curl --request GET \
--url https://app.egma.ai/v1/traces/{traceId} \
--header 'Authorization: Bearer <token>'{
"trace": {
"traceId": "<string>",
"startedAt": "2023-11-07T05:31:56Z",
"endedAt": "2023-11-07T05:31:56Z",
"durationNs": "<string>",
"spanCount": 123,
"turnCounts": {
"human": 123,
"agent": 123
},
"toolSpanCount": 123,
"erroredSpanCount": 123,
"source": "simulation",
"pov": "persona",
"environment": "<string>",
"connectionType": "<string>",
"providerCallId": "<string>",
"agentPlatform": "<string>",
"platformAgentId": "<string>",
"platformAgentName": "<string>",
"platformAgentVersion": "<string>",
"runId": "<string>",
"agentId": "<string>"
},
"turns": [
{
"spanId": "<string>",
"parentSpanId": "<string>",
"name": "<string>",
"kind": "<string>",
"status": "<string>",
"startedAt": "2023-11-07T05:31:56Z",
"durationNs": "<string>",
"text": "<string>",
"audioUrl": "<string>",
"toolName": "<string>",
"toolArguments": "<string>",
"toolResult": "<string>",
"pov": "persona",
"spans": "<array>",
"toolProvenance": "mocked"
}
],
"spans": [
{
"spanId": "<string>",
"parentSpanId": "<string>",
"name": "<string>",
"kind": "<string>",
"status": "<string>",
"startedAt": "2023-11-07T05:31:56Z",
"durationNs": "<string>",
"text": "<string>",
"audioUrl": "<string>",
"toolName": "<string>",
"toolArguments": "<string>",
"toolResult": "<string>",
"pov": "persona",
"spans": "<array>",
"toolProvenance": "mocked"
}
],
"spansTruncated": true,
"metrics": [
{
"measure": "<string>",
"unit": "<string>",
"derived": true,
"pov": "persona",
"samples": [
123
],
"spanIds": [
"<string>"
],
"mean": 123,
"p50": 123,
"p90": 123,
"partial": true,
"reportedBy": "<string>",
"otherPov": {
"pov": "persona",
"derived": true,
"samples": [
123
],
"spanIds": [
"<string>"
],
"partial": true,
"reportedBy": "<string>"
}
}
],
"simulationId": "<string>",
"gradingState": "not_requested",
"workBlock": {
"error": "allowance_spent",
"message": "<string>"
},
"grades": [
{
"projectGraderId": "<string>",
"graderDefinitionId": "<string>",
"graderDefinitionVersion": 2,
"parameterValues": {},
"graderName": "<string>",
"score": 0.5,
"details": {
"rationale": "<string>",
"assertions": [
{
"key": "<string>",
"decision": "met",
"score": 0.5,
"rationale": "<string>",
"citedSpanIds": [
"<string>"
],
"citedTurns": [
2
],
"error": "<string>"
}
],
"error": "<string>"
},
"passThreshold": 0.5,
"result": "passed",
"gradedAt": "2023-11-07T05:31:56Z"
}
],
"gradeHistory": [
{
"projectGraderId": "<string>",
"graderDefinitionId": "<string>",
"graderDefinitionVersion": 2,
"parameterValues": {},
"graderName": "<string>",
"score": 0.5,
"details": {
"rationale": "<string>",
"assertions": [
{
"key": "<string>",
"decision": "met",
"score": 0.5,
"rationale": "<string>",
"citedSpanIds": [
"<string>"
],
"citedTurns": [
2
],
"error": "<string>"
}
],
"error": "<string>"
},
"passThreshold": 0.5,
"result": "passed",
"gradedAt": "2023-11-07T05:31:56Z"
}
],
"combinedScore": 0.5
}{
"error": "<string>",
"message": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}{
"error": "<string>",
"message": "<string>",
"details": {}
}Authorizations
bearerAuthsessionCookie
An Egma API key.
Path Parameters
Query Parameters
Minimum string length:
1Response
The trace and its grades.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Minimum string length:
1Available options:
not_requested, pending, running, complete, error Show child attributes
Show child attributes
The current result for each selected grader. Each grade has its own score, frozen threshold, result, and supporting details.
Show child attributes
Show child attributes
Recorded grade results, including previous grading attempts. Regrading preserves this history.
Show child attributes
Show child attributes
Display-only arithmetic mean when every selected grader has a current score. Null while a required score is missing or errored. This is not an overall pass/fail result.
Required range:
0 <= x <= 1