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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"sessionId": "<sessionId>",
"provider": "<provider>",
"model": "<model>",
"messages": "<messages>",
"completion": "<completion>",
"finishReason": "<finishReason>",
"usage": "<usage>",
"costUsd": "<costUsd>",
"latencyMs": "<latencyMs>"
},
"name": "agentlens_log_llm_call"
}
}Input 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 |