> For the complete documentation index, see [llms.txt](https://docs.riff.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.riff.ai/reference/app-builder/riff-agent-chat.md). # Riff agent chat The Riff agent chat panel is on the right side of the App builder. You build your app by talking to the Riff agent here — describing what you want, reviewing what it builds, and iterating. For the full reference on the chat panel controls (thread navigation, Agent dropdown, Build / Plan toggle, file attachments, skill mentions), see [Riff agent chat panel](/reference/riff-agent/chat-panel.md). ## Starting a conversation Type what you want and press Enter. The Riff agent reads your message, considers the current state of your app and your connected integrations, and responds — usually by making changes directly. You don't need to frame requests as technical instructions. Describe the outcome you want: * "Add a table that shows open purchase orders from this week, sorted by supplier" * "The submit button isn't working — can you check what's happening?" * "Connect this form to the SAP integration and write the output back to the PO table" ## Threads Each conversation is a thread. Use the Thread Selector at the top of the panel to switch between threads or start a new one. Threads let you keep separate topics — a feature you're building, a bug you're debugging — without losing context from either. ## The Build / Plan toggle By default the Riff agent is in **Build mode** — it acts on your messages. Switch to **Plan mode** when you want to review what it intends to do before it does it. Plan mode is shown in orange. See [Build / Plan toggle](/reference/riff-agent/build-plan-toggle.md). ## Skills Type `/` in the chat input to load a skill — a prepared brief or instruction set for a specific type of task. The skill's content is added to your message. See [Skills](/reference/riff-agent/skills.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.riff.ai/reference/app-builder/riff-agent-chat.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.