Skip to main content

Interface: ITraceEntry

Defined in: internal/trace/types.ts:220

One recorded LLM interaction.

Properties​

chunkIds​

chunkIds: string[]

Defined in: internal/trace/types.ts:251

Filled by Trace.annotate for CHAT / RUN_STEP.

costUsd​

costUsd: number

Defined in: internal/trace/types.ts:255

List-price cost of the call (ModelRegistry.estimateCostUsd).

createdAt​

createdAt: Date

Defined in: internal/trace/types.ts:257

When the call ended.

id​

id: string

Defined in: internal/trace/types.ts:222

The trace id: the traceId of the result, the usage report and the rule_error reports.

issues​

issues: IIssue[]

Defined in: internal/trace/types.ts:253

Filled by Trace.annotate for CHAT / RUN_STEP.

kind​

kind: ETraceKind

Defined in: internal/trace/types.ts:234

What the call was for.

modelId​

modelId: string

Defined in: internal/trace/types.ts:236

The model that answered.

profileId?​

optional profileId?: string

Defined in: internal/trace/types.ts:228

The profile the call ran on. Absent for system jobs (e.g. KB ingestion).

request?​

optional request?: Omit<IModelRequest, "outputSchema">

Defined in: internal/trace/types.ts:245

The request as sent, its files without their bytes (D108) and without the outputSchema (D36: a zod schema is code, it cannot be stored). A repository that must not keep it drops it in save.

result?​

optional result?: IModelResult

Defined in: internal/trace/types.ts:247

Absent for EMBED.

runId?​

optional runId?: string

Defined in: internal/trace/types.ts:232

The run the call was a step of; absent outside a run.

templateKey?​

optional templateKey?: EPromptTemplateKey

Defined in: internal/trace/types.ts:238

The prompt template the request was rendered from; set by annotate for CHAT / RUN_STEP.

templateVersion?​

optional templateVersion?: number

Defined in: internal/trace/types.ts:240

The version of that template, so an answer can be read against the prompt of its day.

tenantId​

tenantId: string

Defined in: internal/trace/types.ts:224

The tenant of the call; every query and deletion is scoped by it.

threadId?​

optional threadId?: string

Defined in: internal/trace/types.ts:230

The thread of the call; absent for a call outside a thread (an embedding, a KB ingestion).

usage​

usage: IUsage

Defined in: internal/trace/types.ts:249

What the provider reported; all zero for a failed or aborted call.

userId?​

optional userId?: string

Defined in: internal/trace/types.ts:226

Absent for system jobs (e.g. KB ingestion).