伴侣智能体是一种多智能体系统，它使用以下核心功能来支持您的工作：
- 指导智能体：在对话期间主动向人工客服提供信息，例如后续操作建议和示例回答。
- 按需助理：人工客服可以与之互动的 AI 聊天机器人。
准备工作
在创建辅助智能体之前，您必须确定要使用的资源和工具。
资源：配套代理可以使用一组指令和工具定义。
工具：辅助智能体可连接到外部工具（例如 Datastore 工具、Google 搜索和 OpenAPI 工具），以便在实时对话期间提取信息。
设置配套智能体
请按照以下步骤设置伴侣代理。
第 1 1 步：创建辅助智能体
- 登录 Agent Assist 控制台。
- 前往配套代理，然后点击创建。
- 输入显示名称。
- 点击保存。
第 2 步：向辅助代理添加工具
通过添加网页搜索和 Datastore 搜索工具，增强辅助智能体的功能。对于 Datastore 搜索，您应该已经设置了 Datastore。
第 2.1 步：创建搜索工具
如需在 Customer Experience Agent Studio 控制台中创建搜索工具，请按以下步骤操作：
- 选择您创建配套代理的同一项目和位置。
- 点击创建代理，然后输入名称。
- 依次点击创建 > 根代理中的添加 > 添加工具。
- 在工具管理面板中点击添加，然后选择网页接地或数据存储区。
- 输入工具的名称和说明。
- 对于 Datastore 工具，还要选择要连接的数据存储区。
- 点击创建。
- 如需测试创建的工具，请依次点击根代理中的相应工具 > Test 以打开测试窗口。在将工具添加到辅助代理之前，请务必先测试该工具并验证其是否正常运行。
第 2.2 步：添加工具
如需在 Agent Assist 控制台中向配套代理添加工具，请按以下步骤操作：
- 前往随播代理，然后点击您创建的代理。
- 在工具部分中，点击添加。
- 选择您创建的 CX Agent Studio 智能体。
- 点击工具类型，然后选择网络接地或数据存储区。
- 点击工具，然后选择您创建的搜索工具。
- 针对触发器，选中以下任一选项：
- 响应式建议：为响应式代理启用搜索工具。
- 主动建议：为指导智能体启用搜索工具。
- 依次点击添加 > 保存。
您可以重复上述步骤，同时添加 Web 搜索工具和 Datastore 搜索工具。
第 3 步：向辅助智能体添加指导
辅助代理指令使用配置的工具（包括数据存储区工具），并优先考虑指导指令规则。这些指导说明决定了辅助代理在哪些条件下支持人工客服并激活配置的工具。按照以下步骤操作，为伴侣智能体添加指导。
- 在 Agent Assist 控制台中打开辅助代理。
- 从菜单中选择一个触发事件。触发事件决定了何时启动指导代理。请从下列选项中选择一项：
- 客户发送的消息
- 客服人员消息
- 话语结束
- 在指导部分中，点击添加。
- 输入以下详细信息：
- 指导代理的名称：指导代理的名称。
- 说明：对指导代理提供的服务的说明。
- 条件：确定当前情况下最合适的指导。
- 点击操作，然后添加步骤。这些操作建议了人工客服可以采取的后续步骤。
- 如需添加指导工具，请按照第 2.2 步中的说明操作。
- 依次点击添加 > 保存。
第 4 步：配置模型指导
您可以设置总体指令来确定指导代理的行为。请按照以下步骤配置模型指导。
- 在 Agent Assist 控制台中打开辅助代理。
- 在模型指南框中输入指令。
- 点击保存。
第 5 步：测试配套代理
在开始使用代理之前，请先创建测试配置文件，以便查看代理的实际效果。
- 在 Agent Assist 控制台中，前往对话配置文件，然后点击创建。
- 输入显示名称。
- 对于建议类型，请选择辅助代理，然后选择您创建的代理。
- 点击保存。
- 前往您的个人资料，然后点击试用以开始模拟。
启用流式响应式配套 API
借助流式响应式辅助 API，人工客服可以直接在控制台中构建按需助理。它使智能体能够提问、搜索网络和使用工具。
请按照以下步骤启用串流响应式配套 API。
第 1 步：建立流式传输连接
在开始之前，请确保您符合以下条件：
- 拥有
dialogflow.participants.suggest权限。 - 目标参与者
Participant::AGENT必须代表人类代理。
如需与响应式模式互动，您的应用应调用双向流式远程过程调用 (RPC)。
以下示例展示了打开流消息所需的 JSON 结构。此示例同时指定了目标人工客服参与者资源路径和初始查询文本。
RPC: google.cloud.dialogflow.v2.Participants.StreamingReactiveCompanionSuggestions (or v2beta1.Participants.StreamingReactiveCompanionSuggestions)
打开流时，初始 StreamingReactiveCompanionSuggestionsRequest 请求必须在 textInput 中包含以下详细信息，如示例所示。
- 目标人工客服
participant资源路径 - 初始查询文本
{
"participant": "projects/my-project/locations/us-central1/conversations/conv-123/participants/agent-456",
"textInput": "Can the customer return a laptop opened 25 days ago?"
}
第 2 步：发送人工客服查询
建立数据流后，使用 textInput 传输消息，以发送后续的人工客服查询。
{
"textInput": "What was the ID for this customer?"
}
在每个对话会话中，辅助代理一次只能处理一个有效查询。此限制可防止状态损坏、工具运行冲突和对话轮次顺序错误。如果当响应式代理正在积极生成响应或针对之前的查询运行工具时，您发送新的 textInput 查询，服务器会立即拒绝该新查询，并返回 ABORTED 状态代码和消息 A request is already processing。
第 3 步：取消现有查询
当人工客服想要停止正在运行的查询时，他们可以取消正在进行的对话轮次，而无需关闭 gRPC 流。发送包含 cancelReactiveQuery 的请求，如下所示：
{
"cancelReactiveQuery": {}
}
服务器会返回一条确认取消的状态消息 (ABORTED / CANCELLED: Reactive query successfully cancelled by client.)。
第 4 步：最终答案
当辅助代理完成查询处理后，会将最终的完整回答发送回互动面板。除了最终文本外，响应还包含以下完整的背景详细信息：
- 完整回答：由伴侣智能体生成的完整文字回答。
- 使用的工具：用于查找事实的任何内部工具或外部网络搜索的记录。
- 来源参考：用于生成答案的所有参考资料的链接、文章标题和网址。
- 资源 ID：回答记录和代理反馈的唯一资源 ID。
以下示例展示了最终的响应消息：
{
"isFinal": true,
"answerRecord": "projects/my-project/locations/us-central1/answerRecords/ar-789",
"reactiveModeFinalResponse": {
"response": "For SKU-104 laptops, the standard return window is 30 days from the date of delivery, provided the item is returned with all original packaging [1]. According to USPS holiday schedules, shipments may experience a 1-day delay on federal postal holidays [2].",
"toolCalls": [
{
"toolCallInfo": {
"toolCall": {
"toolDisplayName": "DataStoreTool",
"action": "searchKnowledgeBase"
},
"toolCallResult": {
"action": "searchKnowledgeBase"
}
}
},
{
"toolCallInfo": {
"toolCall": {
"toolDisplayName": "GoogleSearchTool",
"action": "searchWeb"
},
"toolCallResult": {
"action": "searchWeb"
}
}
}
],
"groundingMetadata": {
"groundingChunks": [
{
"retrievedContext": {
"uri": "https://internal-kb.company.com/policies/hardware-returns-30d",
"title": "Hardware Return Window Policy (30 Days)"
}
},
{
"retrievedContext": {
"uri": "https://www.usps.com/holiday/holiday-schedule.htm",
"title": "USPS Federal Holiday Schedule"
}
}
],
"groundingSupports": [
{
"segment": {
"startIndex": 0,
"endIndex": 127,
"text": "For SKU-104 laptops, the standard return window is 30 days from the date of delivery, provided the item is returned with all original packaging [1]."
},
"groundingChunkIndices": [0]
},
{
"segment": {
"startIndex": 128,
"endIndex": 242,
"text": "According to USPS holiday schedules, shipments may experience a 1-day delay on federal postal holidays [2]."
},
"groundingChunkIndices": [1]
}
]
}
}
}