Retrieve Trace For Step

client.steps.trace.retrieve(, ?): ProviderTrace { request_json, response_json, id, 13 more } | null

get/v1/steps/{step_id}/trace

ParametersExpand Collapse

stepID: string

The ID of the step in the format 'step-'

minLength41

maxLength41

ReturnsExpand Collapse

ProviderTrace { request_json, response_json, id, 13 more } | null

request_json: Record<string, unknown>

JSON content of the provider request

response_json: Record<string, unknown>

JSON content of the provider response

id?: string

The human-friendly ID of the Provider_trace

agent_id?: string | null

ID of the agent that generated this trace

agent_tags?: Array<string> | null

Tags associated with the agent for filtering

call_type?: string | null

Type of call (agent_step, summarization, etc.)

compaction_settings?: Record<string, unknown> | null

Compaction/summarization settings (summarization calls only)

created_at?: string

The timestamp when the object was created.

formatdate-time

created_by_id?: string | null

The id of the user that made this object.

last_updated_by_id?: string | null

The id of the user that made this object.

llm_config?: Record<string, unknown> | null

LLM configuration used for this call (non-summarization calls only)

org_id?: string | null

ID of the organization

run_id?: string | null

ID of the run this trace is associated with

source?: string | null

Source service that generated this trace (memgpt-server, lettuce-py)

step_id?: string | null

ID of the step that this trace is associated with

updated_at?: string | null

The timestamp when the object was last updated.

formatdate-time

Retrieve Trace For Step

import Letta from '@letta-ai/letta-client';

const client = new Letta({
  apiKey: process.env['LETTA_API_KEY'], // This is the default and can be omitted
});

const providerTrace = await client.steps.trace.retrieve('step-123e4567-e89b-42d3-8456-426614174000');

console.log(providerTrace.id);

{
  "request_json": {
    "foo": "bar"
  },
  "response_json": {
    "foo": "bar"
  },
  "id": "provider_trace-123e4567-e89b-12d3-a456-426614174000",
  "agent_id": "agent_id",
  "agent_tags": [
    "string"
  ],
  "call_type": "call_type",
  "compaction_settings": {
    "foo": "bar"
  },
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by_id": "created_by_id",
  "last_updated_by_id": "last_updated_by_id",
  "llm_config": {
    "foo": "bar"
  },
  "org_id": "org_id",
  "run_id": "run_id",
  "source": "source",
  "step_id": "step_id",
  "updated_at": "2019-12-27T18:11:19.117Z"
}

Returns Examples

{
  "request_json": {
    "foo": "bar"
  },
  "response_json": {
    "foo": "bar"
  },
  "id": "provider_trace-123e4567-e89b-12d3-a456-426614174000",
  "agent_id": "agent_id",
  "agent_tags": [
    "string"
  ],
  "call_type": "call_type",
  "compaction_settings": {
    "foo": "bar"
  },
  "created_at": "2019-12-27T18:11:19.117Z",
  "created_by_id": "created_by_id",
  "last_updated_by_id": "last_updated_by_id",
  "llm_config": {
    "foo": "bar"
  },
  "org_id": "org_id",
  "run_id": "run_id",
  "source": "source",
  "step_id": "step_id",
  "updated_at": "2019-12-27T18:11:19.117Z"
}