本文介绍了如何通过边缘大模型网关调用第三方 AI 平台上搭建的智能体。

背景信息 #

您可以使用边缘大模型网关调用在支持的第三方 AI 平台上搭建的智能体，为您的应用提供更加智能化的服务。
支持的 AI 平台（智能体提供商）包括：

• 字节跳动扣子

前提条件 #

您已经在支持的 AI 平台上搭建了智能体。

• 关于如何在扣子平台搭建智能体，请参见 扣子官方文档 - 搭建你的第一个 AI 智能体。

步骤1：关联智能体 #

假设您已经在支持的智能体提供商平台上搭建了智能体，那么接下来您需要在边缘大模型网关平台补充该智能体的相关信息（如 Bot ID），以明确您希望调用的对象。

1. 登录边缘大模型网关控制台。

2. 在左侧导航栏，选择 模型配置管理 > 智能体管理。

3. 在 自有三方智能体 标签页，找到您的智能体所在平台，单击 操作 列的 关联智能体。

4. 在 关联智能体 对话框，完成以下参数配置，然后单击 确定。
   

   配置项	说明
   智能体名称	为智能体设置一个显示名称。
   智能体信息	输入智能体在提供商平台的标识符信息。智能体提供商平台不同，所需的标识符信息不同。 字节跳动扣子：需提供 Bot ID，即智能体 ID。 在扣子平台，Bot ID 是智能体的唯一身份标识符。您可以进入智能体的开发页面，从开发页面 URL 中获取 Bot ID。URL 中 bot 字段后的数字就是智能体 ID。 示例：假设智能体的开发页 URL 为 https://www.coze.cn/space/341****/bot/73428668*****，则 Bot ID 为73428668*****。更多信息，请参见扣子官方文档 - 获取智能体配置。
   描述	为智能体添加描述。

在智能体提供商列表，智能体 数字表示一个智能体提供商下已添加的智能体的数量。
以上操作完成后，相应智能体提供商的 智能体 数量会增加。您可以单击 智能体 数字，查看和管理（如编辑、删除）智能体提供商下已添加的智能体。

步骤2：创建调用渠道 #

边缘大模型网关通过调用渠道访问您的第三方智能体。为了建立这个渠道，您需要提供您在第三方智能体平台的密钥。有了密钥，边缘大模型网关才能够顺利访问和调用您的智能体。

1. 登录边缘大模型网关控制台。

2. 在左侧导航栏，选择 模型配置管理 > 智能体管理。

3. 在 自有三方智能体 标签页，找到您的智能体所在平台，单击 操作 列的 创建调用渠道。

4. 在 创建调用渠道 对话框，完成以下参数配置，然后单击 确定。
   

   配置项	说明
   调用渠道名称	为调用渠道设置一个名称。
   智能体提供商	目前仅支持 字节跳动扣子。
   调用智能体	选择该渠道允许访问的智能体。 您可以从已添加的智能体中选择一个或多个智能体。该渠道只能用于访问选择的智能体。
   授权方式	选择一种授权方式。可选项： 个人访问令牌 OAuth 访问令牌 不同授权方式的介绍，请参见扣子官方文档。
   令牌	授权方式 为 个人访问令牌 时，需要配置该参数。输入在扣子平台创建的个人访问令牌。更多信息，请参见扣子官方文档。 注意 令牌有效期最多为 30 天。超过有效期后，令牌将会失效，导致基于该令牌创建的调用渠道无法使用。 请留意令牌的有效期，确保调用渠道中的令牌始终有效，避免因令牌失效导致智能体调用失败。建议您在旧令牌即将失效前，在扣子平台创建一个新令牌，然后通过编辑调用渠道，将其中的旧令牌换成新令牌。
   应用 ID、公钥、私钥	授权方式 为 OAuth 访问令牌 时，需要配置如下参数： 应用 ID：指您在扣子平台创建的 OAuth 应用的 ID。 公钥 和 私钥：指您在创建 OAuth 应用时配置的公钥和私钥。 更多信息，请参见扣子官方文档。

在智能体提供商列表，调用渠道 数字表示一个智能体提供商下已创建的调用渠道的数量。
以上操作完成后，相应智能体提供商的 调用渠道 数量会增加。您可以单击 调用渠道 数字，查看和管理（如编辑、删除）智能体提供商下已添加的调用渠道。

步骤3：绑定调用渠道到网关访问密钥 #

要访问边缘大模型网关 API，您需要一个网关访问密钥。通过将您的智能体调用渠道绑定到一个网关访问密钥，您就可以在使用此网关访问密钥时，选择指定智能体作为被调用对象。

1. 登录边缘大模型网关控制台。

2. 在左侧导航栏，选择 模型配置管理 > 智能体管理。
3. 在 自有三方智能体 标签页，找到您的智能体所在平台，单击 操作 列的 创建网关访问密钥。
4. 完成 创建网关访问密钥 配置向导。
   您可以参考创建网关访问密钥完成相关配置。需要注意的是，在 模型配置 中，选择您的智能体调用渠道，将它绑定到网关访问密钥。将 渠道类型 设置为 自有三方智能体，可以筛选出所有可用的第三方智能体调用渠道。
   

步骤4：使用网关访问密钥 #

当您的网关访问密钥绑定了第三方智能体调用渠道，您在获取此网关访问密钥对应的示例代码时，就可以选择指定智能体作为被调用对象。将示例代码集成到您的业务逻辑后，您的边缘大模型网关请求将触发指定智能体调用。
具体操作，请参见使用网关访问密钥。需要注意的是，当您查看示例代码时，需要在 选择模型 中选择您的 自有三方智能体 调用渠道。

传递自定义的用户标识（user_id） #

当您通过边缘大模型网关调用 Coze 智能体时，为了区分并追踪不同的终端用户，您可以在请求体中通过 safety_identifier 字段传递一个自定义的用户标识。边缘大模型网关会将其转换为 Coze 对话接口中的 user_id 参数。

为每个终端用户设置固定的 user_id 至关重要，因为 Coze 会根据 user_id 来隔离不同用户的对话上下文、数据库以及其他对话记忆。这样可以确保每个用户都能获得连贯且独立的对话体验。

如果您在请求中未提供 safety_identifier ，边缘大模型网关将为每次调用随机生成一个 user_id ，这将导致 Coze 无法维持特定用户的对话历史。

关于 user_id 的更多技术细节，请参阅 Coze 官方文档。

请求示例：

以下示例展示了如何在调用时传递自定义的用户标识：

curl 'https://ai-gateway.vei.volces.com/v1/chat/completions' \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your-bearer-token>" \
  -d '{
      "safety_identifier": "user_A_12345",
      "model": "<your-bot-id>",
      "messages": [{"role": "user", "content": "你好，这是一个测试！"}],
      "temperature": 0.7
    }'

在该示例中，边缘大模型网关向 Coze 发起请求时，会附带 "user_id": "user_A_12345" 参数，从而让 Coze 能够识别并追踪来自用户 user_A_12345 的对话。