必须将本地文档接入workbuddy协作空间并启用全局ai上下文继承，再配置agent响应文件变更或手动调用，最后设置成员与agent混合编辑权限，才能实现人机实时协同。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让同事和Agent在WorkBuddy中围绕同一份本地文档实时协同——比如一边人工修订Word报告，一边让DataFetcher自动补全数据表格、ReportWriter同步更新分析段落——必须打破“人用文档、AI另起对话”的割裂状态，把文件变成协作原点。
将本地文档接入WorkBuddy协作空间
1、在Windows资源管理器或macOS访达中，右键点击目标文档（支持Word、Excel、PDF、Markdown等）→ 选择“用WorkBuddy打开”。
2、文档将在左侧独立窗口加载，右侧同步唤出AI对话区；此时文档已绑定当前工作区上下文，而非个人会话。
3、点击右上角“加入空间”按钮 → 从下拉列表中选择已创建的团队项目空间（如“Q3产品方案组”），确认加入。【未加入空间的文档无法触发跨成员Agent协作】
为文档启用全局AI上下文继承
1、进入该文档所在项目空间 → 点击左上角“工作区设置”齿轮图标。
2、切换至“AI协作”标签页 → 开启“启用工作区全局上下文”。
3、关键一步：勾选下方“将当前打开的文档路径注入上下文变量”，系统自动生成变量名active_doc_path。
这步做完，所有成员和Agent在该空间内发起的AI操作，都会默认读取这份文档的实时内容与位置，而不是各自上传副本。
配置Agent响应文档变更事件
方法一：基于文件事件自动触发
1、进入【流程编排中心】→ 新建流程 → 模板选“文件变更监听”。
2、在触发器配置中，点击“选择监控文件”，定位到刚接入的文档路径（如/Q3方案/主报告.docx）。
3、添加动作节点：选择DataFetcher Agent → 在其前置脚本中填入：read_file("${active_doc_path}")。
4、保存发布后，只要有人编辑并保存该文档，DataFetcher就会自动拉取最新版内容执行后续任务。
方法二：手动调用Agent处理当前文档
1、在文档右侧AI对话区输入：“请用ReportWriter分析当前文档第三页的销售数据表格，并生成趋势解读”。
2、系统自动识别active_doc_path变量，将文档内容切片后传入ReportWriter。
3、ReportWriter输出结果可直接插入光标位置，或点击“插入为评论”供同事审阅——评论会锚定到具体段落，不破坏原文结构。
设置成员与Agent的混合编辑权限
第一步：确认文档权限层级
1、在项目空间内打开该文档 → 点击右上角“共享设置”。
2、检查“编辑权限”是否设为“本空间全部成员+指定Agent”，而非仅限“当前用户”。【若此处为“仅我可编辑”，同事和Agent的所有修改请求都会被静默拒绝】
第二步：为Agent分配文档操作令牌
1、回到【Agent管理】→ 编辑DataFetcher → 在“工具权限”中勾选“读取当前工作区文档”和“写入注释到协作文档”。
2、保存后，该Agent即可在文档任意位置添加带时间戳的AI评论，同事点击即可展开查看推理过程或一键采纳修改。
