Create Trace

Create a single trace directly via the API.

Returns

Returns a Trace object.

Example

manual_trace = galtea.traces.create(
    inference_result_id=inference_result_id,
    name="manual_db_call",
    type=TraceType.TOOL,
    start_time="2023-01-01T12:00:00Z",
    end_time="2023-01-01T12:00:01Z",
)

Parameters

inference_result_id · string · required

The ID of the inference result this trace belongs to.

name · string · required

The name of the tool or function that was called.

type · string

TraceType value: SPAN, GENERATION, EVENT, AGENT, TOOL, CHAIN, RETRIEVER, EVALUATOR, EMBEDDING, GUARDRAIL. See Trace Types for details. Other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.

description · string

Human-readable description of what this operation does. Useful for documentation and debugging. Maximum size: 1MB.

input_data · any

The input data passed to the tool/function. Accepts any JSON-serializable value. Maximum size: 10MB.

output_data · any

The output data returned by the tool/function. Accepts any JSON-serializable value. Maximum size: 10MB.

error · string

Error message if the tool call failed.

latency_ms · float

The time in milliseconds the tool call took.

metadata · any

Additional metadata about the trace. Accepts any JSON-serializable value. Maximum size: 10MB.

start_time · string

ISO 8601 timestamp when the trace started.

end_time · string

ISO 8601 timestamp when the trace ended.