1. 概览

如 三方智能体接口开发说明文档 ，您需要向CTICloud 提供以下信息。而后，可以按照本节说明进行平台侧的接入配置。

• 智能体调用地址（URL）
• appKey
• secretKey

💡若接入方需要在不同业务场景下调用不同智能体，则需在接口开发阶段于 userField 参数中预留一个变量字段（本节示例变量名为 arg）。后续 CTICloud 在调用智能体接口时，将根据具体业务场景传递不同的 arg 值，从而在同一 URL 下实现对不同业务场景智能体的调用。

2. 全流程概述

┌────────────────────────────────────────────┐
│            三方智能体接入全流程             │
└────────────────────────────────────────────┘

🚀 步骤 1：智能体提供调用信息
    ├── 提供可调用的接口地址（URL）
    ├── 提供鉴权信息（appKey / secretKey）
    └── 如涉及多场景调用，需在 userField 字段预留参数变量

⚙️ 步骤 2：平台侧接入配置
    └── 在企业配置中新增三方智能体

🔀 步骤 3：业务调用配置
    ├── 在语音导航中通过变量节点赋值
    └── 在智能体节点中绑定参数变量

🤖 步骤 4：任务调用智能体进行交互

2.1 为企业账户接入三方智能体

该步骤涉及 CTICloud 平台侧的系统配置，需要由天润内部技术团队完成。

在完成智能体接口开发后，请联系天润对接人员（技术支持 / 产品经理 / 运营人员），由平台侧协助完成企业账户的三方智能体接入配置。

2.2 多业务场景调用：通过变量实现智能体路由

在实际业务中，可能存在不同业务场景的外呼需求。为避免重复配置多个 URL，建议采用 参数路由方式。

🧩 实现原理

在接口开发阶段预留变量字段，例如：

{
  "userField": {
      "arg": "{arg}"
  }
}

CTICloud 在调用接口时会根据语音导航中设置的变量值传入不同 arg，实现对同一个 URL，根据 arg 值路由到不同业务逻辑。

2.3 业务调用控制：语音导航中配置变量

📍 页面位置

CTICloud Workspace → 语音导航 → 新建 / 编辑流程

🔁 配置流程说明

在智能体节点前增加“变量节点”进行参数赋值。

📌 步骤一：新增变量节点

• 新建变量（例如：temp），此变量作为桥梁变量。
• 固定赋值（如：car_sale / finance / recall）

📌 步骤二：在智能体节点中绑定变量

进入智能体节点 → 参数与变量，新建通道变量：

📊 调用逻辑示例

变量节点：
    temp = "car_sale"

智能体节点：
    arg = ${temp}

↓

CTICloud 调用接口：
    POST /example
    {
        "arg": "car_sale"
    }

↓

三方智能体根据 arg 路由不同智能体

✅ 完成效果

通过该机制可以实现：

• 一个智能体 URL
• 多个业务场景
• 动态路由
• 无需重复创建智能体配置

3. 整体能力总结

通过三方智能体接入机制，CTICloud 可实现：

• 灵活接入第三方智能体
• 支持多业务场景动态路由

实现真正可控、可扩展、可定制的智能语音外呼能力。