概述
Yeeoffice 智能体使组织能够使用可配置的企业级 AI 逻辑，实现分析、决策以及多步骤业务工作流的自动化。
每个智能体都由大语言模型驱动，并且可以通过结构化知识库、工具操作以及编排工作流进行扩展。
通过智能体，您可以：
自动化重复性任务（例如：分类、数据提取、审批路由）
基于业务数据提供智能问答
根据 AI 生成的决策触发工作流
构建多智能体架构，其中一个智能体可以调用另一个智能体
将 Yeeoffice 的 AI 能力与外部系统集成（Copilot、Power Automate、Zapier、API）
智能体既适用于非技术用户（通过可视化点击配置），也适用于高级团队（处理复杂自动化和智能编排场景）。
核心概念
1. 角色与提示
角色与提示定义了智能体的角色、职责、语气以及行为规则。
这是智能体的“思维核心”，决定了 AI 如何理解和处理用户输入。
2. 变量（输入与输出）
变量表示智能体接收和生成的数据。
输入变量：由用户或工作流发送给智能体的数据
输出变量：由智能体返回的数据，例如文本、结构化 JSON 或富文本内容
3. 知识库
知识库允许智能体读取来自 Yeeoffice 应用的结构化数据。
示例包括：
工单
配置项（CMDB）
客户记录
合同数据
工作流记录
产品文档（来自数据列表或文档库）
知识库会自动同步，并且可以包括：
数据列表
文档库
表单报表
一个知识库资源可以包含多个数据列表或文档库。
更多信息请参阅：知识库 | Yeeoffice Help Center
4. 工具
工具定义了智能体可以执行的操作，使其从“聊天机器人”转变为“可执行业务的助手”。
可用工具如下：
工具 | 描述 |
查询数据 | 从数据列表中检索记录 |
新增数据 | 创建新的数据记录 |
通过 ID 更新数据 | 更新指定记录 |
删除数据 | 永久删除记录 |
启动工作流 | 启动预构建的工作流或审批流程 |
调用智能体 | 调用另一个智能体进行协同推理 |
调用 HTTP 请求 | 调用外部 API 端点并返回结构化结果 |
其中，调用 HTTP 请求为 Yeeoffice 当前版本新增支持的工具类型，可用于与外部系统接口集成。
5. 智能体的使用
智能体可以在以下上下文中运行：
Yeeoffice 界面中的直接交互
工作流中（AI 助手动作）
Yeeoffice Copilot
API 调用
外部自动化工具（Power Automate、Zapier、Copilot Agent Flow）
多智能体编排流程
访问智能体
要访问智能体，请按以下路径操作：
打开应用设置
进入 智能体 → 智能体管理
点击 创建智能体 以创建新的智能体
或选择现有智能体进行编辑、测试或重新发布
创建新智能体
第一步 — 定义智能体身份
创建智能体时，需要配置以下内容：
A. 智能体名称
请使用清晰且具有描述性的名称，例如：
服务台问答智能体
工作量估算生成器
合同分析智能体
B. 功能描述
为智能体用途添加简短说明，例如：
“分析支持工单数据，并基于相关知识库生成准确、结构化的问答。”
C. 上传图标（可选）
您可以上传符合品牌风格的图标，使该智能体更容易识别。
点击 确定 创建智能体记录。
第二步 — 配置角色与提示
该部分定义智能体如何思考和响应，包括：
角色定义
目标
输出逻辑
格式要求
分析风格
支持的业务场景
示例格式：
角色：服务台问答助手
你是一个专门用于回答 IT 服务台运营问题的智能体……
目标：
理解用户问题
从知识库中检索并分析信息
提供简洁、准确且格式良好的回答
第三步 —配置
详细信息
“详细信息”部分显示智能体的核心信息，包括名称、智能体 ID 和描述。
名称 显示在智能体图标右侧，并作为智能体列表、Copilot 选择面板以及工具配置界面中的主要标识。如果名称过长，将以省略号形式截断显示。
智能体 ID 是系统生成的唯一标识符，在通过工作流、调用智能体工具或 API 集成调用该智能体时使用。该 ID 不可修改。
描述 提供智能体用途的概述，有助于管理员和用户理解该智能体的设计目的。
点击 编辑 按钮后，“详细信息”部分将进入可编辑状态，允许您修改图标、智能体名称和功能描述。编辑完成后，您可以点击 保存 以应用更改，或点击 取消 放弃更改并返回只读模式。
AI 模型设置
在 Yeeoffice 当前版本中，“详细信息”下新增了 AI 模型设置，用于控制智能体使用的模型来源、具体模型以及生成行为参数。
1. 模型来源
用于选择智能体所使用的模型来源类型：
内置 AI 模型
使用 Yeeoffice 提供的托管模型服务。无需 API 密钥，通过 AI Credits 计费。自定义 AI 连接
使用企业自定义接入的模型服务，例如私有部署模型或第三方模型 API。
2. 已选模型
用于选择具体使用的模型版本。当前界面可选项示例包括：
默认
Qwen3 Max
Qwen3.6 Plus
Qwen3.5 Flash
Qwen Deepseek V3.2
Qwen Kimi K2.5
Qwen Glm 5
Qwen Minimax M2.5
Doubao Seed 2.0 Pro 260215
Doubao Seed 2.0 Lite 260215
不同模型在推理能力、响应速度、成本消耗和适用场景方面可能存在差异。
3. 温度
用于控制模型生成内容的随机性和创造性。
数值范围：0 ～ 1
默认值：0.7
通常：
较低值会让输出更稳定、更可预测
较高值会让输出更灵活、更具创造性
第四步 — 配置智能体变量
输入变量
用于接收用户输入，例如：
问题（文本）
参考文件（文件）
案例描述（文本）
输出变量
用于返回结构化结果，例如：
回答（富文本）
建议（文本）
提取值（JSON）
使用 添加变量 来创建输入和输出变量。
向智能体添加知识库
知识库为智能体提供访问业务数据的能力。
第一步 — 打开知识库标签
导航至：
智能体 → 知识库 → 添加知识库
第二步 — 新建知识库并添加到当前智能体
资源示例包括：
SLA 目标
工单活动记录
服务分类
配置项（CMDB）
支持团队
请求类型
一个知识库资源可以包含多个数据列表或文档库。
在 Yeeoffice 当前版本中，当添加知识库时，您不仅可以选择已有知识库，还可以直接点击 新建知识库 并完成配置，随后再将其添加到当前智能体中。
在“选择资源”界面中，您可以执行以下操作：
方式一：选择已有知识库
在资源列表中选择已有知识库
点击 添加
将该知识库添加到当前智能体中
方式二：新建知识库后再添加
点击右上角 新建知识库
进入知识库创建界面后，配置以下内容：
名称：用于定义知识库名称，例如“销售合同管理”
描述：用于详细说明知识库的用途和内容，例如“该知识库包含了所有客户的销售合同，可用于查询合同条款、客户信息和产品明细。”
数据源：点击 添加数据源，为该知识库至少添加一个数据源
若尚未添加数据源，界面会提示“尚未添加数据源，请至少为该知识库资源添加一个数据源”
完成配置后，点击 创建知识库
返回资源选择界面后，点击该知识库右侧的 添加
将新建知识库添加到当前智能体中
也就是说，添加知识库到智能体的完整路径可以是：
点击“添加知识库” → 点击“新建知识库” → 完成知识库配置 → 点击“创建知识库” → 返回资源列表点击“添加” → 添加到当前智能体
第三步 — 启用或禁用资源
每个知识库资源都可以为该智能体单独启用或禁用。
第四步 — 编辑资源名称和描述（可选）
您可以为该智能体自定义资源的显示名称和描述。
这不会影响全局知识源，仅影响该资源在当前智能体中的显示和使用方式。
配置工具以执行操作
工具使智能体不仅能够“对话”，还能够“执行”。
可用工具类型
1. 查询数据
用于从选定的数据列表中检索实时记录，支持筛选、字段选择和排序。
使用场景：查询库存数量、查找某个用户提交的工单，或筛选状态为“待处理”的审批请求。
2. 新增数据
根据用户指令自动在数据列表中创建新记录，并智能填充字段值。
使用场景：根据用户描述创建新工单、注册新产品或创建库存入库记录。
3. 按 ID 更新数据
根据记录 ID 更新特定字段，实现状态变更或数值调整。
使用场景：将订单标记为“已完成”、减少库存数量或更改负责人。
4. 删除数据
根据记录 ID 永久删除数据记录。
使用场景：删除已停用产品、删除错误数据或清理测试记录。
5. 启动工作流
自动触发审批或业务流程，并根据用户输入填写流程字段。
使用场景：通过自然语言请求发起采购申请、差旅审批或报销流程。
6. 调用智能体
调用另一个智能体完成子任务，实现多智能体协作。
使用场景：库存智能体调用补货分析智能体，或合同智能体调用风险评估智能体。
7. 调用 HTTP 请求
用于调用外部 API 端点，并返回结构化结果供智能体使用。
使用场景：
调用第三方系统接口（如 ERP、CRM、财务系统）获取数据
向外部系统提交数据（如下单、创建记录、同步信息）
获取实时数据（如天气、汇率、物流状态等）
集成企业内部系统或微服务接口
该工具可用于扩展智能体与外部系统之间的数据交互能力。
通用工具设置（详细信息）
每个工具在“详细信息”部分都包含以下配置项：
1. 名称与描述
定义工具名称和描述，用于明确其用途，并帮助智能体理解何时使用该工具。
2. 应用与数据源
创建工具时，需要选择工具操作的应用和数据源（例如数据列表、文档库或工作流表单）。
您可以点击应用或数据源名称旁的 打开 按钮，在新窗口中查看对应的应用或数据源。
对于 调用 HTTP 请求 工具，该部分通常对应为 HTTP 请求配置本身，用于定义外部接口的目标地址及调用方式。
3. 使用的凭据
控制工具运行时使用的身份：
使用当前用户身份：以当前终端用户身份执行
使用指定用户身份：以指定用户身份执行。默认设置为当前用户，但可以更改
如果所选用户无效或缺少权限，工具执行将失败并返回错误。
对于 调用 HTTP 请求 工具，若外部接口需要身份认证，则应在 HTTP 请求配置中额外设置所需的认证信息。
工具输入映射
每个工具支持输入映射，包括：
输入名称
输入类型（文本、数字、附件等）
填充方式
值
填充方式包括：
AI 动态填充
智能体变量
固定值
来自其他工具的输出
示例：
输入 | 填充方式 | 值 |
目标对象 | AI 动态提取 | 从用户消息中解析 |
开始日期 | AI 提取 | 2025-02-15 |
用途 | 智能体变量 | {{purpose_text}} |
对于 调用 HTTP 请求 工具，输入映射可用于动态构造请求参数、请求体或其他调用所需字段。
完成设置（工具执行行为）
选项 1 — 等待响应
智能体等待工具执行完成，并接收其输出结果。
适用于需要立即返回或使用结果的场景。
选项 2 — 不等待响应
智能体触发工具后继续执行，不等待结果。
适用于后台异步任务。
工具可返回的输出
工具执行后，可向智能体返回：
工作流 ID
状态
记录 ID
错误信息
自动生成字段
处理结果
这些输出可用于后续步骤，或作为响应的一部分返回给用户。
对于 调用 HTTP 请求 工具，返回内容通常为外部接口返回的结构化数据，可进一步作为后续步骤的输入或直接呈现给用户。
运行与测试智能体
使用 预览与测试运行 面板可以：
输入测试数据
上传文件
执行智能体
检查输出
验证工具调用
验证知识库交互
这是在将智能体发布到生产环境前的关键步骤。
发布智能体
配置完成后：
点击右上角的 发布 按钮。
发布后，智能体可用于：
工作流（AI 助手动作）
其他智能体（通过调用智能体工具）
Yeeoffice Copilot
外部系统（API、Power Automate、Zapier）
智能体使用场景
智能体可以在不同系统中复用：
在其他智能体中使用（调用智能体）
在工作流或表单中使用（AI 助手动作）
作为 Copilot 指令
作为 Microsoft Power Automate 操作
作为 Microsoft Copilot Agent Flow 步骤
作为 Zapier 自动化步骤
通过 REST API 调用
更多信息请参阅：AI 智能体集成指南 | Yeeoffice Help Center
最佳实践
保持提示清晰具体
明确定义语气、格式、输出结构和决策规则
有策略地使用知识库，仅附加真正需要的知识资源
保持工具配置简洁，避免不必要的复杂链式调用
使用真实场景进行测试，以获得更高准确性
控制权限，确保触发智能体的用户具有适当访问权限
常见使用案例
服务台 FAQ / 问答智能体
工作量估算智能体
差旅申请构建器
合同审查智能体
多智能体协作
故障排查
问题：智能体返回的答案不完整
检查知识库和变量
使用更清晰的提示增强说明
问题：工具执行失败
检查字段映射、权限和工作流设置
问题：知识库未同步
打开知识源并检查最新同步时间以及数据可访问性
问题：在工作流中无法使用智能体
确认智能体已发布，并且用户具有相应权限
常见问题（FAQ）
问：多个智能体可以共享同一个知识库吗？
答：可以。
问：智能体可以调用自身吗？
答：不可以。为防止无限循环，递归执行已被阻止。
问：知识库越多是否一定会提升准确性？
答：不一定。应仅添加与使用场景相关的知识。
问：Yeeoffice 使用什么模型？
答：Yeeoffice 使用基于 GPT 的企业优化大语言模型。