Agent Chat Guide

Agent Chat is a built-in conversational assistant that helps you modify your app and manage data -- all through natural language. Instead of configuring things manually, just tell the agent what you want.

---

Opening Agent Chat

1. Open any app in the workspace editor.
2. Click the Agent Chat button in the toolbar.
3. The editor splits into two panels: your app on the left and the chat panel on the right.

If you installed the app from a template, Agent Chat opens automatically so you can start customizing right away.

---

How It Works

When you type a message, the agent:

1. Reads your app's current structure (data tables, fields, layout, actions)
2. Decides how to fulfill your request
3. Makes the changes
4. Explains what was modified

Your app on the left updates in real time as the agent works. You can watch changes appear as they happen.

---

What You Can Ask

Here are common things you can ask the agent to do:

Changing Your App's Structure

• "Add a priority column to my tasks table"
• "Create a new table for customer feedback with name, email, and message fields"
• "Change the heading text to 'Q1 Sales Report'"
• "Add a bar chart showing revenue by month"
• "Remove the notes field from the projects table"
• "Add a form to submit new expense entries"
• "Rename the 'amt' field to 'amount' in the expenses table"
• "Show the email field in the customers table display"
• "Add a pie chart of expenses by category"

Managing Your Data

• "Show me all the records in the orders table"
• "How many orders do I have?"
• "Add a task called 'Review proposal' with high priority"
• "Mark the first task as completed"
• "Delete the test record I just created"
• "Clear all the sample data from the contacts table"

Asking Questions

• "What tables does my app have?"
• "What fields does the orders table have?"
• "How many records are in the contacts table?"
• "Find the chart that shows revenue data"

---

Available Tools

The agent has 19 tools organized into two categories: tools that change your app's structure and tools that manage your data.

Structure Tools (13)

These tools modify your app -- its tables, fields, layout, and actions.

Data Tools (6)

These tools manage the records (rows) stored in your app's data tables.

---

Adding Charts

When you ask for a chart, the agent adds it to your app automatically. Four chart types are supported:

For bar, line, and area charts, you can specify the X-axis field, Y-axis field, and optional grouping. For pie charts, you can specify the label field and value field. You can also request colors and whether a pie chart should be a donut.

---

Destructive Operations

Some operations cannot be undone. The agent is designed to protect you from accidental data loss:

Operations that require confirmation

If the agent does not ask for confirmation before a destructive action, you can say "wait" or "stop" before it proceeds.

Version safety net

Even if a structural change goes wrong, you can always revert to a previous version using the History button in the toolbar. Data deletions, however, cannot be reverted -- deleted records are gone permanently.

---

Choosing an AI Model

Agent Chat uses the same AI model system as app creation. You can choose which model powers the agent:

1. At the bottom of the chat panel, select a model from the dropdown before sending a message.
2. The platform default (Gemini 2.5 Flash) is free and works well for most modifications.
3. If you have a BYOK key configured, you can use any of the supported models (GPT-4o, Claude, Gemini 2.5 Pro, OpenRouter models, etc.).

Your model choice applies per-message, so you can switch between models during a conversation.

---

Rate Limits

Agent Chat is rate-limited to protect platform stability:

Each conversation supports up to 50 messages. If you need to continue working on an app after reaching the limit, close and reopen Agent Chat to start a fresh conversation.

---

The Modify Bar

In addition to Agent Chat, you can also modify your app using the modify bar at the bottom of the editor. The modify bar is a single-prompt interface -- type a change, click Modify, and the AI updates your app.

Agent Chat vs Modify Bar:

Both use the same AI models and produce the same quality of results. Use whichever feels more natural for the task at hand.

---

Tips for Better Results

1. Be specific -- "Add a 'due date' field to the tasks table" works better than "add dates".
2. One change at a time -- the agent handles complex requests, but single-step instructions are more reliable.
3. Use natural language -- you do not need to know technical terms. Say "add a column" or "add a chart" and the agent figures out the rest.
4. Check the result -- the rendered app on the left updates in real time. Verify the change looks right before asking for the next one.
5. Ask questions -- the agent can explain your app's current structure. Try "What fields does the orders table have?" or "How many records are in the contacts table?"

---

Limitations

• Agent Chat modifies only the app you have open. It cannot access other apps in your workspace.
• The agent cannot upload images, access external websites, or run code.
• Chart configurations may need fine-tuning -- if a chart does not look right, ask the agent to adjust the fields or chart type.
• The agent cannot undo data deletions. Use the History button for structural reverts only.
• Each conversation supports up to 50 messages and 10,000 characters per message.

---

Related