本文主要介绍如何在多模态交互应用中接入百炼工作流和调用方式。
创建百炼工作流
1.创建百炼工作流,详细介绍可参考工作流应用。
2.创建一个名为【自助食堂】的工作流。
3.测试后发布应用。

接入百炼工作流
1.在您的多模态应用中导入【自助食堂】工作流。


参数配置
直连工作流
可以在与服务建立连接时,通过参数配置创建和工作流的连接通道,进而实现将请求直接透传给百炼工作流。
详细配置可参考文档:百炼及三方Agent直连调用
透传参数
如果需要给工作流的自定义变量传参,可以通过Start或者UpdateInfo指令来透传更新工作流参数。
parameters.bizParams | 参数 | 类型 | 说明 |
user_defined_params | Object | 配置给 Agent 的参数 | |
agentId | Object | 以 agentId为 key的对象,对象中的参数会传递给 Agent |
设置增量输出
如果您想要增量返回工作流结果,需要进行如下配置。
打开工作流的流式输出开关

parameters.downstream | 类型 | 说明 |
intermediate_text | string | 控制返回给用户哪些中间文本:
可以设置多种,以逗号分隔,默认为transcript |
incremental_response | boolean | 是否增量返回大模型结果,true为增量,false为全量。默认为false,全量下发 |
常见问题排查
返回结果超时
报错:"SOCKET_TIMEOUT_EXCEPTION: Read timed out"
需要留意工作流处理的时长,如果超过多模态应用的规定时间后,仍没有返回结果,则会报错。目前时间阈值为10s,建议控制好工作流的处理链路,若有超时的现象,可联系技术人员分析;

避免输出JSON格式
目前多模态应用不会对工作流输出的结果做额外的处理, 因此建议工作流选择文本输出。若输出JSON格式的内容,则JSON格式中的符号也会合成语音进行播报。

避免MarkDown格式输出
输出markdown格式的内容会影响音频的合成,所以要尽量避免输出该格式的内容。通常会在多模态应用的提示词中加入相关限制类的提示词,但容易忽略在工作流中加入限制,进而导致输出了错误输出了markdown格式内容;
