提及

提及（Mentions）是块（blocks）在整个工作区中相互引用的方式。在任何富文本界面（文档、电子邮件正文、频道消息、代理提示词或例程提示词，或任务描述）中输入 @，都会打开一个自动补全菜单，让你可以引用 Macro 中的其他内容。无论你选择什么，都会渲染为一个实时内联胶囊，并携带其目标对象的当前元数据（例如，任务提及会显示任务的状态和优先级），并且该引用会作为反向链接记录在目标对象的引用面板中。

代理中的提及¶

向 AI 代理提及实体时，会插入一个指针，以便 AI 能够阅读文档。对于 markdown 文档，代理还可以读取文档中嵌入的图片。你的代理会继承你所拥有的权限。如果你尝试给代理一个你自己没有访问权限的文档/实体，那么你的代理也不会有访问权限，并且你的代理会明确告诉你这一点。

你并不_需要_向代理提及实体。由于你的代理可以访问搜索工具和列表工具，它可以自行在工作区中找到所需内容。当你已经知道代理应该查看什么时，我们建议你提及相应实体。这样可以省去一轮搜索，并确保获得正确的上下文。

频道中的提及¶

使用 Macro 而非 Slack 的主要好处在于，它与工作区的其余部分深度关联。只需提及任何实体类型并按下回车，即可插入一个 @mention。当你按下回车或点击发送按钮时，该内容会与频道成员共享。这避免了 Slack+Notion、Slack+Drive 等组合中可能出现的隐患——在那里你没有授予权限，人们不得不问“嘿，你能把__分享给我吗？”

当有人被添加或移出频道时，共享内容的权限也会相应流转。 当有人加入或离开你的公司时，这非常有用，因为他们已经可以访问所需的一切。这就是为什么我们建议每个团队都使用频道，这样你团队所需的所有实体的权限都会被自动处理。

当你在频道中提及一份文档或文件时，会创建一个双向链接，这样你始终可以追溯某个内容是在哪里被讨论的。例如，在我们的“8 个月路线图文档”上，团队成员可以看到这份文档已被其他几份文档、一个画布以及 #engineers 频道提及，而我还可以看到它在我与 Teo 和 Nick 的私信中被提及（除非其他团队成员也在那个频道中，否则他们看不到最后这一条）。

电子邮件中的提及¶

提及某人会将他们添加到电子邮件线程的抄送（cc）中。

在电子邮件中 @提及一份文档或文件，会将其设置为拥有链接的任何人仅可查看，并显示确认信息。如果你无法更改文件的共享设置，Macro 会显示一个警告，提示收件人可能没有访问权限。在其他电子邮件客户端中，@提及会显示为普通超链接。

文档中的提及¶

在文档中提及文档，是工作区相互联结的基本方式之一，对于使用过 Notion、Coda 和 Obsidian 等产品的用户来说并不陌生。

画布中的提及¶

使用画布可以在二维平面上嵌入其他实体。这对于思维导图、链接到任务的技术图表、项目管理，或者只是以可视化方式存储/归类文件都非常有用。

当你提及……时会发生什么¶

• 人员：如果你在评论或频道中按姓名或电子邮件提及某人，即使他们不是 Macro 用户，他们也会收到通知。另一方面，如果你在任务正文或 markdown 文档中提及他们，他们_不会_收到通知。如果你希望他们收到通知，你需要手动共享该内容。我们知道这个设计决策有点奇怪；我们在内部试用（dogfooding）一段时间后做出这一决定的原因是，任何时候你想在文档中 @提及某人，从定义上讲你还没有写完这份文档，所以你还不希望他们收到通知。至于他们_应该_何时收到通知并不明确，因此我们认为，在文档语境下的提及既不会通知被提及的用户，也不会与之共享内容，这是最佳做法。
• 文档和块：在频道的语境中，文档会被共享。在评论或文档中，则不会共享。
• 联系人和公司记录：被提及时不会被共享。它们的共享权限由团队决定。
• 频道、线程或特定消息：提及频道不会授予权限，提及消息也不会。无法将某条消息分享给不在该频道中的人，因为查看消息的能力由频道成员身份决定。如果你需要在不将某人加入频道的情况下分享一条消息，可以发送截图。要将某人加入频道，不要提及该频道——而是进入频道并将他们添加为参与者。
• 日期：从日期选择器中选择一个日期会插入一个日期引用（适用于截止日期、日程安排和筛选）。日期不会通知或共享任何内容。

在文档或聊天中，提及（mention）是一个可导航的链接，也是上下文的来源。在邮件正文中，它会产生副作用：提及某人会将其添加到抄送（CC）。提及文档会插入一个链接_并_使其对拥有该链接的任何人都可见，以便接收者可以打开它。

在频道中，除了普通的提及之外，还有两种特殊的提及：@here 会通知所有参与者，@Macro 会内联调用智能体。

智能体非常依赖提及：你@到聊天中的任何内容都会被作为上下文引入。