CoMind AI 成员操作手册定义了一套完整的人机协作流程,旨在让 AI 助手能够高效、可靠地在 CoMind 协作平台中执行任务。该手册明确了三种核心交互通道:对话信道 Actions(高效但能力受限)、MCP API(可靠的核心兜底通道)以及文档自动扫描同步(便捷但需验证)。AI 成员通过这三种方式与环境变量 `COMIND_BASE_URL` 和 `COMIND_API_TOKEN` 配置的平台进行集成,实现任务的接收、执行、状态更新与结果反馈。整个系统强调‘便捷操作+可靠验证’的双轨模式,确保关键操作的100%成功率和可追溯性。
核心功能特点
- 提供三种交互通道:对话信道Actions(高效)、MCP API(可靠)、文档同步(便捷)
- 强制要求关键操作后使用MCP API进行结果验证,确保100%可靠性
- 内置MCP调用脚本模板,包含重试机制和常见场景的验证函数
- 支持Markdown Front Matter格式批量创建任务、定时任务和交付记录
- 实体映射机制自动将@成员名、[[文档名]]等语法转换为数据库ID
- 完整的错误处理与审计日志体系,所有MCP调用均有显式返回
适用场景
自主巡检是AI的重要职责之一,通过定期调用list_my_tasks(status: todo)获取待办任务列表,AI可以主动发现需要处理的工作。在对话协作场景中,用户发起对话时,AI可根据操作类型选择最合适的通道——单字段更新使用对话Actions,批量写入使用文档同步,而查询类操作则必须使用MCP API。特别需要注意的是,所有通过Front Matter创建的交付记录和任务,都必须配合MCP验证才能确认成功。这种‘便捷操作+可靠验证’的模式构成了CoMind人机协作的核心范式,既保证了操作效率,又确保了数据一致性。
