创建 Agent
创建 Agent 时，首先需要选择Agent类型：Agent、AgentFlow
- Agent：通过大模型对用户的请求进行意图识别，自主规划、组合技能完成业务动作。适合于比较复杂开放的Agent场景，比如智能客服Agent
- AgentFlow：Agent通过Flow处理用户的请求。适合于相对固定的Agent场景，比如订单处理Agent
选择 Agent 类型后，我们需要按步骤创建 Agent
第一步：选择模板，可以选择空白模板或系统预置的Agent模板
第二步：输入Agent的以下信息
- 名称、APIName、描述信息：Agent 的基础信息
- 角色：Agent 的角色设定会影响大模型回复用户的语气
- 类型：决定了 Agent 能够在哪个业务场景被使用（如果是从模板创建的，类型和模板绑定并无法修改）
- 模型厂商、模型选择：设置 Agent 用来做意图识别的模型
- 欢迎语文案：Agent 初始化时发送给用户的欢迎语和推荐提问
- 开启事件日志：开启后可以在 Agent 管理后台查看具体的调用日志
第三步：如果选择的是通过模板创建，这步可以按需选择模板中配置好的技能
第四步：配置Agent的知识来源，可以选择知识空间或者上传本地文档
创建完成后会进入 Agent Builder，在 Agent Builder 用户可继续搭建、调试 Agent 的各种功能
技能（Skill）最佳实践
技能是 Agent 功能的基础。它们定义了 Agent 能够做什么、可以处理哪些类型的客户请求以及如何处理
从技能库添加技能（Skill）
在 Agent 中可以从技能库中直接添加系统技能（纷享预置的技能）或自定义技能（租户中创建的技能）
技能
把一组处理相关问题的 AI 操作封装为一个技能，放入到技能库中，在 Agent 中直接添加使用，很好的解决了 AI 解决方案的快速复用问题
从技能库添加的技能无法在 Agent 中直接修改，只会随着技能库的技能升级
如果需要调整技能以适应当前 Agent 的业务需要，又不想影响其他使用此技能的 Agent，可以在 Agent 的技能中选择创建新版本
创建新版本后，技能库的技能会在此 Agent 中创建一个副本，用户可以直接修改该副本，并且不会影响技能库中的技能
可以从 Agent 技能列表的 icon 和标签分辨技能来源
- 技能 1 没有技能库 icon，表示此技能是用户在此 Agent 中基于技能库技能创建的副本，可以随意编辑，并支持点击恢复版本回退到技能库的技能（删除副本，恢复引用关系）
- 技能 2 有技能库 icon，代表此技能为技能库的系统技能，用户无法编辑技能，技能会随纷享发布新版本的系统技能自动升级
- 技能 3 有技能库 icon 和自定义技能标签，代表此技能为技能库的自定义技能，用户无法在 Agent 中直接编技能，可以点击跳转编辑按钮去技能库编辑，编辑的内容会在此租户中所有引用该自定义技能的 Agent 中生效
创建一个新的技能（Skill）
当技能库中的技能不满足需求时，可以直接在技能库中创建自定义技能，添加到 Agent 中使用
创建技能时，三个重要的要素是技能名称、意图描述和指令，三个元素组合起来构成了技能的 prompt
创建有效的技能（Skill）
- 思考：“如何对 Agent 的‘待办事项’进行有效的分类？”
- 保持技能名称简短但具有业务属性
- 确保不同技能名称的含义不重叠
- 在创建新技能之前，考虑是否可以复用技能库已有的技能
- 将每个Agent 的技能建议不要过多（不要超过 10 个），过多的技能会增加 Agent 不一致或不准确的可能性
技能意图描述（Claasification Description）
描述了哪些用户消息应该触发此技能。它对于帮助 Agent 了解何时使用此技能至关重要
最佳实践：
- 列出客户通常使用的特定关键字和短语
- 涵盖该技能应处理的所有问题
- 各个技能之间的意图描述内容要有区分，避免重叠
技能指令（Skill Instructions）
指令是指导 Agent 如何处理特定技能对话的指南。指令可以帮助 Agent 决定采取哪些操作以及如何响应
当推理引擎处理客户请求时，它会使用指令进行以下任务：
- 决定运行哪些操作：指令帮助推理引擎确定哪种操作最适合特定的用户请求。
- 操作编排：指令可以指导推理引擎确定某些步骤是否应先于其他步骤运行。为了获得更高的确定性。指令越清晰、越具体，Agent 的表现就越一致。
- 提供业务背景：它们帮助您的代理了解您公司的流程和术语。
推理引擎如何使用指令
当推理引擎处理客户请求时，它会使用指令完成以下任务：
- 决定运行哪些操作：指令帮助引擎确定哪种操作最适合特定情况。
- 确定步骤顺序：指令可以指导引擎确定某些步骤是否应先于其他步骤运行
- 格式化响应：说明决定如何将信息呈现给客户
最佳实践：
- 定义行业术语：不要假设 Agent 知道行业术语的含义。
- 具体说明顺序：如果步骤应按特定顺序发生，请清楚说明并将其包含在一个指令框中。示例：“首先使用验证客户操作验证客户的身份，然后提供帐户信息。”
- 示例：“首先使用验证客户操作验证客户的身份，然后提供帐户信息。”
- 使用一致的术语：在所有指令中使用相同的术语。Bad Case：一条指令中写着“检查客户信息”，另一条指令中写着“验证账户的详细信息”Good Case：始终使用“客户”一词，并用确切的名称来指代操作
- 警惕绝对化：“总是”和“从不”等绝对句会对 Agent 的互动方式产生重大影响。确保你在指令中有意地使用它们。
- 将操作与业务场景配对：明确指定在什么情况下使用什么操作。示例：“当客户询问包裹位置或交货日期时，使用跟踪订单操作。”
- 提供决策标准：帮助您的代理在类似的选项之间做出选择。示例：“如果客户有权访问其电子邮件，请使用电子邮件密码重置操作。如果用户无权访问其电子邮件，请使用安全问题验证操作。”
操作（Action）最佳实践
每个技能中都需要配置技能能够执行的具体操作，可以把操作理解为一个 function call
从操作库添加操作（Action）
在技能中可以从操作库中直接添加系统操作（纷享预置的操作）或自定义操作（租户中创建的操作），完成操作的开箱即用配置
创建一个新的操作（Action）
当操作库中的操作不满足需求时，可以直接在操作库中创建自定义操作，添加到技能中使用
创建操作时首先需要选择操作的类型
接着设置操作的三个重要的组成部分：操作名称（包括APIName）、操作指令和操作参数指令
操作名称（Action Name）
最佳实践：
- 使用简单清晰的名称给操作命名
- 同时操作的 APIName 也会被推理引擎使用，APIName 的命名也需要清晰并且有业务含义
操作指令（Action Instruction）
操作指令会告知推理引擎该操作的作用以及何时执行该操作，对于帮助 Agent 在正确的时间选择正确的操作至关重要
最佳实践：
- 用 1-3 句话准确解释该操作的作用
- 指定何时应使用此操作
- 列出操作成功运行所需的信息（必要的入参）
- 描述该操作可能处理的任何特殊情况或边缘情况
- 包含应触发此操作的示例短语
操作参数指令（Action Parameter Instruction）
操作输入参数指令定义了操作所需的信息以及 Agent 应如何从客户处收集这些信息。清晰的输入指令有助于 Agent 以正确的格式收集正确的信息
操作输出参数指令定义了操作返回值该如何正确的被 Agent 理解并在上下文中使用
最佳实践：
- 清楚地描述输入的内容及其目的
- 指定预期格式（长度、字符、结构），验证标准或格式要求
Agent Builder 中的其他功能介绍
预览与调试
用户可以在搭建 agent 时，随时通过左侧边栏的调试预览对话框测试 agent 的实际效果
每次对话的调试信息会在调试面板中通过流程图详细展示
可以开启图中位置「1」的调试模式，开启后每次对话完成后，Agent Builder 都会自动开启调试面板显示具体的调试信息
在调试预览对话框的Agent历史回复信息中，点击图中位置「2」的按钮，会把历史对话的调试信息展示在调试面板中
按钮
如果 Agent 中有确定的操作提供给用户执行，可以配置按钮按钮
可以绑定操作库中的任何操作，通过点击按钮触发
按钮触发的操作需要的参数，Agent 会根据操作中的参数指令，从聊天上下文中获取
知识库管理
管理 Agent 的知识库，支持两个来源
- 知识库：指定企业知识库的特定知识空间
- 本地上传：上传多个本地文件
在需要的技能中添加「知识召回」操作，即可使用 Agent 中配置的知识范围进行召回
事件日志
开启后可以记录每次对话的详细日志
使用 AI 助理
目前我们配置的 Agent 可以理解为一个在底层的智能体，需要配合各个渠道发布到终端让用户使用
不同类型的 Agent 可以发布的渠道也是不同的，渠道包括 ShareChat、企信、客户工作台，对象AI组件等
下面我们把一个AI助理类型的Agent发布，并在ShareChat中使用
在 AI 助理菜单创建一个助理，选择我们配置好的 Agent
点击页面左下角的 ShareChat 图标，开启 ShareChat 窗口，选择我们配置好的 AI 助理，就可以使用Agent了
