智能体对接

<div style="max-width: 100%; margin: 20px auto;">
    
    <div style="background-color: #ffffff; border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1); overflow: hidden; font-family: 'Comic Sans MS', cursive, sans-serif;">
        
        
        <div style="background-color: #F4F8FA; padding: 1px 10px; border-bottom: 1px solid #dee2e6; display: flex; justify-content: space-between; align-items: center;">
            <div style="color: #0E42D2; font-weight: bold;font-size: 1.3rem;">智能体介绍</div>
            <div>
            </div>
        </div>
        
        <div style="padding: 25px; line-height: 29px; background-image: linear-gradient(transparent 26px, #dee2e6 27px, #dee2e6 27px, transparent 27px); background-size: 100% 28px; min-height: 100px; color: #333;">
            <div>智能体是一种能够自主行动、感知环境、做出决策并与环境交互的智能应用或实体。</div>
            <div>在AIUI平台上，智能体本质上是个自定义工具，用于解决垂直场景对话任务，支持任务抽槽、信源查询、大模型调用和任务逻辑管理等能力，适用于复杂对话任务。开发时配置的对话意图是AIUI对智能体等自定义工具进行调度管理的重要依据。为智能体配置意图，可以将相关意图的用户Query分发给特定的智能体处理。</div>
            <div><strong>- 新智能体</strong></div>
			<div>-- 适用链路：仅支持极速交互语义链路</div>
			<div>-- 支持能力：支持任务抽槽、信源查询、大模型调用等能力</div>
            <div><strong>- 旧智能体</strong></div>
            <div>-- 适用链路：仅支持通用大模型语义链路</div>
            <div>-- 支持能力：仅支持对话意图抽取</div>
        </div>
        
        </div>
    </div>
</div>

## 1、新智能体接入说明
AIUI平台升级版本新智能体开发目前支持两种方式开发接入:

<div style="display: flex; flex-wrap: wrap; gap: 12px; padding: 10px; max-width: 100%; margin: 0 auto;">

<a href="#三方智能体" style="text-decoration: none; color: #6f42c1; width: calc(50% - 6px);box-sizing: border-box;">
<div class="card" style="background: #ffffff; border-radius: 6px; box-shadow: 0 2px 8px rgba(0,0,0,0.08); overflow: hidden; transition: all 0.3s ease; cursor: pointer; border-top: 5px solid #e0e0e0; display: flex; flex-direction: column; height: 100%;">
<div style="padding: 10px 15px; line-height: 1.6; flex: 1;">
<h3 style="font-size: 1.1rem; margin: 0 0 6px 0; color: #0969DA; font-weight: 600;">三方智能体</h3>
<p style="font-size: 1rem; color: #36548B; margin: 0;">接入的智能体需要是符合 Open API 协议规范的API，目前AIUI适配了两个三方平台，具体支持能力如下，需要客户先在对应平台上开发对应类别的智能体后，配置到AIUI平台来。</p>
		<p>
		>>>点击跳转
		</p>
</div>
</div>
</a>

<a href="#模板智能体" style="text-decoration: none; color: #6f42c1; width: calc(50% - 6px);">
<div class="card" style="background: #ffffff; border-radius: 6px; box-shadow: 0 2px 8px rgba(0,0,0,0.08); overflow: hidden; transition: all 0.3s ease; cursor: pointer; border-top: 5px solid #e0e0e0; display: flex; flex-direction: column; height: 100%;">
<div style="padding: 10px 15px; line-height: 1.6; flex: 1;">
<h3 style="font-size: 1.1rem; margin: 0 0 6px 0; color: #0969DA; font-weight: 600;">模板智能体</h3>
<p style="font-size: 1rem; color: #36548B; margin: 0;">基于AIUI平台自己搭建的模板智能体做开发接入，支持切换高级模式使用节点编排能力进行开发。</p>
		>>>点击跳转
</div>
</div>
</a>
</div>
  
  <style>
    .card:hover {
      box-shadow: 0 8px 16px rgba(9, 105, 218, 0.15);
      transform: translateY(-2px);
      border-left-color: #0754b3;
    }
    .card:hover div[style*="background-color: #0969DA"] {
      background-color: #0754b3;
    }
    /* 响应式调整 */
    @media (max-width: 600px) {
      .card {
        border-left-width: 4px;
      }
      div[style*="padding: 15px 18px"] {
        padding: 12px 15px;
      }
      div[style*="grid-template-columns: 1fr 1fr"] {
        grid-template-columns: 1fr;
      }
      div[style*="padding: 0 12px"] {
        padding: 0 8px;
      }
    }
  </style>

## 2、三方智能体
<table border="0" class="docutils">
    <colgroup>
        <col width="10%" />
        <col width="10%" />
        <col width="10%" />
        <col width="10%" />
		<col width="10%" />
    </colgroup>
 <tbody valign="center">
	<tr class="row-odd">
		<th style="text-align: center;">平台</th>
		<th style="text-align: center;">网址</th>
		<th style="text-align: center;">智能体类型</th>
		<th style="text-align: center;">请求方式</th>
		<th style="text-align: center;">鉴权方式</th>
	</tr>
	<tr>
		<td style="text-align: center;"><a href="#星辰平台接入">星辰Agent</a></td>
		<td style="text-align: center;"><a href="https://agent.xfyun.cn/home">访问星辰Agent平台</a></td>
		<td style="text-align: center;">智能体-工作流</td>
		<td style="text-align: center;">HTTP</td>
		<td style="text-align: center;">Bear Token</td>
	</tr>
	<tr>
		<td rowspan="2" style="text-align: center;"><a href="#Coze平台接入">Coze</a></td>
		<td rowspan="2" style="text-align: center;"><a href="https://www.coze.cn/home">访问Coze平台</a></td>
		<td style="text-align: center;">智能体-提示词</td>
		<td style="text-align: center;">HTTP</td>
		<td style="text-align: center;">个人访问令牌</td>
	</tr>
	<tr>
		<td style="text-align: center;">智能体-工作流</td>
		<td style="text-align: center;">HTTP</td>
		<td style="text-align: center;">个人访问令牌</td>
	</tr>
	</tbody>
</table>

<div style="display: flex; align-items: center; background-color: #fff3cd; border-left: 6px solid #ffc107; border-radius: 4px; padding: 12px 16px; gap: 8px;">
    <div style="width: 30px; height: 30px; flex-shrink: 0;">
        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
            <path d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/>
        </svg>
    </div>
    <div style="flex: 1; line-height: 1.6;">
1、使用高级模式后将不可在切换为模板意图编辑方案；
<br>2、高级模式下，建议入参参数格式不要改动，因为AIUI服务内容已经做了参数结构适配，支持如交互历史等；
<br>3、目前三方智能体仅支持单轮交互结果输出，多轮对话待将在后续服务升级中适配支持如交互历史参数透传等能力。
    </div>
</div>

###  2.1 星辰Agent平台接入-工作流类

**步骤1、创建工作流智能体：**  登陆星辰Agent平台创建工作流智能体

![](/media/202507/2025-07-09_174313_1253580.8913366555940889.png)

**步骤2、智能体选择API发布：**  编辑智能体完成测试后，发布智能体绑定到AIUI应用

- 智能体创建编写完成后进行发布：选择API形式

![](/media/202507/2025-07-09_174406_2037860.8115443112985647.png)

- 绑定AIUI应用，获取token构建参数和工作流id（每次重新发布智能体时，记得点击:更新绑定）

![](/media/202507/2025-07-09_174445_8852910.3590345487707123.png)

**步骤3、构建个人token：**  通过[工作流API](https://www.xfyun.cn/doc/spark/Agent04-API%E6%8E%A5%E5%85%A5.html#_4-1-%E6%89%A7%E8%A1%8C%E5%B7%A5%E4%BD%9C%E6%B5%81 "工作流API")可以获知，个人token 构建方式为 ：  {apikey}:{apiSecret}

**步骤4、参数配置：**  AIUI平台配置星辰Agent智能体信息

- 配置授权token
- 配置智能体工作流id
- 创建意图
- 输出参数：同coze工作流中说明一致，现阶段建议无需配置

![](/media/202507/2025-07-09_174650_5323830.24888789469886197.png)

### 2.2 Coze平台接入
<div style="max-width: 100%; margin: 20px auto;">
<div style="background-color: #ffffff; border-radius: 5px; padding: 10px; box-shadow: 0 2px 4px rgba(0,0,0,0.05);border-top: 5px solid #e0e0e0;">
<h3 style="margin: 0 0 10px 0; color: #0969DA; font-size: 18px;">概述</h3>
<p style="margin: 0; color: #666; font-size: 16px; line-height: 1.6;">Coze平台接入主要分为提示词类、工作流两种。提示词类主要依赖提示词触发AI的单一响应，强调即时交互和灵活性；工作流类将任务拆解为多步骤流程，自动调用不同工具或模型协同完成复杂目标。</p>
		<a href="#Coze平台提示词" style="color: #6f42c1; font-weight: 500;">
		-Coze平台-提示词类>>>点击跳转&emsp;&emsp;&emsp;</a>
		<a href="#Coze平台工作流" style="color: #6f42c1; font-weight: 500;">
		-Coze平台-工作流类>>>点击跳转</a>
</div>
</div>

#### 2.2.1 Coze平台-提示词类
**步骤1、创建提示词类智能体：**  在Coze平台完成智能体创建，具体开发参考[Coze平台文档](https://www.coze.cn/open/docs/guides/)

![](/media/202507/2025-07-09_165347_1129420.913883352051953.png)

**步骤2、提示词类智能体选择API发布：**  Coze平台创建完成后进行智能体进行编辑测试，测试完成后发布智能体

![](/media/202507/2025-07-09_165430_8891040.6485372688845223.png)

**步骤3、Coze平台获取智能体id：**  发布后可以发布页面进行 Playground 调试，在跳转页面获取智能体id（<span style="color: #ff0000;">bot_id取值</span>）

![](/media/202507/2025-07-09_165540_2752210.2143935295879299.png)

![](/media/202508/2025-08-01_175605_8441090.451450588429793.jpeg)

**步骤4、Coze平台创建个人令牌：**  在【扣子API】--【授权】--【个人访问令牌】中创建令牌并记录token取值

<div style="display: flex; align-items: center; background-color: #fff3cd; border-left: 6px solid #ffc107; border-radius: 4px; padding: 12px 16px; gap: 8px;">
    <div style="width: 30px; height: 30px; flex-shrink: 0;">
        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
            <path d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/>
        </svg>
    </div>
    <div style="flex: 1; line-height: 1.6;">
注意：默认创建的属于临时令牌，会有有效期限制。
    </div>
</div>

![](/media/202507/2025-07-09_165643_6105470.7959570790707611.png)

**步骤5、AIUI平台创建三方智能体并配置：**  进入AIUI平台[智能体创作页面](https://aiui.xfyun.cn/studio/agent)，创建三方智能体（类型选择三方）

**步骤6、参数配置：**  进入编辑页面，根据创建的Coze平台智能体类型进行参数选择或填写

- 平台选择：coze
- 类型选择：选择智能体
- key 中填入个人令牌
- id 中填入智能体 bot_id

![](/media/202507/2025-07-09_170409_0509370.7668856912589257.png)

**步骤7、添加AIUI意图：**  创建意图是为了在AIUI全链路交互中，AIUI服务做业务转发判定，当用户请求的文本符合设置的意图时，会调用对应的智能体。
- 创建意图：设置意图名称
- 添加语料：设置用户对话能进入该智能体的相关句式（大模型会进行泛化理解）

![](/media/202507/2025-07-09_170648_7127140.2496154277110728.png)

#### 2.2.2 Coze平台-工作流类
**步骤1、创建工作流类型智能体：**  在Coze平台完成智能体创建，具体开发参考Coze平台文档

![](/media/202507/2025-07-09_170940_2626580.7273886523466256.png)

**步骤2、发布智能体：**  Coze平台创建完成后进行智能体进行编辑测试，测试完成后发布智能体

![](/media/202507/2025-07-09_172045_4235050.4482583576880158.png)

**步骤3、coze平台获取工作流id：**  在编辑页面点击更多设置，跳转 Playground 调试获取工作流id（workflow_id取值）

![](/media/202507/2025-07-09_172302_5943680.9390687608013244.png)

![](/media/202507/2025-07-09_171209_4854990.4834578707754962.png)

**步骤4、coze平台创建个人令牌：**  （同创建提示词类智能体**第4步**）
**步骤5、AIUI平台创建三方智能体并配置：**  （同创建提示词类智能体**第5步**）
**步骤6、参数配置：**  进入编辑页面，根据创建的Coze平台智能体类型进行配置

- 平台选择：Coze
- 类型选择：选择工作流
- key 中填入个人令牌
- id 中填入智能体工作流workflow_id
- 请求参数key填写：注意按照示例工作流入参实际key填写
- 创建意图

![](/media/202507/2025-07-09_171802_8659810.5665062312151715.png)

<div style="display: flex; align-items: center; background-color: #fff3cd; border-left: 6px solid #ffc107; border-radius: 4px; padding: 12px 16px; gap: 8px;">
    <div style="width: 30px; height: 30px; flex-shrink: 0;">
        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
            <path d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/>
        </svg>
    </div>
    <div style="flex: 1; line-height: 1.6;">
目前AIUI会直接把Coze平台工作流的结果整体字符串下发（不区分选择结果舒服类型：变量还是文本），如下图示例：
<br>1、现阶段如果全链路开启了语音合成播报托管，建议智能体输出结果类型选择：返回文本；
<br>2、输出参数控制：后续升级支持智能体返回变量类型时，提供开发者配置返回变量类型时指定参数结构抽取（目前暂未适配）
    </div>
</div>

![](/media/202507/2025-07-09_173055_0180800.4184274641345498.png)

![](/media/202507/2025-07-09_173932_9258420.9406660291469601.png)

## 3、模板智能体

**步骤1、创建模板智能体：**

- 使用AIUI官方模板：进行意图配置修改
- 使用自定义开发：进行意图配置和修改
- 如果需要更高级能力进行过程控制，可以切换到高级开发模式（该能力开发平台持续优化中）
<div style="display: flex; align-items: center; background-color: #fff3cd; border-left: 6px solid #ffc107; border-radius: 4px; padding: 12px 16px; gap: 8px;">
    <div style="width: 30px; height: 30px; flex-shrink: 0;">
        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
            <path d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/>
        </svg>
    </div>
    <div style="flex: 1; line-height: 1.6;">
注意：智能体开发切换高级模式后，将无法在切回默认的文本意图构建界面
    </div>
</div>

**步骤2、发布智能体即可：**

![](/media/202507/2025-07-09_174755_3148490.4047827481486951.png)