# Personal and Shared Agents

> Part of the NocoDB documentation (Agents). Index of all pages: https://nocodb.com/llms.txt. Any docs page is available as Markdown by adding `.md` to its URL.

URL: https://nocodb.com/docs/agents/personal-agents
Last updated: 2026-11-07

A personal AI agent in NocoDB works as you: only you see it and its runs, and it uses your access in the project, or less. Shared agents have their own identity.

Every NocoDB agent is either **Personal** or **Shared**. A personal agent works as you: only you see it and its runs, and it acts with your access in the project, or less. A shared agent has its own identity and role, and everyone in the project can use it.

|                       | Personal agent                       | Shared agent                                                     |
| --------------------- | ------------------------------------ | ---------------------------------------------------------------- |
| **Who sees it**       | Only you.                            | Everyone in the project.                                         |
| **Who it acts as**    | You, at your role or lower.          | Itself, at its own project role.                                 |
| **Who can create it** | **Editor** and above                 | **Creator** and above                                            |
| **Results go to**     | The chat, or your email.             | The chat, an email, or a Slack channel.                          |
| **Channels**          | Not available.                       | Slack, Telegram and the other [channels](/docs/agents/channels). |
| **Plan limit**        | Outside the agent limit of the plan. | Counts towards the agent limit of the plan.                      |

## Before you begin

* To create a personal agent, you need the **Editor** role or higher in the project.
* To create a shared agent, you need the **Creator** role or higher.

## Pick the type of an agent

1. Create an agent. See [Create an agent](/docs/agents/create-agent).
2. In the settings of the draft, open **Tools & access**.
3. Under **Type**, select **Personal agent** or **Shared agent**.

A new agent starts as shared when you have the **Creator** role or higher, and as personal otherwise. It also starts as personal when the workspace has reached the agent limit of its plan. An **Editor** cannot select **Shared agent**.

To make a draft personal, first set its results to the chat or email, and disconnect its channels.

<img alt="Type in Tools & access, with Personal agent selected" src={__img0} placeholder="blur" />

You can change the type only while the agent is a draft. After you turn the agent on, the type is fixed. To change it, duplicate the agent. The copy starts as a draft.

Coding agents are always shared.

## Set what a personal agent can do

A personal agent acts as you, so it never reaches further than you do. To lower it further, use **Works as you** in **Tools & access**:

| Option         | The agent acts as                             |
| -------------- | --------------------------------------------- |
| **Same as me** | Your role in the project, up to **Editor**.   |
| **Commenter**  | **Commenter**, also when your role is higher. |
| **Viewer**     | **Viewer**, also when your role is higher.    |

<img alt="Works as you in Tools & access, set to Same as me" src={__img1} placeholder="blur" />

The section shows the role that the agent has right now, for example **Right now it can act as Editor**. A personal agent never acts above **Editor**, also when you are a **Creator** or an **Owner**.

The role applies to every run, also to a run that a trigger starts when someone else changes a record. The run sees the record as you see it, and does not start if you cannot see it. Table permissions, field permissions and record-level security policies apply to the agent as they apply to you.

## Runs of a personal agent

A personal agent runs only for its owner:

* Only you see the agent, its settings and its sessions. An **Owner** of the project sees its name, but not its instructions or its runs.
* **Results go to** offers the chat and your email. A personal agent cannot post to Slack and has no channels.
* A [webhook trigger](/docs/agents/triggers#run-an-agent-from-a-webhook) of a personal agent accepts only your own API token.

## When you lose access to the project

A personal agent needs its owner to have access to the project. When the agent next tries to run and you no longer have access, NocoDB pauses it. The settings then show **Paused: you no longer had access to this project. Turn it back on to resume.** After you get access again, turn the agent on.

## See the personal agents of a project

Owners of a project see the personal agents that its members made, without their instructions or their runs:

1. In the mini sidebar, click **Settings**.
2. Go to **Personal agents**.

The list gives the name, owner, triggers, status, last run and creation date of each agent. An **Owner** can turn an agent off or delete it. The instructions and the runs of the agent stay private.

## Good to know

* A personal agent cannot run from a workflow, cannot go into a folder, and is not available in a sandbox.
* Duplicating a project leaves out its personal agents.
* A record that a personal agent changes shows you as the author, with **via** and the name of the agent, in the record history and the [audit log](/docs/product/workspaces/workspace-audit). Members who cannot see the agent read **via an agent**.

## Availability

* Personal agents are available wherever agents are. See [Availability](/docs/agents#availability).

## Related

* [Create an agent](/docs/agents/create-agent)
* [Tools and access](/docs/agents/tools-and-access)
* [Roles and permissions](/docs/agents/permissions)
* [Triggers and results](/docs/agents/triggers)

---

## Related pages

- [Agents](https://nocodb.com/docs/agents.md): NocoDB agents are AI agents that work in a project: they read and change your tables, documents and code, answer in chat, and run on their own on a trigger.
- [AI Agents](https://nocodb.com/docs/agents/ai-agents.md): NocoDB is a no-code AI agent builder for business: AI agents that work on your tables and documents, answer in chat, and run agentic workflows on triggers.
- [Create an AI Agent](https://nocodb.com/docs/agents/create-agent.md): How to create an AI agent in NocoDB: describe the job in a setup chat or pick a template, then review and turn it on. NocoAI can also build it.
- [AI Agent Use Cases and Templates](https://nocodb.com/docs/agents/use-cases.md): AI agent use cases and examples for sales, customer service, marketing, operations and project management: 13 NocoDB templates to start from.
- [Instructions and Files](https://nocodb.com/docs/agents/instructions.md): Write the instructions of a NocoDB agent as a brief for a teammate, mention tables and documents with @, and attach files that the agent reads on every run.
- [Tools and Access](https://nocodb.com/docs/agents/tools-and-access.md): Set the AI agent tools of a NocoDB agent: what it can read and change in tables, records, documents and the web, its project role and its managed machine.
- [AI Agent Skills](https://nocodb.com/docs/agents/skills.md): Turn on AI agent skills in NocoDB: reusable instructions from the project, workspace or organization catalog that an agent loads when a task needs them.
- [Triggers and Results](https://nocodb.com/docs/agents/triggers.md): Build an AI agent workflow in NocoDB with triggers: a schedule, record changes, comments, forms or webhooks. Send the results to chat, email or Slack.
