Skip to main content

​
What is the Data Agent?

The Data Agent is a conversational AI API that lets you query your Moda analytics data using natural language. Instead of writing SQL or navigating dashboards, you can ask questions like:
  • “What are my top 5 clusters by conversation count?”
  • “Show me the quality score trend for the last 7 days”
  • “Which conversations failed in cluster X?”
The agent uses RLM (Reasoning Language Model) to iteratively analyze your data, executing multiple tool calls to gather context and provide accurate answers.

Integration Guide

Add the Data Agent to your dashboard or internal tools.

​
How it works

Your Dashboard  -->  Data Agent API
                          |
                          |  (iterative analysis)
                          v
                    ClickHouse Data
                          |
                          v
                    Natural Language Answer
  1. Send a question to the Data Agent API
  2. Agent reasons about what data to fetch
  3. Executes tools to query clusters, conversations, quality scores
  4. Returns an answer with supporting context

​
Key features

Natural language queries

Ask questions in plain English. No SQL required.

Real-time streaming

Get live status updates as the agent analyzes your data.

Multi-step reasoning

Complex queries are broken into steps, with each step building context.

Tool-based analysis

Access to cluster stats, conversation lookup, quality metrics, and more.

​
Available tools

The agent has access to these analysis capabilities:
Tool CategoryDescription
cluster/statsCluster counts, sizes, and distributions
cluster/detailDetailed information about specific clusters
conversation/countConversation volumes and trends
conversation/lookupRetrieve specific conversations
analytics/evaluationQuality scores and metrics
sql/queryDirect SQL queries (advanced)

​
Example queries

  • “What are my most popular clusters?”
  • “List all clusters with their sizes”
  • “Which cluster has the lowest quality score?”
  • “Show me clusters created this week”
  • “How many conversations did I have today?”
  • “Show me the conversation trend for the last 30 days”
  • “Find conversations mentioning refunds”
  • “What’s the average conversation length?”
  • “What’s my average quality score?”
  • “Show me low quality conversations”
  • “Compare quality scores across clusters”
  • “Which cluster has the most failed conversations?”

​
API endpoints

EndpointMethodDescription
/healthGETHealth check
/v1/agent/analyzePOSTFull analysis (blocking)
/v1/agent/streamPOSTStreaming analysis with SSE
/v1/agent/toolsGETList available tools

​
Next steps

Integration Guide

Learn how to integrate the Data Agent into your application.