> ## Documentation Index > Fetch the complete documentation index at: https://docs.cassidyai.com/llms.txt > Use this file to discover all available pages before exploring further. # Use Widgets in Agent chats > Learn how to enable Widgets and create focused interactive forms, reviews, charts, and controls directly inside Agent conversations. Widgets let an [Agent](/agents/overview) place a focused interactive experience directly inside a chat reply. You can review information, filter data, provide missing details, attach supporting files, or send a structured follow-up without leaving the conversation. ![Agent reply containing an interactive inflation-adjusted market chart with time-range controls, summary values, and a line graph](https://mintcdn.com/cassidy/xMQv-8lYPPjfkYu1/images/agents/widgets/interactive-market-chart.png?fit=max\&auto=format\&n=xMQv-8lYPPjfkYu1\&q=85\&s=ce9c29e7862a84eccda47b1275d380ec) ## What Widgets are good for Widgets work best when an Agent has already done some work and needs a focused response or review from you. * **Review queues**: Check uncertain answers, approve decisions, add corrections, and attach source documents. * **Interactive analysis**: Filter a table, switch between chart views, compare scenarios, or inspect a subset of results. * **Guided intake**: Collect a small set of structured answers before the Agent continues. * **Approvals and handoffs**: Summarize a proposed action and let someone approve, reject, or request changes. * **Reusable tools**: Package a standard calculator, intake form, or review interface inside a [Skill](/skills/overview). Widgets can combine a review queue, source context, confidence, decision controls, notes, and supporting-document uploads in one focused surface. ![Agent reply containing a security questionnaire review Widget with a prioritized review queue, confidence labels, source context, decision controls, supporting-document upload, and save action](https://mintcdn.com/cassidy/xMQv-8lYPPjfkYu1/images/agents/widgets/security-questionnaire-review.png?fit=max\&auto=format\&n=xMQv-8lYPPjfkYu1\&q=85\&s=829cd8e7462e6a1e90341826b3440f50) After you submit a review, the Widget can leave a compact receipt that preserves what you sent while the Agent continues the conversation. ![Submitted security questionnaire review Widget showing approved and edited decision counts, a control to view submitted details, the follow-up message, and the Agent continuing with the reviewed decisions](https://mintcdn.com/cassidy/xMQv-8lYPPjfkYu1/images/agents/widgets/security-questionnaire-review-submitted.png?fit=max\&auto=format\&n=xMQv-8lYPPjfkYu1\&q=85\&s=254eb139aef5bec4e164d10211923df7) Use an [Artifact](/agents/capabilities/artifacts) instead when the result should be a larger, persistent dashboard, prototype, report, or standalone tool. ## Enable Widgets Widgets is off by default in chat. Turn it on for a single chat from the tools menu, or add it to an Agent so every chat with that Agent can use it. > [!NOTE] > > **Prerequisites**: The Agent must have [Code Execution & File > Creation](/agents/advanced/code-execution-file-creation) enabled. **1. Choose where to enable Widgets** For a reusable Agent configuration, open the Agent editor and use the **Setup** tab. For a one-off test in chat, open the tools menu beside the chat input. **2. Turn on Widgets** In the Agent editor, add **Widgets** under **Capabilities** and publish the Agent. In a chat, select **Widgets** from the tools menu instead. ![Chat tools menu with the Widgets capability enabled and its description visible](https://mintcdn.com/cassidy/xMQv-8lYPPjfkYu1/images/agents/widgets/chat-tools-menu.png?fit=max\&auto=format\&n=xMQv-8lYPPjfkYu1\&q=85\&s=778470368cca0ffefb90d512478b207d) ## Ask an Agent to create a Widget An Agent creates a Widget only when you explicitly ask for a **widget** or **interactive widget**. Ordinary requests for a chart, form, or visualization do not automatically use Widgets. **1. Describe the outcome and interaction** Tell the Agent what the Widget should help you review or accomplish. Include the decisions, fields, filters, or actions that matter. For example: `Create an interactive widget that compares these two employee censuses, highlights meaningful changes, and lets me ask about a selected change.` **2. Use the Widget in the reply** Click, filter, type, select values, or attach requested files directly inside the Agent's message. Submitting a Widget can send your selections back to the same conversation so the Agent can continue. **3. Ask for adjustments** Request changes in plain language, such as `Make the review queue wider, add a confidence filter, and show the source for each answer.` The Agent can revise and present the Widget again. ## Example prompts ### Review a security questionnaire `Create an interactive widget for reviewing the security questionnaire you answered. Group the questions that need my input by confidence, let me correct answers or attach supporting documents, and show a summary before I submit my review.` ### Explore an analysis `Create a widget that shows monthly retention by customer segment. Let me change the date range, compare two segments, and select an unusual month to ask you for an explanation.` ### Approve a customer handoff `Create a widget that summarizes this customer handoff, highlights missing information, and lets me approve it, request changes, or add a note for the implementation team.` ## What to expect * Widgets appear inside the Agent message and adapt to the available chat width. * A submitted Widget should leave a short receipt of what you sent. Larger submissions may provide a way to reopen the submitted details. * If the Agent is already responding, a Widget submission may wait until the current response finishes before it is sent. * Some Widgets are temporary and reset when the chat reloads. Review and approval Widgets can be designed to remember progress for people who can edit the chat. * Widgets run in an isolated environment and cannot freely access your browser, account, or external websites. > **Advanced: reusable Widgets from Skills** > > A [Skill](/skills/overview) can include a reusable Widget that follows the > same structure each time. The Agent can adapt it to the current task and show > it directly in chat. > > This is useful for standardized calculators, intake forms, comparison tools, > review queues, and interactive explainers. The Skill can provide the structure > while the Agent adapts the content to the current conversation. ## Next steps > **[Artifacts](/agents/capabilities/artifacts)** > > Build a persistent, versioned dashboard, report, calculator, or prototype. > **[Chat with an Agent](/guides/chatting-with-an-agent)** > > Learn how to use files, voice mode, and other chat features. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.