agentlens_log_llm_call
Log an LLM call's request and response to an AgentLens session. Provides token usage, cost, latency, and model parameters for observability.
Instructions
Log a complete LLM call (request + response) to an active AgentLens session. Emits paired llm_call and llm_response events.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sessionId | Yes | Session ID from agentlens_session_start | |
| provider | Yes | LLM provider name (e.g., "anthropic", "openai", "google") | |
| model | Yes | Model identifier (e.g., "claude-opus-4-6", "gpt-4o") | |
| messages | Yes | The prompt messages sent to the model | |
| systemPrompt | No | System prompt (if separate from messages) | |
| completion | Yes | The completion content returned by the model | |
| toolCalls | No | Tool calls requested by the model | |
| finishReason | Yes | Stop reason (e.g., "stop", "length", "tool_use", "content_filter", "error") | |
| usage | Yes | Token usage counts | |
| costUsd | Yes | Cost of this call in USD | |
| latencyMs | Yes | Latency in milliseconds | |
| parameters | No | Model parameters (temperature, maxTokens, etc.) | |
| tools | No | Tool/function definitions provided to the model |