> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/build/ways-of-building-workflows/chat-hub.md).

# Chat Hub

## Overview <a href="#overview" id="overview"></a>

Chat Hub is a centralized AI chat interface where you can access multiple AI models, interact with n8n agents, and create your own agents. Chat Hub also introduces Chat user, a role that lets users interact with the chat interface without accessing n8n workflows.

## How to use <a href="#how-to-use" id="how-to-use"></a>

To use Chat Hub, find the **Chat** option in the navigation bar, select a model, and start a conversation.

### Creating simple personal agents <a href="#creating-simple-personal-agents" id="creating-simple-personal-agents"></a>

To make AI more reliable for simple, repetitive tasks, you can create Custom Agents with custom instructions. To create a simple personal agent:

1. Click on **Personal Agents** and then **+New Agent**.
2. Define the name, description, system prompt, preferred model, and access to tools.
3. Select **Save**.

Once created, you can select the personal agent from the model selector.

### Using n8n workflows agents <a href="#using-n8n-workflows-agents" id="using-n8n-workflows-agents"></a>

For more complex scenarios, use n8n workflow agents (built by you or your colleagues) to make your workflows available in Chat Hub. Right now, you can only use workflows that have a **Chat Trigger** with streaming enabled in the **Agent** node. To make your workflow available:

1. Open your selected workflow.
2. Open the **Chat Trigger**.<br>

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Only chat triggers of the newest version will work. To get the newest chat trigger version, delete your existing chat trigger and insert a new one.</p></div>
3. Enable the **Make Available in n8n Chat** option and set the name and description of the personal agent.
4. Make sure that your AI Agent node has the **Enable Streaming** option enabled.
5. Activate your workflow.

Once defined, you can select your workflow from the model selector in Chat Hub. Your colleagues need access to the workflow by sharing it or having it in a project where they have at least viewer access.

## Managing permissions <a href="#managing-permissions" id="managing-permissions"></a>

You can define which users can perform which actions through n8n's role system. Chat Hub also gives you more ways to control who uses what.

### Chat user role <a href="#chat-user-role" id="chat-user-role"></a>

The Chat user is a role for people in your organization who want to use workflows without building them. Chat users only see the chat interface and can't add credentials or workflows by default.

Chat users are only available on Starter, Pro, Business and Enterprise plans.

### Provider settings <a href="#provider-settings" id="provider-settings"></a>

Admins can control which models and providers users can access in Chat Hub. This includes:

* Enabling or disabling specific models and providers
* Preventing users from adding their own models
* Setting default credentials for each provider
* Restricting users from adding their own credentials (through n8n's permission system)

To manage these settings, go to **Settings > Chat** and edit the providers.

## Considerations and limitations <a href="#considerations-and-limitations" id="considerations-and-limitations"></a>

1. You can't add file knowledge when creating simple personal agents.
2. Tool selection is limited to a few options.
3. Only workflows with [Chat Trigger node](broken://spaces/BKcbOzIWja8NfqKDcqHc/pages/ufgV9cVbZYhO7UuKUvU1) and streaming-enabled [AI Agent node](/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent.md) work as workflow agents. Your workflows must meet specific requirements.


---

# 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.n8n.io/build/ways-of-building-workflows/chat-hub.md?ask=<question>&goal=<endgoal>
```

`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.