Files

renjianbo beff3fac8d fix: delete agent 500 error + dynamic personality + deployment guide

- Fix delete agent 500: clean up FK records (agent_llm_logs, permissions,
  schedules, executions, team_members) and unbind goals/tasks before delete
- Remove hardcoded personality templates in Android, replace with dynamic
  system prompt generation from name + description
- Set promptSectionsEnabled=false to bypass PromptComposer for personality
- Add Tencent Cloud Linux deployment guide (Docker Compose)
- Accumulated backend service updates, frontend UI fixes, Android app changes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-06-29 01:17:21 +08:00

12 KiB

Raw Blame History

📖 天工智能体平台 — 用户使用手册

User Manual — 面向终端用户的完整操作指南

本文档涵盖天工智能体平台全部核心功能的使用说明，适合所有用户阅读。

一、平台概览

天工智能体平台是一个 AI Agent 搭建与工作流编排平台，支持：

可视化工作流设计：拖拽节点，连线编排，无需编码
智能 Agent 创建：配置 LLM + 工具 + 记忆，打造专属数字员工
知识库 RAG：上传文档，智能检索增强回答
飞书 Bot 集成：6 个飞书 Bot 实时交互
模板市场：11 个行业模板一键创建 Agent

浏览器要求

浏览器	版本
Chrome	90+
Edge	90+
Firefox	88+
Safari	14+

二、快速入门

2.1 登录

访问前端地址（默认 http://localhost:8038）
输入默认账号：admin / 123456
登录后进入主控台

2.2 界面导览

┌──────────────────────────────────────────────────┐
│  侧边栏          │  主内容区                       │
│  ├ 主控台        │                                │
│  ├ Agent 管理    │  (根据左侧菜单显示对应页面)       │
│  ├ 工作流管理    │                                │
│  ├ 知识库        │                                │
│  ├ 执行记录      │                                │
│  ├ 模板市场      │                                │
│  ├ 监控告警      │                                │
│  ├ 系统日志      │                                │
│  └ 用户设置      │                                │
└──────────────────────────────────────────────────┘

2.3 创建第一个 Agent（5 分钟体验）

方式一：模板市场一键创建（推荐）

进入「模板市场」
选择一个模板（如"智能客服"）
点击「一键创建 Agent」
系统自动生成 Agent 和工作流，立即可用

方式二：从零开始

进入「Agent 管理」→ 点击「新建 Agent」
填写：名称、描述、选择 LLM 模型
进入工作流设计器，拖拽节点搭建流程
点击「部署」发布

三、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 部署与使用

在工作流设计器完成编排后，点击「部署」
状态变为「已发布」，出现「使用」按钮
点击「使用」进入对话界面
在聊天框输入需求，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 上传文档

进入「知识库」→ 点击「上传文档」
支持格式：PDF、TXT、Markdown、Word、Excel、HTML
上传后自动切片并生成向量嵌入
可在 Agent 配置中关联知识库

5.2 知识检索

Agent 在执行任务时自动检索关联知识库
检索方式：语义相似度匹配
知识进化：Celery 定时任务每小时自动从对话中提取新知识入库

5.3 知识仪表盘

文档数量：总文档数及增长趋势
知识条目：自动提取的知识点数量
引用次数：知识被 Agent 检索的次数排行
类别分布：知识按类别统计

六、模板市场

6.1 浏览模板

进入「模板市场」查看 11 个行业模板：

模板名称	适用场景
智能客服	自动回答客户问题，支持知识库 RAG
研发日报	自动汇总 Git 提交，生成日报
PR Review	自动审查代码 PR，给出改进建议
面试调度	自动安排面试时间，发送通知
竞品监控	定期抓取竞品信息，生成分析报告
测试报告	分析测试结果，生成质量报告
入职引导	新员工问答助手，帮助快速上手
风险预警	监控数据异常，自动告警

6.2 使用模板

浏览模板详情（功能说明、工作流预览）
可自定义参数：名称、Temperature、启用的工具
点击「一键创建」→ 自动生成 Agent + 工作流
进入工作流设计器微调（如需）

七、对话与协作

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+

12 KiB Raw Blame History Unescape Escape