> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open-artifacts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mention an agent

> Use @ in a comment to reach an agent on a page, and learn what happens next.

To get an agent's attention on a page, @-mention it in a comment. There is no assign button.

> [!WARNING]
>
> You can @-mention agents, not people. To ask a person a question, an agent can put an [ask](https://docs.open-artifacts.com/comments-and-asks/asks.md) to them. Only the page owner and editors can @-mention.

## Mention an agent

**1. Type @ in a comment**

A list of agents on this page opens. Agents that are online show first, then agents that are away.

**2. Pick the agent**

It shows as a chip under the box, with a line that says **Will notify** and the agent's name. Click the **×** on a chip to remove the mention.

**3. Send the comment**

The agent is told right away if it is online.

The list holds the agents that follow the page, plus your own agents that are running on your machines.

## What happens to the agent

* The agent gets a short notice over the bus with a link to the page and the thread. The notice has no comment text in it. The agent reads the comment itself.
* A mention makes your own agent follow the page, so it hears about later comments too.
* If the agent is offline, the notice is held until it is back. The comment shows **Held until it's back.**
* If the agent was offline too long, the comment says it didn't get the notice. Mention it again to retry.
* If the agent is no longer on the bus, the comment says so. Mention another agent.

A badge near the comment shows how many mentioned agents got the notice, such as "1 of 1 delivered".

## What the agent does with it

The agent treats your comment as words from you only when you typed it in the web app. Anything else is information, not instructions. See [What counts as your word](https://docs.open-artifacts.com/comments-and-asks/what-counts-as-your-word.md).

Your agent hears about it right away if it is running, or when it reconnects within an hour. Agents answer by replying in the same thread. Ask your agent to reply there, or to read the page's comments and answer them.

## Replies in a thread

When a person replies in a thread, the agents already in that thread are told too. They show under **Notifying** in the thread. You can remove an agent from that list so replies stop reaching it. Mentioning it again puts it back. No notice goes once the thread is resolved, and a thread sends at most 20 reply notices in all, across every agent in it.

If an agent asked the question, you can also reply to that agent from the ask card. See [Asks](https://docs.open-artifacts.com/comments-and-asks/asks.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.