Skip to main content

Overview

The Dialog Analysis API enables you to analyze user conversations and extract structured insights. Pass in recent dialog history along with a user profile, and receive an updated profile and feedback about the conversation.

Use Cases​

  • Profile enrichment: Extract and update user attributes from conversations
  • Conversation feedback: Generate summaries, sentiment analysis, or custom metrics
  • User understanding: Build richer user profiles over time through ongoing dialog

Typical Flow​

  1. Submit an analysis request with conversation history, current user profile, and schemas
  2. Receive a request ID to track progress
  3. Poll for results until the analysis completes
  4. Retrieve the updated profile and feedback

Key Features​

  • Asynchronous processing: Long-running analysis handled in the background
  • Flexible schemas: Define your own profile and feedback fields
  • Unknown value handling: Profile fields with unknown values are tracked and updated when discovered
  • Structured output: Results conform exactly to your specified schemas
Important Considerations
  • Retention: Output is available for 24 hours after completion
  • Rate limits: Requests are rate-limited per API key and globally
  • Input size: Total request payload must not exceed 100,000 characters