Skip to main content
Available on all Cloud plans; Self-Hosted requires Business or higher.
AI Chat helps analyze the current table, explain record content, generate charts and reports, and create or update tables, views, apps, and automations. AI prioritizes the current page. To reference other tables, views, apps, automations, or folders, type @ in the input box and select the related node.

​
How to Open

Open a table or view, then click the Cuppy in the top right corner to open AI Chat. Describe the question or task in the input box. If the task will modify data or create nodes, ask AI to list the plan first, then confirm before execution.

​
What AI Can Reference

AI prioritizes information from the current page:
  • Current table and view: The current table, current view, and the filtered or sorted results in that view.
  • Selected rows, columns, and cells: If rows, columns, a single cell, or a cell range are selected in Grid view, AI uses that selection as key context.
  • Uploaded files: Add PDFs, Excel files, Word documents, images, and other files to the conversation.
  • More nodes with @: Type @ in the input box to add tables, views, apps, automations, or folders from the tree.
Files can also be pasted or dropped directly into the input box. They appear as attachment chips first, then become available to AI after the message is sent. When you paste a long block of plain text, Teable converts it to a Markdown attachment so the message input stays easy to read. You can preview text and Markdown attachments from their attachment chips.

​
Input Controls

  • Voice input: Click the microphone button in the input box and allow microphone access to start recording. While recording, choose Finish voice input or Discard voice input. After you choose finish, Teable transcribes the recording into the input box.
  • Model: Use the model menu to choose the model tier for the conversation. The menu lists Ultra, Smart, Standard, and Lite from the most capable down, each showing the model behind it; your admin can swap that model at any time, or offer only some of the tiers, and you never have to pick again. Use a lower tier for simple queries, cleanup, or rewriting, and a higher tier for complex planning, cross-table analysis, and app building.
  • Intelligence: Choose the Intelligence level separately in the model menu. It controls thinking depth; higher levels produce more thorough reasoning.
  • My secrets: Open + → More → My secrets to store API keys or other credentials in Settings → Integrations. The values are yours, AI Chat can read them as environment variables at runtime, and you can grant them to individual apps and automations. See Credentials and Integrations.
  • Credential requests: When AI needs a third-party account or a secret, it pins a credential request card to the conversation. Choose Connect my account to run an OAuth flow, or grant a credential you already have. Click Skip to withhold it; AI continues with the parts it can complete without it.
  • Scraper: Open the + menu and choose Scraper, then pick a platform and a data type. Entries come in two kinds: some scrape a link you paste, such as personal profile on LinkedIn or product reviews on Amazon; others search by keyword, hashtag, or name, such as video search on TikTok or posts of a subreddit on Reddit. Teable prefills the matching instruction in the chat input and leaves the part you need to fill in at the end. Any web page takes a pasted link directly.
  • Skills: Open the + menu and choose Skills to import, enable, disable, or try skills in the current chat. When you import one, choose who can use it: Personal keeps it to yourself, Project gives it to collaborators in this project, and Space gives it to everyone in this space. Type / in the input box to choose an enabled skill. To connect or migrate an external system, see Connect & Migrate Everything.
  • Context usage: The ring next to the input box shows how much of the model’s context window the conversation currently uses. Click it for the percentage and token counts. When the context fills up, Teable compacts the conversation; start a new chat if you want a clean context instead.
  • Manage files: Open + → More → Manage files to view files in the current chat sandbox. You can preview supported files, download files, or delete files and folders you no longer need. A conversation must exist before its files can be managed.
  • Message queue: Sending another message while AI is working does not interrupt it. The message waits in a queue above the input box and goes out when the current run ends. Queued items keep the same table, view, attachment, and selection chips as the chat input; Remove drops one, … → Edit message puts it back in the input box, and a text-only item also offers Steer to hand its text to the running turn instead of waiting.

​
Manage Chats

Click History at the top right of the chat panel to see your chats in the current project, and search them by name. The dot next to a chat name marks which chats need you. Waiting for your reply means the turn has stopped at a point that needs you: a question from the agent, an authorization, a table to pick, or a credential request. It will not continue until you answer. Reply failed means the last reply did not finish properly; open it and ask again. Generating… and the unread dot only report progress and new replies, and need nothing from you. The … menu on a chat offers Pin, Rename, Archive, and delete. Deleting also removes all of its messages and cannot be undone. History shows the 100 most recent chats. Pin the ones you use often: a pinned chat leads the list and is exempt from that limit, so it is never pushed out as new chats pile up. You can also drag a chat to reposition it. App Builder chats are named after their app and cannot be archived.

​
Archived Chats

Archiving takes a chat out of the history list without deleting anything. Open your avatar at the bottom left → Settings → Archived chats to see chats you archived across projects. Restore brings one back to its project’s chat history, and you can delete it here once you are sure you no longer need it.

​
Common Uses

Create tables and automations

Plan a business database, create tables, views, apps, automations, or update existing records.

Analyze data

Summarize data in the current table or view, or analyze across multiple related nodes.

Charts and reports

Turn queried data into a chart, report, or small interactive page you can reopen and share.

Read files

Answer questions using PDFs, Excel files, Word documents, images, and other attachments.

​
Create Tables and Automations

AI Chat can help create, update, and organize data, not only answer questions. For a new business workflow, discuss the data structure first, then ask AI to create the tables, views, apps, and automations. Suitable prompts include:
  • Help me plan a customer follow-up system. What tables and fields do I need?
  • Based on the plan above, create these tables, views, and fields.
  • Add priority, assignee, due date, and status fields to the task table, then create common views.
  • Change the selected records to Completed.
  • Create a new table from this Excel file and check whether the field types are appropriate.
  • Create a CRM app from this customer table, with customer list, customer detail, and follow-up record pages.
  • When a new order is created, notify the owner and include the order number, customer name, and amount.
For a complete business database, start by asking AI to plan the table structure. After reviewing the plan, continue with table, view, app, and automation creation.
1

Plan first

Describe the business goal, such as building a customer follow-up system, and ask AI to outline the required tables, fields, views, and automations.
2

Confirm the structure

Review the proposed tables, fields, field types, and relationships. Add any missing rules or workflow details.
3

Create next

Ask AI to create the confirmed tables and views, then continue with apps or automations.
Changes this turn, below each answer, lists what the turn changed, resource by resource: fields, views, and record counts added, updated, or deleted, and apps and automations published or switched on and off. Click an entry to open that resource and check it. For app creation details, see App Builder. For automation details, see Automation.

​
Analyze Data

Ask questions about data in the current table, for example:
  • Count completed tasks this month by assignee.
  • Find the customers with the highest sales in the past 30 days.
  • Analyze unusual records in this view.
If the question involves multiple tables, use @ to add the related tables or views to the conversation. In Grid view, you can also select rows, columns, a single cell, or a cell range, then use Add to Chat from the context menu. The selection appears as a chip in the input box, and clicking the chip highlights the related grid area again. Column chips use field names when available and shorten long selections after the first few names.

​
Create Charts and Reports

Ask AI to turn queried data into a chart, a written report, or a small interactive page:
  • Generate a weekly sales trend chart.
  • Turn this query result into a pie chart.
  • Create a summary report from these records.
AI builds these as artifacts: they appear as a card in the conversation, open in their own viewer, and stay available after the conversation ends. See Artifacts for what you can do with one.
An artifact holds the data AI put into it when it was created, so it does not refresh on its own. For a page that keeps reading live table data, or that collects input and stores state, create an app with App Builder.

​
Generate Images

Have the AI produce images directly — product concepts, article artwork, poster drafts:
  • Draw a scene showing this product in use.
  • Generate a cover image from the description in this record.
  • Take this image and give me three more in winter colours.
Add an existing image to the chat to use it as a reference, as long as the chosen model supports image-to-image. A generation card appears in the chat: it shows which model is running and how many images are left, then presents the finished set as a gallery you can click to enlarge. The images are kept in the chat’s sandbox and can be downloaded from Manage files. Stopping the turn cancels whatever is still unfinished.
AI Chat, the App Builder, and routines can all generate images; chatting with Cuppy in an IM cannot.

​
Read Files

After uploading files, AI can answer questions using both file content and table data:
  • Summarize this PDF and connect it with the current customer record.
  • Read this Excel file and identify the fields that should be imported.
  • Generate a product description from this image.
Files uploaded to the conversation and files generated during the conversation are saved in the current chat sandbox. Use Manage files to inspect them later. When a reply presents several files at once, use Download all below the file cards to save them as one zip.

​
Memory

Memory stores information you explicitly ask Cuppy to remember. Memory is scoped by user and Project: each user in each Project has an independent memory context, and memory saved in another Project will not automatically appear in the current one.
  • Save memory in the current Project
Say what Cuppy should remember in the conversation:
  • Reuse memory from another Project
Ask Cuppy to read another Project and save the relevant parts into the current Project:

​
Handle Long Tasks

AI Chat can keep a single conversation environment available for about 24 hours, which is enough for most data analysis, file processing, and app-building tasks. Keep long-running work in the current conversation so you can follow its progress and provide input when needed.
1

Follow progress in the current conversation

If the interface shows Thinking or continues to return progress updates, the task is still running. If it shows Completed, the current run has finished.
2

Save results at useful checkpoints

For work with multiple stages, ask Cuppy to write results back to Teable, export them, or generate a downloadable file at key checkpoints. Saved work remains available even if the conversation environment is released later.
3

Know when the environment is released

A single conversation environment has an approximate maximum lifetime of 24 hours. After foreground execution ends, an idle environment is released after about 30 minutes. Temporary files and unsaved intermediate results are not preserved if the environment restarts.
For long-running or repeatable work, use the feature that matches the workflow:

AI Fields

Use for record-by-record work, such as large table processing, batch classification, content processing, or field filling.

Automation

Use for repeatable work after records are created or updated, notifications, or scheduled data processing.

​
Artifacts

When AI builds a chart, report, dashboard-style page, or small interactive tool, it saves the result as an artifact: a self-contained page that renders outside the conversation. Artifacts appear as a card in the chat and stay available afterwards. Each one is either an interactive HTML page or a Markdown report. Click the card to open the artifact. From the viewer you can:
  • Fullscreen or Open in new page to give the artifact more room.
  • Download the current version as a file.
  • Open the version list to look at an earlier version and Restore this version to make it current again.
  • Delete the artifact. Its cards in the conversation turn into a deleted placeholder, so delete only when you no longer need the result.
To change an artifact, ask AI in the same conversation. Each revision becomes a new version of the same artifact rather than a separate one, so the share link keeps working and you can still go back. If the page fails to run, the viewer shows the error and offers Fix with AI, which sends the error back to the chat so AI can correct it.

​
Share an Artifact

Artifacts are private to the person who created them, so use a share link to let anyone else open one.
1

Turn on sharing

Click Share in the viewer and enable Enable sharing. Teable generates the link.
2

Choose who can view

Set Who can view to Anyone with the link, or to Space members so only signed-in members of the space can open it.
3

Add a password (optional)

Under the advanced settings, turn on Password protection and set a password. Viewers must enter it before the artifact loads.
4

Send the link

Use Copy link to copy it. If the link has spread too far, Reset link issues a new one and stops the old link from working.

​
Find Artifacts Later

Open + → More → Manage artifacts to browse everything you have created across your chats. Search by name, then open one to view or reshare it.

​
Prompting Tips

  • State the goal first: In the first message, describe what to do, the relevant conditions, and the expected output. For example, analyze weekly sales trends over the past 3 months, grouped by region, and return a trend table with a short conclusion.
  • Use field names: For example, sort by Created Time, so AI can identify the target column.
  • Provide several examples: For fixed-format output, provide 3-5 input -> expected output examples.
  • Use @ to select nodes: When AI needs to reference tables, views, apps, automations, or folders, type @ and select them directly.
  • Confirm before execution: For tasks that modify data, create tables, create apps, or enable automations, ask AI to describe the changes before running them.
  • Choose the tier by task: A lower tier costs less credit on simple queries, cleanup, and rewriting; move up a tier for complex planning, cross-table analysis, and app building.
  • Adjust the Intelligence level: Intelligence controls thinking depth; higher levels produce more thorough reasoning.
  • Start a new chat when the topic changes: A new chat is recommended when the topic changes, the conversation becomes too long, or context usage should be reduced.

​
FAQ

Type @ in the input box and select the node you want AI Chat to reference. For Grid view selections, you can also select rows, columns, a single cell, or a cell range, then use Add to Chat from the context menu.
Yes. AI is not limited to the project the chat belongs to; it can look up the other projects you have access to and work in them. Name the project in your request, for example “compare this table with the orders table in the Sales project”. @ only lists nodes in the current project, and anything you do not point elsewhere still happens in the chat’s own project.
Yes. They are saved as artifacts, with version history and an optional share link, and you can reopen them from + → More → Manage artifacts. An artifact keeps the data it was built with and does not refresh on its own. For a page that reads live table data, create an app with App Builder.
Not by default. Only you can open your own artifacts. Turn on Enable sharing in the viewer and send the link, choosing Space members if the artifact should stay inside the space.
Five by default. Ask the AI to work in several rounds when you need more. The number of images a space can have in flight at once is capped as well, and anything beyond it waits in the queue.
The available image models come from the project’s AI configuration: the space’s own models first, then the models Teable provides. When the project has no image model available, the AI does not offer image generation at all.
An image counts against credits only once it is saved; images that fail or are cancelled cost nothing. In Credit usage summary on the billing page, these charges appear under the type AI image generation. When the space has its own models (BYOK), generating with them is not blocked by exhausted credits.
No. Memory is scoped by user and Project. If you want to reuse memory from another Project, ask Cuppy to read that Project’s memory and save the relevant parts into the current Project.
Do not use AI Chat as a background task runner. Keep working in the visible conversation, and ask Cuppy to write results back to Teable, export results, or generate a downloadable file.
Each user can run up to 3 Agents at the same time, including AI Chat and App Builder. If you see Agent is busy in another conversation. Please wait., another task is still running. Wait for Cuppy to finish the previous task before continuing.
One AI Chat turn can include multiple processing steps. The conversation and billing page both show the total credits for that turn. Work that Cuppy already completed and saved can still be used. If the final step is interrupted by an unexpected error, credits for that interrupted step are refunded automatically. You can continue working in the same conversation.
It joins the send queue above the input box rather than interrupting the run, and Teable sends the whole queue as one message when the run ends. The queue lives on the server, so it survives a refresh and looks the same in every tab or device where that conversation is open.While an item waits you can Remove it or use Edit message to bring it back into the input box. A text-only item can also be steered: Steer hands it to the running turn right away, and it then appears in the conversation labelled Steered conversation.A conversation holds up to 30 queued messages. Past that, the message is not queued and Teable replies The send queue is full. Wait for Cuppy to catch up.
Stopping a run also holds the queue, so nothing you queued is sent by a stop you meant for the current answer. The queue header then reads Queue paused because you interrupted. Click Resume to release it, or just send your next message: starting a new run releases the queue as well.
Open the + menu and choose Skills to import or manage skills, or type / in the input box to choose an enabled skill. Choose who can use the skill when you import it: personal for your own chats, project when collaborators in the same project need it, and space when everyone in the space does. Users who can manage the project can add project skills, and space owners and creators can add space skills. If AI Chat presents a .skill file, use Install on the file card to add it.
Only one version is ever in effect, and the shared team version wins over a personal copy: a project skill beats a space skill, and a space skill beats a personal one. In an app or bot conversation, the skill added for that app or bot comes first. To move everyone to a new version, update the copy in the project or space.
Manage files holds two folders: uploads for the files you added, and outputs for the files produced in the conversation. Both use their own storage, so they survive the sandbox being released or rebuilt and you can come back later to preview, download, or delete them.Anything Cuppy writes outside those two folders is temporary, such as intermediate results from a script. It does not appear in Manage files and is gone after the sandbox restarts. For results you need to keep, ask Cuppy to write them into outputs or back into Teable, or download them while the conversation is open, using Download all when a reply produced several files.
When you copy a user message, tables, views, apps, automations, folders, selections, and attachments are kept as marker text. When you paste the text back into AI Chat, Teable restores the markers it can recognize as chips.
Use + → More → My secrets in the chat input. AI Chat can use those values during the conversation without putting the plaintext in your prompt.
The menu holds the common platforms. Just describe in plain language which site and what content you want, and the AI will find a matching data source.
For list content such as search results, feeds, and comments, each link or keyword returns at most 10 records by default. Ask for a specific number if you need more, up to 50. Scraping a single page returns that one record and is not affected by this limit.
Last modified on September 17, 2026