¶ CSK6大模型语音开发板接入其他大模型应用故障排查流程参考
为帮助大家方便接入大模型和智能体，我们提供了3条链路模板：
●链路1: 可通过注入节点调用DeepSeek节点，并将结果输出到debug1。
●链路2: 可通过web对话页调用DeepSeek节点，最终将大模型结果输出到对话页面上。
●链路3: 可通过开发板调用DeepSeek节点，最终将大模型输出的结果进行语音合成实现端侧播报
详情可以参考：https://docs2.listenai.com/x/s7TqUrMjl
但不少开发者朋友在智能硬件上接入大模型和智能体后，由于链路涉及大模型、云服务、硬件、语音等技术，在遇到问题的时候不知道怎么处理。接入第三方大模型和智能体遇到故障时的排查流程是一样，这篇文章基于CSK6大模型语音开发板接入火山引擎DeepSeek为例，给大家快速定位和解决问题提供参考。
¶ 链路1常见错误：
¶ 【请求失败：status=404】：
通常为 model 值配置错误
火山引擎官方提供的 model 相关信息有两个，在节点中需要在 model值处填入 接入点ID才能验证通过，登陆火山引擎账号后可以获得。（没有账号可以通过这个地址注册：https://www.volcengine.com/experience/ark?utm_term=202502dsinvite&ac=DSASUQY5&rc=9FTD37XY ，新用户注册时输入限时邀请码（9FTD37XY）可以获得3625万tokens）
¶ 【请求失败：status=401】：
常为 API-key信息错误，在model页面获得匹配的API key填入节点配置即可解决
¶ 【WEB应用不可用】
频繁重启服务和交互次数太多会触发该报错，需要新建一个应用导入模板重新配置
¶ 链路2排错流程：
当链路1配置通过，但是在自建应用的交互测试页文字交互后报【未知错误，请重试】，此时可以通过自建应用的日志页面获得详细信息。
¶ 进入调试日志界面
¶ 检查日志中的关键字段
例如下图就可以看到model值使用的是model ID信息，并不是接入点ID信息，所以要修正流程节点和子流程对应的配置信息。
¶ 进入编排页面检查并修改
¶ 修正子流程配置
¶ 链路3排错流程
若自建应用和开发板做完绑定配置后，语音交互不能回复，检查点依次是：
开发板是否绑定成功 → 发给火山引擎的DeepSeek是否成功 → 语音是否成功下发到开发板
其中，验证绑定和语音下发可以参考之前的排错文档：https://blog.csdn.net/2201_75889983/article/details/142590110?spm=1001.2014.3001.5501
这里重点讲下怎么检查发给火山引擎的DeepSeek是否成功。
¶ 1、规整编排流程
调试的时候可能会多次修改模板导入，先排除错误子流程的影响。可以看下左侧的子流程部分是不是有多余的错误子流程影响，点击节点打开被调用的子流程，对比名称删除多余子流程。
¶ 2、检查配置信息
当开发板绑定成功，交互后在大模型流程编排界面可以看到大模型节点显示的结果信息，执行会实时会输出对应的代码，如下图所示：
此时可以先通过对应的报错代码参考文章前面的常见错误来检查修正配置。
¶ 3、检查自建应用日志
进入日志的方法可以参考前面链路2的排错流程，如下图可以看到path部分少了一个“s”，正确的是值是 /api/v3/chat/completions
¶ 4、通过关键词检索修正json文件模板
当通过日志锁定错误信息，但不知道在哪里修改配置的时候，可以把流程导出为json文件，然后全文搜索错误的值，全部替换为正确的值导入即可。
上手大模型硬件应用开发可以参考：https://blog.csdn.net/2201_75889983/article/details/144744929