> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/workflows/build/workflows-ai-assistant.md).

# Workflows AI Assistant

Use the Workflows AI Assistant to help build and debug Workflows.

The Workflows AI Assistant lets you build, update, and debug Workflows from a chat interface that sits alongside the workflow canvas.

When you open a Workflow, the AI chat panel appears on the left side of the editor. You can type questions or instructions directly into the chat to build, modify, or troubleshoot your Workflow. The workflow canvas updates in real time as the assistant makes changes.

You can collapse the chat panel to focus on the canvas, or expand it when you need help. The canvas stays visually anchored when you toggle the panel.

### Editing Workflows

You can ask the AI Assistant to make changes to your Workflow. For example, you could ask to:

* Add object tracking to a Workflow.
* Make your current Workflow run only if a classification model returns a certain result.
* Change the confidence threshold of a model used in a Workflow.

The AI Assistant will make changes directly on the canvas. Whether its saved changes go live depends on the Workflow's [publishing mode](#publishing-mode).

{% hint style="info" %}
Blocks created by the AI Assistant may not be fully configured. Click into any block to review and adjust its settings for your project needs.
{% endhint %}

### Publish and Use

The toolbar above the canvas has a publishing mode button, a save button, and "Use". What the save button does depends on the [publishing mode](#publishing-mode). In "Auto-Publish" mode, "Save" makes your edits live. In "Manual Publish" mode, "Save Draft" stores your edits without changing the live Workflow, and "Publish" makes them live after you confirm. "Use" opens the Cloud API details for the live Workflow: the Workflow ID, endpoint URL, API key, and code snippets you can copy.

If a save works but the publish fails, the toolbar shows "Publishing failed". Click "Retry Publishing" to publish the saved draft again.

"Use" stays disabled until you publish. For all the other ways to run a Workflow, see [Deploy a Workflow](https://docs.roboflow.com/workflows/deploy/deploy-a-workflow.md).

### Publishing Mode

Each Workflow has one of two publishing modes. They apply to edits by people and by the AI Assistant.

* "Auto-Publish": every save publishes. You need write access to the Workflow, but not permission to publish Workflows.
* "Manual Publish": saves stay drafts. A person with permission to publish Workflows must publish them. The AI Assistant can't publish them.

To pick a mode, click the mode button next to the save button. Choosing a mode does not publish or discard your draft. You need permission to publish Workflows to choose "Auto-Publish".

If no one has picked a mode, the Workflow uses "Manual Publish" when a device or a Cloud Streaming deployment uses it. Otherwise it uses the Workspace default. To change the default, go to Settings, then "Workflow Settings". Enterprise Workspaces start with "Manual Publish", and other Workspaces start with "Auto-Publish".

### Conversation History

The sidebar shows your full conversation history across all Workflows. Selecting a conversation loads the associated Workflow and chat context. You can start a new conversation for the same Workflow using the "New conversation" option.
