Dokki Docs logo

消息与日历

消息与日历是围绕人员、智能体、MCP客户端和计划任务的协调层。

消息

打开工作区 → 消息,或使用AI面板/侧边栏中的对话列表与队友和智能体聊天。同一对话模型支持私信、群组对话、智能体对话和工作区频道。

一个对话可以是:

  • 与智能体的私信

  • 与另一个人的组织私信

  • 包含多人和智能体的群组对话

  • 工作区频道,其成员与工作区成员列表一致

个人对话限定在您的个人上下文中。用户间的聊天需要组织上下文,以便根据组织目录检查成员身份。

开始一个对话

使用新对话并从当前上下文选择用户或智能体。组织对话可以包含非访客组织成员和组织智能体。个人对话可以包含您自己的个人智能体。如果已存在与同一对象的私信,Dokki会复用该私信而不会创建重复项。

群组对话可以重命名、添加更多成员、静音、置顶或从对话菜单退出。置顶的对话会排在最近列表顶部。静音的对话不会计入未读标记。

在线程中工作

消息渲染紧凑的Markdown,包括列表、链接、代码和引用。提及已知成员时会高亮显示。编辑器支持@提及自动补全。

根消息可以有Slack风格的线程回复。线程回复保持在根消息摘要之后,不会改变主对话预览,因此旁支讨论不会干扰主流程。

消息分页加载,订阅Supabase实时插入,协调乐观发送与服务器回显,并在发送失败时显示重试/放弃控件。

聊天中的智能体

智能体可以作为对话成员参与。在与智能体的私信中,智能体会自动回复。在群组对话中,显式的@提及会激活指定的智能体;当普通群组中没有提及任何智能体时,Dokki可能会将消息路由到最合适的智能体。在工作区频道中,随意的闲聊不会唤醒智能体:它们只在被提及或当人类在智能体的人工介入问题的线程中回复时才会回应。

智能体回复经过正常的智能体运行队列,因此模型限制、组织模型白名单、智能体工具、记忆和工作区访问仍然适用。智能体之间的级联有深度限制,以防止失控循环。

计划的智能体任务也可以发布到对话中,计划消息携带元数据,以便UI显示它们来自计划。

工作区频道和MCP客户端

工作区频道是在工作区首次需要共享频道时惰性创建的。其成员与workspace_members镜像:一旦频道存在,添加或移除工作区成员会更新频道成员资格。

智能体和MCP客户端使用工作区频道进行人工介入协调、提醒和确认。当人类拥有的MCP客户端向频道发布消息时,Dokki会记录客户端元数据,以便UI显示哪个连接的客户端发送了消息。

日历

打开工作区 → 日历以按天查看智能体活动。日历是现有智能体数据的只读投影;它不会创建新的日历事件或同步外部日历。

日历显示两种类型的项目:

  • 运行 — 所选日期范围内的实际智能体运行,按状态着色,使失败和活跃工作突出显示。

  • 计划事件 — 从已启用但尚未运行的cron计划展开的未来事件。

API接受ISO格式的from/to窗口,强制最大100天范围,并最多返回1,000行运行数据。未来事件从每个已启用的计划在内存中展开,对于请求的范围,每个计划最多展开100个事件。

月份网格从星期一开始并保持稳定的六周布局。选择某一天查看该天的运行和计划事件。使用今天或上/下控件浏览月份。

每种界面的使用场景

当决策、审批、提醒或答案属于可读性对话时使用消息。当需要了解计划的智能体工作负载、发现故障或检查后台任务预计何时运行时使用日历。