# 📖 天工智能体平台 — 用户使用手册 > **User Manual** — 面向终端用户的完整操作指南 本文档涵盖天工智能体平台全部核心功能的使用说明，适合所有用户阅读。 --- ## 一、平台概览 天工智能体平台是一个 AI Agent 搭建与工作流编排平台，支持： - **可视化工作流设计**：拖拽节点，连线编排，无需编码 - **智能 Agent 创建**：配置 LLM + 工具 + 记忆，打造专属数字员工 - **知识库 RAG**：上传文档，智能检索增强回答 - **飞书 Bot 集成**：6 个飞书 Bot 实时交互 - **模板市场**：11 个行业模板一键创建 Agent ### 浏览器要求 | 浏览器 | 版本 | |--------|------| | Chrome | 90+ | | Edge | 90+ | | Firefox | 88+ | | Safari | 14+ | --- ## 二、快速入门 ### 2.1 登录 1. 访问前端地址（默认 `http://localhost:8038`） 2. 输入默认账号：`admin` / `123456` 3. 登录后进入主控台 ### 2.2 界面导览 ``` ┌──────────────────────────────────────────────────┐ │ 侧边栏 │ 主内容区 │ │ ├ 主控台 │ │ │ ├ Agent 管理 │ (根据左侧菜单显示对应页面) │ │ ├ 工作流管理 │ │ │ ├ 知识库 │ │ │ ├ 执行记录 │ │ │ ├ 模板市场 │ │ │ ├ 监控告警 │ │ │ ├ 系统日志 │ │ │ └ 用户设置 │ │ └──────────────────────────────────────────────────┘ ``` ### 2.3 创建第一个 Agent（5 分钟体验） **方式一：模板市场一键创建（推荐）** 1. 进入「模板市场」 2. 选择一个模板（如"智能客服"） 3. 点击「一键创建 Agent」 4. 系统自动生成 Agent 和工作流，立即可用 **方式二：从零开始** 1. 进入「Agent 管理」→ 点击「新建 Agent」 2. 填写：名称、描述、选择 LLM 模型 3. 进入工作流设计器，拖拽节点搭建流程 4. 点击「部署」发布 --- ## 三、Agent 管理 ### 3.1 Agent 列表 进入「Agent 管理」，查看所有已创建的 Agent： | 信息 | 说明 | |------|------| | 名称 | Agent 唯一标识 | | 状态 | 草稿 / 已发布 / 运行中 / 已停止 | | 模型 | 使用的 LLM（GPT-4o / DeepSeek / Claude 等） | | 创建时间 | 首次创建日期 | | 操作 | 编辑 / 使用 / 部署 / 停止 / 删除 | ### 3.2 创建 Agent 点击「新建 Agent」，配置以下参数： **基础设置** - **名称**：给 Agent 一个有意义的名称 - **描述**：说明 Agent 的用途和能力（影响路由决策） - **头像**：可选上传 **模型配置** - **LLM 模型**：选择底层大模型（GPT-4o / DeepSeek-V3 / Claude Opus 等） - **Temperature**：控制输出随机性（0=精确, 1=创意） - **Max Tokens**：单次最大输出长度 - **系统提示词**：定义 Agent 的角色和行为规范 **工具配置** - **启用工具**：勾选 Agent 可调用的工具（如 file_write、web_search、http_request 等） - **需审批工具**：默认包含 11 个危险工具（deploy_push、send_email、git_push 等），执行前需人工审批 **高级设置** - **启用记忆**：开启后 Agent 在对话间保持上下文 - **记忆范围**：个人 / 团队 - **定时任务**：设置 Agent 自动执行的 Cron 表达式 - **回退模型**：当主模型不可用时自动切换备选模型 ### 3.3 部署与使用 1. 在工作流设计器完成编排后，点击「部署」 2. 状态变为「已发布」，出现「使用」按钮 3. 点击「使用」进入对话界面 4. 在聊天框输入需求，Agent 自动执行工作流并返回结果 ### 3.4 状态说明 | 状态 | 说明 | 可执行 | |------|------|:------:| | 草稿 (draft) | 编辑中，尚未部署 | 仅所有者可测试 | | 已发布 (published) | 已部署，可对外使用 | ✅ | | 运行中 (running) | 正在执行任务 | ✅ | | 已停止 (stopped) | 手动停止 | ❌ | --- ## 四、工作流设计器 ### 4.1 界面布局 ``` ┌─────────────────────────────────────────────────┐ │ 工具栏：[添加节点] [撤销] [重做] [缩放] [保存] │ ├──────────────────────┬──────────────────────────┤ │ 画布区 │ 节点配置面板（右侧） │ │ │ │ │ ┌───┐ ┌───┐ │ 选中节点后显示配置项： │ │ │触发│──→│LLM│ │ - 提示词模板 │ │ └───┘ └───┘ │ - 工具选择 │ │ │ │ - 输出处理 │ │ ↓ │ - 重试策略 │ │ ┌───┐ │ │ │ │输出│ │ │ │ └───┘ │ │ └──────────────────────┴──────────────────────────┘ ``` ### 4.2 节点类型 | 节点类型 | 图标 | 功能说明 | |----------|:----:|----------| | 触发器 (trigger) | ▶️ | 工作流入口，接收用户输入 | | LLM 节点 | 🧠 | 调用大模型进行推理/生成 | | 工具节点 | 🔧 | 调用特定工具执行操作 | | 条件分支 | 🔀 | 根据条件走不同分支 | | 循环节点 | 🔄 | 遍历数组或重复执行 | | 子工作流 | 📦 | 嵌套调用另一个工作流 | | 评估器 | ✅ | 输出质量验证，不合格可路由回源头 | | 编排器 | 🎯 | 多 Agent 编排（串行/并行/辩论/流水线/DAG） | | 输出节点 | 📤 | 工作流终点，整理最终输出 | ### 4.3 常用操作 | 操作 | 快捷键 / 方式 | |------|--------------| | 添加节点 | 从左侧面板拖拽 或 右键画布 | | 连接节点 | 从节点输出端拖线到目标输入端 | | 删除连线 | 选中连线按 Delete | | 移动画布 | 鼠标中键拖拽 或 空格+拖拽 | | 缩放画布 | Ctrl + 滚轮 | | 保存 | Ctrl + S | | 撤销 | Ctrl + Z | | 重做 | Ctrl + Shift + Z | ### 4.4 节点配置详解 **LLM 节点** - **系统提示词**：定义 LLM 的角色（必填） - **用户提示词模板**：用 `{{变量名}}` 引用上游输出 - **Temperature**：可覆盖 Agent 级设置 - **输出格式**：纯文本 / JSON / Markdown **工具节点** - **选择工具**：从 56 个内置工具中选择 - **参数绑定**：将上游输出映射到工具参数 - **超时时间**：工具执行最大等待时间（秒） **条件分支** - **条件表达式**：支持 Jinja2 模板语法 - **多分支**：可配置多个条件路径 - **默认分支**：无匹配时的兜底路径 **重试配置**（所有节点通用） - **最大重试次数**：失败后重试 N 次 - **重试间隔**：每次重试的等待秒数 - **错误处理**：retry（重试）/ notify（通知）/ stop（停止） --- ## 五、知识库 ### 5.1 上传文档 1. 进入「知识库」→ 点击「上传文档」 2. 支持格式：PDF、TXT、Markdown、Word、Excel、HTML 3. 上传后自动切片并生成向量嵌入 4. 可在 Agent 配置中关联知识库 ### 5.2 知识检索 - Agent 在执行任务时自动检索关联知识库 - 检索方式：语义相似度匹配 - 知识进化：Celery 定时任务每小时自动从对话中提取新知识入库 ### 5.3 知识仪表盘 - **文档数量**：总文档数及增长趋势 - **知识条目**：自动提取的知识点数量 - **引用次数**：知识被 Agent 检索的次数排行 - **类别分布**：知识按类别统计 --- ## 六、模板市场 ### 6.1 浏览模板 进入「模板市场」查看 11 个行业模板： | 模板名称 | 适用场景 | |----------|----------| | 智能客服 | 自动回答客户问题，支持知识库 RAG | | 研发日报 | 自动汇总 Git 提交，生成日报 | | PR Review | 自动审查代码 PR，给出改进建议 | | 面试调度 | 自动安排面试时间，发送通知 | | 竞品监控 | 定期抓取竞品信息，生成分析报告 | | 测试报告 | 分析测试结果，生成质量报告 | | 入职引导 | 新员工问答助手，帮助快速上手 | | 风险预警 | 监控数据异常，自动告警 | ### 6.2 使用模板 1. 浏览模板详情（功能说明、工作流预览） 2. 可自定义参数：名称、Temperature、启用的工具 3. 点击「一键创建」→ 自动生成 Agent + 工作流 4. 进入工作流设计器微调（如需） --- ## 七、对话与协作 ### 7.1 Agent Chat 在 Agent 设计器右侧面板直接对话： - **文本输入**：输入需求，Enter 发送，Shift+Enter 换行 - **实时响应**：Agent 逐步执行工作流，实时显示进度 - **多轮对话**：Agent 保持上下文，支持追问 - **语音输入**：移动端支持语音输入（点击麦克风图标） - **语音播报**：Agent 回复支持 TTS 朗读 ### 7.2 飞书 Bot 平台提供 6 个飞书 Bot，在飞书中直接与 Agent 对话： - **天工**：主力 Bot - **橙子**：辅助 Bot - **苏瑶**：指定场景 Bot - **甜甜（苏瑶3号）**：扩展场景 Bot - **灵犀**：学习助手 - **人参果**：AI 学习助手（KG+RAG 版） 配置方式参见《飞书智能体配置手册》。 ### 7.3 移动端 访问 `/mobile-chat` 路径可使用移动端优化版聊天界面，支持： - 响应式布局，适配手机屏幕 - 语音输入/播报 - PWA 安装到桌面 - 浏览器推送通知 --- ## 八、执行与监控 ### 8.1 执行记录 进入「执行记录」→ 查看所有 Agent/工作流的执行历史： - **状态**：运行中 / 已完成 / 失败 - **耗时**：总执行时间 - **节点详情**：每个节点的输入/输出/耗时 - **错误信息**：失败原因及堆栈 ### 8.2 监控面板 进入「监控告警」→ 查看系统运行状态： - **请求量**：API 调用统计 - **错误率**：失败占比 - **响应时间**：平均/ P50 / P99 延迟 - **Agent 活跃度**：各 Agent 使用频率 ### 8.3 告警规则 进入「告警规则」→ 配置告警条件： - **指标**：错误率、响应时间、执行失败次数 - **阈值**：超过多少触发告警 - **通知方式**：站内通知 / 飞书消息 - **静默期**：重复告警的最小间隔 --- ## 九、用户设置 ### 9.1 个人资料 - 修改用户名、邮箱 - 修改密码 - 上传头像 ### 9.2 API Key 管理 可在个人设置中配置自己的 LLM API Key（优先使用个人 Key，未配置时回退到系统全局 Key）。 ### 9.3 飞书绑定 进入「飞书绑定」→ 将平台账号与飞书账号关联，实现飞书内单点登录和使用。 --- ## 十、附录 ### A. 术语表 | 术语 | 说明 | |------|------| | Agent | 具备 LLM + 工具 + 记忆的 AI 智能体 | | 工作流 (Workflow) | 由多个节点组成的有向无环图 (DAG) | | 节点 (Node) | 工作流中的基本执行单元 | | RAG | 检索增强生成，从知识库中检索信息增强回答 | | LLM | 大语言模型（如 GPT-4、DeepSeek） | | HITL | 人在回路，危险操作需人工审批 | | Celery | 异步任务队列，负责 Agent/工作流执行 | | ReAct | Reasoning + Acting，Agent 的推理-行动循环 | ### B. 快捷键汇总 | 快捷键 | 功能 | |--------|------| | Ctrl + S | 保存工作流 | | Ctrl + Z | 撤销 | | Ctrl + Shift + Z | 重做 | | Ctrl + 滚轮 | 缩放画布 | | Delete | 删除选中节点/连线 | | Enter | 发送消息 | | Shift + Enter | 消息换行 | --- > 最后更新：2026-06-14 | 适用版本 v1.0+