BYO-Agent

本文是三方智能体接入的导读。页名 BYO-Agent。平台负责通话、通话中的 RASR、切句（endpointing）、TTS 播报，以及打断、挂机、转人工、按键采集。企业智能体负责对话、上下文、回复和工具调用。

这里的智能体是呼入机器人 / 外呼机器人上的对话配置。座席这个词只指人。座席工作台实时转写事件是 transcript。

快速阅读

外呼机器人建议智能体用 SSE 流式响应。平台只把当前轮文本送给智能体，历史由智能体用 conversationId 自己保存。

平台侧要拿到三样东西：调用地址（URL）、appKey、secretKey。多场景共用一个 URL 时，在 userField 里预留路由变量，示例名为 arg。

阅读地图

阶段	谁来做	文档
先看分工和顺序	实施、开发	本文
鉴权、请求、SSE、指令	智能体服务开发	三方智能体接口开发说明文档
企业绑定、语音导航变量、智能体节点	实施、配置	三方智能体对接配置说明文档

识别和合成若也要换成自有服务，另读 BYO-ASR、BYO-TTS。本页不改那两套字段。

配置项

信息	必填	作用
调用地址（URL）	是	平台把当前轮文本发到该地址
appKey	是	与 secretKey 一起做接口鉴权
secretKey	是	与 appKey 一起做接口鉴权
userField.arg	多场景时需要	同一 URL 按变量路由不同业务逻辑

接口侧字段、SSE 事件和指令文本以接口开发说明为准，包括 requestUniqueId、conversationId、responseMode、query、playedContent、message、message_end、error，以及 #挂机#、#转人工#、DTMF{...}、DTMF_INTERRUPT{...}。

配置来源：

开发按接口说明实现服务。
实施把 URL、appKey、secretKey 配到企业。企业账户上的这项绑定由平台侧实施协助完成。
管理端语音导航用变量节点赋值，智能体节点把变量绑到 arg 等通道变量。

生效

sequenceDiagram
    autonumber
    participant User as 用户
    participant Voice as 语音交互
    participant VA as RASR / TTS
    participant Agent as 三方智能体

    User ->> Voice: 用户说话
    Voice ->> VA: 实时音频，RASR 与切句
    VA ->> Voice: 识别文本
    Voice ->> Agent: 当前轮文本、上下文、userField
    Agent ->> Voice: 文本回复或指令
    Voice ->> VA: 文本转 TTS
    VA ->> User: 播报

通话中的识别是 RASR，不是挂机后的 ASR。

四层都成立才算接入完成：接口可按鉴权规则验签；企业已绑定 URL 和密钥；语音导航实际进入该智能体节点；智能体返回可播报文本，或返回挂机、转人工、按键指令。

验收

一通外呼机器人测试通话能收到开场白，并在后续轮次保持同一个 conversationId。
userField 中的业务变量能出现在播报文本中。
配置了 arg 时，不同变量值进入不同业务逻辑，且仍是同一个 URL。
流式回复按片段拼接后播报；指令本身不被 TTS 读出来。
交互日志能按 requestUniqueId 对上这一轮请求。