Mention docs, conversations, files, and workflows with @
A mention adds a numbered chip with the item’s name above the message box, and a matching marker such as [1] into your message. It tells the agent exactly which doc, conversation, file, or workflow you mean, so you don’t have to describe where to find it.
Steps
Type @
In the message box, type @ at the start of a line or after a space. A picker opens with a list of sources on its left: All, Docs, Workflows, Files, Conversations, and Skills. Under Conversations are Working, Needs you, and Completed, each with how many conversations it holds. Conversations counts the ones that aren’t completed. On All, the conversations in your list on the left come first, those working or needing you at the top, then docs, workflows, and files. A search there looks through completed conversations too. In an empty message box, you can also select @ Files, workflows, and skills.


Search for the item
Keep typing after the @ to narrow the list, or type in the picker’s search field. On the Files tab, you can search by file name or by folder path.
Pick a source if the list is long
Select Docs, Workflows, Files, or Conversations to show only that kind. Conversations lists the same conversations as your list on the left, those working or needing you first, and a search there looks through completed ones too. Select Working, Needs you, or Completed to show only the conversations in it. For example, select Working to find the conversations an agent is working on now. The left and right arrow keys move through the sources in order.
Choose the item
Select it, or move to it with the up and down arrow keys and press Enter or Tab. Its chip appears above the message box, and its marker, such as [1], replaces what you typed after the @.
![The message box after choosing a doc, with its marker [1] in the sentence and its numbered chip above. Highlighted: The doc chip.](/help/shots/conversations/mention-docs-files-and-workflows/4-light.webp)
![The message box after choosing a doc, with its marker [1] in the sentence and its numbered chip above. Highlighted: The doc chip.](/help/shots/conversations/mention-docs-files-and-workflows/4-dark.webp)
Finish and send
Keep writing around the marker, then send the message as usual. Each marker becomes a link to its item.
Good to know
- Skills don’t get a marker: choosing one runs it with your message. See Run one of your agent’s skills.
- Docs are the documents you write in the Files area. Your message includes a link to each doc you mention, so the agent can open it. See Create a document.
- Conversations are the other conversations in this project. Enjoy tells the agent to read the conversation you mention before it continues, so you can pick up decisions or results from it without copying them over. Each one shows its agent and how many messages it has, and its status, such as Stopped or Failed, when the heading above it doesn’t already say. The conversation you’re writing in isn’t listed or counted.
- Drag a conversation in. On your computer or in the web app, you can also drag a conversation from the list onto the open conversation instead of typing @. While it’s over the conversation, Reference in this conversation appears. Let go to add its chip and marker, as if you had chosen it after @. You can’t drop in the conversation you’re writing in, or one you’ve already mentioned. Dragging a pinned conversation up or down changes the order of your pins, so pull it sideways to drag it in. To put it back, press Escape or let go anywhere else.
- Files are files in your project folder. The agent sees each file’s path in your project.
- Workflows are saved instructions. Each one shows the first line of its instructions, and on Workflows they’re listed under their collections. When you send, Enjoy adds the workflow’s instructions to your message, and the agent follows them. If you mention a workflow while starting a new conversation and it prefers an agent, the message box switches to that agent. See Add a workflow to a message.
- You can mention up to 8 docs, 8 conversations, 8 files, and 8 workflows in one message. Workflows marked Desktop review needed don’t appear in the picker.
- To remove a chip, select its X. Its marker is removed from your message too. If you delete a marker yourself, the item stays and goes at the end of your message. In an empty message box, Backspace removes the last chip.
- To close the picker without choosing anything, press Escape or select its X.
- A workflow’s instructions have the same picker, so a workflow can name what it needs every time it runs. See Mention docs, files, conversations, and skills in a workflow.
- In a sent message, hover over a chip to peek at what’s inside, and select it to open it. See Links, files, and images in replies.
- In the iPhone app, type @ or select the @ button to open Add context, with Files, Docs, Workflows, and Conversations tabs.
If something goes wrong
“More files are available. Refine your search.”
Your project has more matching files than the picker shows. Type more of the file name or its folder.
“No references found”
Nothing matches what you typed. Check the spelling, or type less of the name. On Docs, Workflows, Files, or Conversations, the message names that kind instead, such as “No files found”. On Working, Needs you, or Completed, it says there are none, such as “No working conversations”. Select All or Conversations to look through the rest.
The picker says “Up to 8 documents per message.”
You’ve already mentioned 8 docs in this message. Conversations, files, and workflows have the same limit, with “Up to 8 conversations per message.”, “Up to 8 files per message.”, or “Up to 8 workflows per message.” Send the message, then mention the rest in a follow-up.