文档

文档

测试模式

使用可预测响应、零供应商调用和零配额消耗来集成与测试你的应用。

什么是测试模式？

测试模式允许你在不实际调用 AI 供应商、也不消耗请求配额的情况下验证 ModelRiver 集成。它会返回结构化输出配置中的示例数据，因此你可以在开发和测试阶段获得稳定、可重复的响应。

工作原理

  1. 创建或编辑工作流时，将模式从 Production 切换到 Testing
  2. 在测试模式下，你需要选择一个带示例数据的 Structured Output
  3. 你还可以配置 Response Delay（毫秒）来模拟 API 延迟
  4. 对测试模式工作流发起 API 请求时：
    • 系统会返回结构化输出中的示例数据（如配置了延迟，则稍后返回）
    • 不会调用任何 AI 供应商
    • 不会记录日志，也不会计入配额
    • 返回格式与真实供应商响应保持兼容

适用场景

场景价值
集成测试在不消耗 API 额度的情况下验证应用接入
开发环境用稳定响应进行开发和调试
CI/CD 流水线无需外部依赖即可运行自动化测试
演示环境无需成本或真实供应商密钥即可展示功能
压力测试在没有供应商限流的前提下验证吞吐处理

响应内容

测试模式响应会包含：

  • 结构化输出中的示例数据
  • 请求中配置的缓存字段回显
  • 表示 test_mode: true 和 provider: "Testing" 的元数据
  • 标准 token 使用字段（均为 0）
  • 同时兼容 raw 与 wrapped 返回格式

最佳实践

  • 始终为 schema 提供与实际结构一致的示例数据
  • 使用尽量接近生产的数据，提高测试有效性
  • 配置合理的响应延迟，模拟真实 AI 延迟（通常 500–3000ms）
  • 在部署到生产前，记得把工作流切回 Production
  • 在 CI/CD 中使用测试模式验证端到端请求链路，降低外部依赖导致的 flaky 测试

下一步