Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.teable.ai/llms.txt

Use this file to discover all available pages before exploring further.

Available on all Cloud plans; Self-Hosted requires Business or higher.
Teable’s AI Chat reads the context of the page you’re on and helps turn questions about data into directly usable results. It works well for analyzing tables, generating charts, following up with more questions, and handling more complex agent tasks with context.

​
How to Open

Click the Cuppy icon in the top right corner to open AI Chat from any page.

​
Context Scope

AI Chat automatically reads the current context, including:
  • Current table and view: It prioritizes the table, view, and filtered result set you are currently looking at.
  • Selected records and attachments: Selected data and uploaded files on the page are included too.
  • Manually added context: If you need to ask across tables, you can add related tables into the context first.

​
Capabilities

​
1. Deep Data Analysis (Text-to-SQL)

Teable’s AI Chat does more than guess. It works like a data analyst that can turn your request into a real query.
  • SQL Generation: It converts your natural language questions into complex, executable SQL queries.
  • Precision: Because it executes code against your database, results such as counts, sums, and averages are 100% accurate.
  • Complex Logic: It can handle grouping, filtering, and cross-table references.
    • “Which product category had the highest growth rate QoverQ?”
    • “List customers who haven’t placed an order in the last 6 months but have a balance > 0.”

​
2. Charts and Visualization

  • Bar, line, pie, scatter, and area charts are all supported.
  • You can keep refining a chart through chat, such as “Switch to a stacked bar chart” or “Group by region”.
  • For more complex presentation needs, you can first ask AI Chat to shape the data into a chart-ready format.

​
3. Smart Agent

AI Chat does not only answer questions. It can also help you move the next step forward.
  • App Builder: Start creating apps directly from the conversation.
  • Automation: Describe a workflow and let AI help configure triggers and actions.
  • Scripts: Ask AI to generate more specific JavaScript for your use case.

​
4. Read Files and Web Pages

If you upload files, or if the selected model supports web search, AI Chat can use that content alongside your data.
  • Supports PDFs, Excel files, Word files, images, and other attachments.
  • Can answer by combining document content with table data.
  • If the current model has web search enabled, AI Chat shows web results together with source links.

​
Good Times to Start a New Chat

  • The topic has changed.
  • The current conversation has become too long and the result starts drifting.
  • You want to reduce the extra compute cost caused by too much previous context.

​
Best Practices

  • State the goal clearly: Instead of saying “Analyze this,” say something like “Analyze weekly sales trends over the past 3 months.”
  • Use field names when possible: For example, “Sort by Created Time.”
  • Start a new chat when the topic changes: A new chat is usually more stable and uses less compute.
Last modified on April 22, 2026