文档

获取快速解答

查找有关流式传输、工作流、后端流水线、数据存储等方面的指南。

我可以在没有真实供应商密钥的情况下测试 ModelRiver 吗?

可以。创建一个具有结构化输出且没有供应商凭据的工作流。ModelRiver 可以综合符合模式的回退响应以进行测试。

你们支持流式传输响应吗?

支持。ModelRiver 客户端 SDK(@modelriver/client)通过 WebSocket 实时流式传输响应。你的后端启动请求并返回一次性令牌,前端连接后即可在生成过程中实时收到回复。参见客户端 SDK 文档实时流式传输指南

我可以创建多少个工作流?

根据你的需要创建任意数量。使用清晰的命名约定,并按团队或功能进行组织,以便于发现。

如何导入或导出一组工作流?

ModelRiver 支持可移植的版本 1 配置包。在「工作流」或「结构化输出」部分导出一个项目,再把 JSON 文件导入到任意项目中。所有内容以原子方式创建,绝不覆盖已有记录。参见导入与导出

什么是工作流模板?

为常见业务场景准备的现成工作流包,例如退款处理、工单分类、潜客筛选等。从模板页面下载一个模板,导入你的项目,再按照集成指南把它接入你的应用。

工作流可以调用我的后端吗?

可以。工作流可以运行后端流水线:ModelRiver 将事件投递到你的 Webhook 地址,你的后端校验或补充数据,再通过回调把结果发送回来,全程无需向前端暴露 AI 凭据。参见后端流水线

我应该如何分离环境?

创建不同的项目(例如“Production”和“Staging”),并为每个环境发放专用的 API 密钥。这样可以保持凭据、日志和分析的隔离。

ModelRiver 存储哪些数据?

为可观测性和故障排除存储请求负载、响应、缓存数据和 token 使用指标。根据你的保留策略要求清除日志。

如何轮换供应商凭据?

在「设置 → 提供商」中更新凭据。ModelRiver 会立即加密新值。

我可以使用自己的供应商 API 密钥吗?

可以。在「提供商」部分连接你自己的 OpenAI、Anthropic、Google 等密钥。你直接向提供商付费,ModelRiver 在此基础上提供路由、故障转移、预算与可观测性。

如何控制 AI 支出?

为项目和环境设置支出上限,让失控的测试或流量高峰在变成意外账单之前停止。参见支出上限了解配置与监控。

Webhook 有签名吗?

有。每次投递都会携带 mr-signature 请求头,它是使用你的 Webhook 密钥对原始请求体计算的 HMAC-SHA256 签名,另外还有时间戳和 Webhook ID,便于你在处理请求前进行校验。参见Webhooks

API 与 OpenAI 兼容吗?

兼容。ModelRiver 提供与 OpenAI 兼容的端点(/v1/chat/completions/v1/completions/v1/embeddings),现有的 OpenAI SDK 客户端只需更换 ModelRiver 的 Base URL 和 API 密钥即可使用。参见OpenAI 兼容性

可以导出日志吗?

可以。使用控制台的导出工具,或联系支持人员获取自动化导出与 SIEM 集成。

在哪里可以查看路线图或更新日志?

重要更新会出现在控制台公告和更新日志中。如需提前了解,可联系支持人员加入客户 Slack 频道。