Interface: AgentTrajectoryRequest

@kortexya/reasoninglayer / Cognitive / AgentTrajectoryRequest

Interface: AgentTrajectoryRequest

Defined in: src/types/cognitive.ts:1331

Request a trajectory/trend summary over an agent’s episodes.

Remarks

asOfTs and the summary itself use unix seconds (not milliseconds).

Example

const trend = await client.cognitive.getMemoryTrajectory({
  agentId,
  metric: 'success_rate',
});
console.log(trend.direction); // "improving" | "declining" | "flat"

Properties

agentId

agentId: string

Defined in: src/types/cognitive.ts:1333

Agent whose episodes are summarized (UUID).

asOfTs?

optional asOfTs: number | null

Defined in: src/types/cognitive.ts:1340

Optional as-of ceiling (unix seconds): only episodes recorded at or before this instant contribute (memory time-travel). Omit to consider all episodes.

maxResults?

optional maxResults: number | null

Defined in: src/types/cognitive.ts:1342

Cap on episodes considered (default: 1000).

metric?

optional metric: string | null

Defined in: src/types/cognitive.ts:1344

Metric to summarize: "success_rate" (default) or "reward".

tenantId

tenantId: string

Defined in: src/types/cognitive.ts:1335

Tenant ID (UUID).