AI Chat (Curupira)
Curupira is the AI assistant that lets you ask questions about your data in natural language. It generates SQL queries, executes them, and presents results as tables, charts, and insights.
Starting a Conversation
- Navigate to Chat in the sidebar
- Click New Conversation
- Select an AI specialist (optional) — different personas are optimized for different types of questions
- Type your question and press Enter
Example Questions
Here are some powerful questions you can ask:
| Category | Example Questions |
|---|---|
| Revenue | "What was the total revenue last month?" |
| Trends | "Show me the sales trend for the last 6 months" |
| Rankings | "What are the top 10 products by quantity sold?" |
| Comparisons | "Compare revenue between regions this quarter vs last quarter" |
| Patterns | "Which day of the week has the highest average order value?" |
| Filters | "Show all customers from São Paulo who spent more than R$1,000" |
How It Works
When you ask a question, Curupira:
- Understands your question using natural language processing
- Maps it to your available datasets and columns
- Generates a SQL query against your data warehouse
- Executes the query (up to 100 rows returned by default)
- Presents the results as a formatted table or chart
- Explains the answer in natural language
Understanding the Response
Each AI response may contain:
| Element | What It Is |
|---|---|
| SQL Query | The generated query — click to expand and see the full SQL |
| Data Table | The query results in a scrollable table |
| Chart | Visual representation (bar, line, pie chart) when appropriate |
| Explanation | Natural language summary of the findings |
| Deep Analysis Suggestion | When the AI detects a pattern worth investigating further |
Deep Analysis Suggestions
Sometimes Curupira will suggest a Deep Analysis when it detects:
- An unusual trend or outlier
- An opportunity for segmentation
- A pattern that warrants forecasting
"I notice an interesting pattern in your sales data. Would you like me to run a deep analysis to investigate further?"
Click Accept to trigger an automated investigation via the Iara analysis engine. The results will appear on the Deep Analysis page.
Managing Conversations
Recent Chats
The Chat page shows your recent conversations with:
- Title — auto-generated from your first question
- Timestamp — when the conversation was created
- Message count — number of messages in the conversation
Actions
| Action | Description |
|---|---|
| Open | Resume an existing conversation |
| Delete | Remove a conversation permanently |
| Show More | Load older conversations (10 at a time) |
Daily Message Limits
Each user has a daily message limit based on the workspace plan:
| Plan | Messages/user/day |
|---|---|
| Free | 5 |
| Starter | 10 |
| Growth | 20 |
| Business | 100 |
A warning appears when you're approaching your daily limit. The counter resets at midnight (workspace timezone).
Tip for better answers: Be specific in your questions. Instead of "show me sales", try "Show me total monthly sales for the last 12 months, grouped by product category". The more context you provide, the more accurate the AI's response.
Quick Ask (Dashboard)
You can also start a chat from the Dashboard using the Quick Ask bar at the top of the page. Type your question there and press Enter to jump directly into a new conversation.