4. 用户指南

User Guide 面向 FlowNex 的普通使用者，说明如何通过对话、任务、Skill、知识库和文件能力完成日常工作。

普通用户通常不需要理解底层服务模块，但需要知道：

  1. 如何发起任务。
  2. 如何选择或使用 Skill。
  3. 如何让 Agent 使用知识库。
  4. 如何上传和获取文件。
  5. 如何查看执行过程。
  6. 如何反馈结果质量。

4.1 对话与任务

用户可以通过 Web 客户端、飞书 / Lark 或其他接入渠道向 Agent 发起对话。

一次对话输入会被系统建模为一条消息和一个任务。用户看到的是自然语言交互，系统内部会记录完整任务过程。

常见输入包括：

帮我总结这份文档。
帮我基于附件生成一份会议纪要。
帮我查询公司报销制度。
帮我根据这个项目资料写一份交付方案。
帮我分析这张销售数据表，并输出图表和结论。

任务运行过程中，用户可以看到：

  1. Agent 是否开始执行。
  2. 当前是否正在读取文件。
  3. 当前是否正在检索知识库。
  4. 当前是否调用工具。
  5. 当前是否生成文件。
  6. 最终回答和交付文件。

如果任务失败，系统应返回尽可能明确的失败原因，例如知识库不可用、文件格式不支持、工具调用失败、权限不足或模型输出异常。

4.2 技能市场与我的技能

技能市场用于展示当前用户可安装或可使用的 Skill。

用户可以在技能市场中查看：

  1. Skill 名称。
  2. Skill 描述。
  3. 适用场景。
  4. 所属分类。
  5. 作者或维护团队。
  6. 是否已安装。
  7. 是否需要额外知识库或工具权限。

用户安装 Skill 后，该 Skill 会进入“我的技能”。后续用户在对话中可以显式选择该 Skill，或让系统根据任务意图自动推荐。

例如：

使用「项目周报生成」技能，帮我根据这些会议纪要生成本周项目周报。

用户需要理解的是：

  1. Skill 不是固定按钮，而是一组可复用任务方法。
  2. 安装 Skill 表示用户获得了该能力的使用入口。
  3. 真正运行时是否能成功，还取决于本轮 Tool、知识库和文件权限。

4.3 知识库选择与引用

知识库用于提供企业内部资料依据。

用户可以在发起任务时选择知识库范围，也可以使用系统默认知识范围。

适合使用知识库的任务包括：

  1. 制度问答。
  2. SOP 查询。
  3. 项目资料总结。
  4. 基于模板生成文档。
  5. 基于历史案例输出建议。
  6. 产品能力和报价规则查询。

用户选择知识库后，系统仍会进行权限校验。用户无权限的知识库不会进入本轮检索范围。

如果本轮回答使用了知识库，结果中应尽量展示引用来源，例如：

依据《差旅报销制度》第 2.1 节，员工出差前需要完成审批流程。

如果知识库没有召回结果，Agent 应说明当前没有找到足够依据，并避免把不确定内容伪装成制度或事实。

4.4 文件上传、生成与恢复

用户可以在对话中上传文件，例如：

  1. Word 文档。
  2. PDF。
  3. Excel 表格。
  4. 图片。
  5. Markdown。
  6. 文本文件。
  7. 数据文件。

Agent 可以读取这些文件，并基于文件内容完成总结、分析、转换、生成报告等任务。

当前文件通常经过 OSS 或运行时文件恢复机制进入任务上下文。后续 AGFS 接入后，文件会进入标准 workspace，并具备更强能力：

  1. 文件可跨轮继续使用。
  2. 文件可被多个 Agent 共享。
  3. 文件有版本历史。
  4. 文件可通过 checkpoint 回滚。
  5. 文件产物可沉淀为知识候选。

用户在任务结束后可以查看 Agent 生成的文件，例如报告、表格、图片、PPT 或结构化数据。

4.5 定时任务与自动化

FlowNex 支持定时任务和自动化任务。

典型场景包括：

  1. 每天生成日报。
  2. 每周生成项目周报。
  3. 定时汇总飞书群消息。
  4. 定时检查业务指标。
  5. 定时生成运营报告。

定时任务通常需要配置：

  1. 任务名称。
  2. 触发周期。
  3. 默认 Skill。
  4. 默认 Tool。
  5. 默认知识库范围。
  6. 输出渠道。
  7. 失败通知策略。

定时任务执行后，也会形成普通任务记录，因此可以查看执行过程、结果文件、错误信息和历史记录。

4.6 飞书 / Lark 渠道接入

FlowNex 可以通过飞书 / Lark 渠道触发 Agent。

用户可以在飞书中：

  1. 私聊 Agent。
  2. 在群聊中提及 Agent。
  3. 上传附件让 Agent 处理。
  4. 触发审批、日历、任务、文档相关操作。
  5. 接收 Agent 生成的结果。

渠道接入时需要注意：

  1. 飞书用户身份需要映射到 FlowNex 用户身份。
  2. 飞书附件需要进入运行时可读文件范围。
  3. 飞书 API 调用需要用户或应用授权。
  4. 群聊场景要避免越权读取其他人的上下文。
  5. 输出结果需要符合渠道消息格式限制。

4.7 用户反馈与任务评价

用户可以对 Agent 回复进行点赞、点踩或补充反馈。

用户反馈的价值不只是评价体验，也会成为后续能力演进输入。

反馈可以用于：

  1. 识别 badcase。
  2. 判断知识召回是否准确。
  3. 判断 Skill 是否适用。
  4. 判断输出格式是否符合预期。
  5. 生成评测样本。
  6. 沉淀 runtime reminder 或 Skill 改进建议。

为了避免错误经验污染系统，用户反馈不会直接修改公共 Skill 或知识库，而是进入可审计的经验候选流程。