Skip to main content

Sessions

Complex AI workflows often require multiple trace executions to complete a user's request. VoltOps sessions automatically organize related traces into unified conversations, providing complete visibility into multi-step interactions. Simply include a conversationId when creating traces to enable session grouping.

Creating Sessions​

Include a conversationId parameter when creating traces. Use any string identifier that represents your conversation or workflow. VoltOps will automatically group all traces sharing the same conversationId into a session.

Session Usage Patterns

Basic Session Creation
Multi-Turn Conversation
Session ID Best Practices

Basic Session Creation

Create a session by adding conversationId to group related traces together.

JS/TS SDK
Python SDK
Vercel AI SDK
Example:
const trace = await sdk.trace({
  name: "Customer Support Query",
  agentId: "support-agent-v1",
  input: { query: "How to reset password?" },
  userId: "user-123",
  conversationId: "conv-456",
  tags: ["support", "password-reset"],
  metadata: {
    priority: "high",
    source: "web-chat",
  },
});

Trace creation in dashboard

Session Replay​

VoltOps dashboard automatically groups traces by conversationId, enabling you to:

  • Follow complete conversation threads
  • Troubleshoot with full interaction context
  • Monitor performance across entire user journeys
  • Measure success rates for complete workflows

Sessions provide holistic views of user interactions by connecting related traces into coherent workflows.

Table of Contents