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