常见问题
大多数 ModelRiver 问题属于以下类别之一:
- 身份验证错误:无效或已撤销的 API 密钥、缺失供应商凭据
- 供应商失败:超时、速率限制或模型可用性问题
- 响应问题:意外的输出格式、结构化输出验证错误
- 网络钩子 (Webhook) 问题:投递失败、签名不匹配、超时回调
故障排除主题
- 快速修复 (Quick fixes):针对最常见错误的“症状-解决方案”对照表
- 调试技巧 (Debugging tips):使用可观测性的系统调试策略
- 联系支持 (Contact support):何时以及如何联系 ModelRiver 团队
在不污染日志的情况下进行测试
- 使用工作流游乐场 (项目 → 游乐场)。响应将内联显示,不会持久化到请求日志中。
- 提供工作流预期的完整有效负载,包括
messages、inputs或metadata。 - 在部署更改之前,调整提示词、缓存字段或结构化输出并重新运行,直至满意。
下一步
- 可观测性 (Observability):深入研究请求日志和时间轴
- 安全性 (Security):查看凭别管理
- 常见问题 (FAQ):常见问题的快速解答