接口调用
下载
聚焦模式
字号
功能介绍
当某一轮对话需要从后端系统获取数据时，在上游对话节点旁边放置一个接口调用节点并进行配置。
操作说明
进入已创建的流程画布，依次点击画布上的开始通话 > + > 接口调用，在弹窗中填写以下配置项：
节点名称
填写清晰且唯一的名称，例如：查询订单。
接口地址
必填项，需填写实际的业务接口地址，例如：
https://api.example.com/check_order。超时时间
设置等待接口响应的最长时长。超过该时间仍未返回结果，则判定为接口调用失败并走失败分支，避免通话长时间无响应。可根据接口的实际耗时和延迟预算调整。
输入参数
点击 + 添加参数。例如添加
user_phone 并将其绑定到前序节点的变量，从而把用户的手机号传递出去。输出参数
添加一个与 API 返回字段同名的参数。例如响应为
{ "status": "Shipped" }，则添加名为 status 的输出参数。下游节点即可通过 ${status} 引用它。等待接口返回结果
开启：智能体会等待接口返回结果后再进入下一节点，适用于下游节点需要使用输出参数的场景。
关闭：智能体不等待接口返回，立即进入下一节点，适用于只需触发接口、无需使用返回结果的场景。
鉴权
鉴权方式：选择与您的后端接口一致的鉴权方式：
无鉴权：不校验来源，仅建议内网或测试环境使用。
basicAuth（账号密码）：填写用户名和密码，请求时以 HTTP Basic Auth 携带。
OAuth 2.0（client credentials）：填写获取 Token 地址、ClientID、ClientSecret，先换取 Token 再发起请求。
说明：
鉴权凭据为敏感信息，请使用 HTTPS 接口传输。
节点总览
节点 | 用途 |
核心交互单元 — 播放话术、听取用户回复、分类回复并分支。 | |
在通话过程中与外部系统交换数据（例如查询订单、回写结果）。 | |
在流程中显式写入或更新变量（设置默认值、推导值、规范化槽位）。 | |
基于变量值使用比较运算符进行分支 — 通用化的 if / else if / else 逻辑。 | |
按日期、时间和时区分支（例如工作时间或非工作时间）。 | |
收集数字按键（0–9、 *、#）— 适用于菜单式 IVR 分支、验证码 / PIN 输入或数字采集。 | |
将通话转接至人工座席技能组。 | |
将通话转接至其他智能体（对话流或自有模型），保留对话历史和变量。 | |
可以选择结束语终止通话。 |
相关指引
请根据您的搭建方式选择对应路径：
想了解我们的对话流节点？ 请前往 对话节点。
为您的对话流搭建知识库？ 请前往 搭建您的知识库。
如何测试您的模型？ 请参阅 测试对话工作流。
查看数据日志？ 请参阅 通话记录、通话录音、延迟。
如何创建和查看通话后标签？ 请参阅 话后标签（通过对话流程创建） 或 话后标签（通过外部大模型创建）。
文档反馈