概览（Overview）
大路主线上生跑打出的数据一旦真跟那些台下排演测漏、演武场试枪的脏盘水全混在一起搅成一缸子浑水，那你这辈子都别想去号出这 AI 大应用底薪究竟有多稳。ModelRiver 早留了一手，逢有出警跑单它必自动贴上这发车的门第原源籍贯，让你滤起水来顺溜干净明澈，永保你判大盘抓错精准无两。
这打标签隔离的活咋运作的（How environment tagging works）
每票打来请求大单身上全必挂有一个叫 seed_batch（生发批头签）的前缀门派签：
| 头打签 | 原门籍出处 | 说解道白 |
|---|---|---|
live: | Production API | 从网线端真客户调用那进来的干真活的 |
test: | Test mode API | 那大 API 里面夹着 test_mode 假放水大标记进来的发单 |
pg: | Console Playground | 由大总操盘台（Console）的演武沙盘挂真枪打真模型的试调用 |
pg_test_mode: | Console Playground (Test) | 同样由操作大盘发起但却是空包挂试走形式路线不费真弹的假调号子 |
callback: | Backend Callback | 发自大事件大联动流给往回传调的那个 Callback 应和号签 |
pg_callback: | Playground Callback | 操盘台下头拿打假仿试等造拟回调的大虚信子 |
隔干净各种水池的好门好道（Best practices for environment separation）
1. 眼没看实先上一道筛网这死规（Always filter before analyzing）
正挠头排着生产线死崩大火患？ → 网口一紧拨向 "Live mode"看收等评卷跑测试的包传回？ → 扣下网关指准 "Test mode"验收这把工作流走没走对形貌？ → 发拨在 "Playground (Production)" 取看排戏等看看结构走顺对头没？ → 留筛网向那口 "Playground (Test mode)"就海看天看漫无目的全包全收？ → 大口尽开取向 "All requests" (不过千载一回极少用)2. 接那些大统集走线 CI 测必须挂试跑（Use test mode for integration tests）
当大队的车拉出来大面长跑流水线和化统并打时（CI/CD）：
Bash
# 在你下令开打大 API 那单内把 test_mode 这关旗拨向真打开 truecurl -X POST https://api.modelriver.com/v1/chat/completions \ -H "Authorization: Bearer $MODELRIVER_API_KEY" \ -d '{ "model": "your-workflow-id", "messages": [{"role": "user", "content": "test"}], "test_mode": true }'这下一本道就圈了铁律定规保证：
- 这跑的是空造仿演流不会调用上真外来花钱（免费白跑）
- 从生发这打胎底就印上
test:出产打头签 - 在最后过清算滤网那端这可从长流线上清干剥净剥离出来
- 决计不会落一星星火进那算长盘生花真线上扰乱算计
3. 先跑沙盘试活了你人工再去判生决死（Use playground for manual validation）
在一锤定音大闸开闸上线前：
- 头阵先试空枪跑趟水落（Test mode first）: 看他流门架结构歪没歪（不收费走空样片板料验）
- 切挡上线动过真火拉盘（Production mode）: 放出 AI 实模型接活出响打响应（要走掉一点弹药算真费）
- 开闸泄大汛上大线（Deploy）: 全本交待端去发产界去放活
- 守长线看灯看排盘（Monitor Live mode）: 防控死盯大有错乱出点差漏了没
每登迈下一大步它所衍落日记录都在各不同筛滤等框里老实互不串等干扰。
4. 万不要拿“全网通收（All requests）”的盘来算业务健康度的大底账（Never analyze "All requests" for health metrics）
当需要盘算系统整体的错误率、接口延迟或是花销总账等大指标时：
✗ 以过了一道“All requests”大网的数据来算错误率 = 5.2% (这里头原样掺进了所有你瞎跑废掉的测试错包，把错误率虚吹肿了) ✓ 基于过滤到实线“Live mode”里的数据算出的真实报错死率 = 1.8% (这才是真正接客的线上真业务健康度)光拿 “全盘统收（All requests）” 的数据大盘子去核算真活，算出的指标绝对是坑人的。因为那一帮你在靶场胡造的测试败单和瞎玩出来的实验等数据，也统统被不分青红皂白地记扣在了真实环境的头上。
防环境串水大清查核对单（Environment separation checklist）
- 确保所有跑 CI/CD 自动测线的调用全数带齐并配好
test_mode: true标记。 - 凡人工要自个捣鼓手调测试的，必在后台大台（Playground）去玩儿，绝不动真线 API 的口。
- 监控大屏拉来看实时命脉大健康度的，必须死守底线切成只过 "Live mode（主生产线）" 数据。
- 跟白花花的银子打交道的开支核算大盘时，绝对只扣看 "Live mode" 这真金水线防水分假算。
- 出火下场排错前定规先顺好那张这会该上哪路滤网的大谱。
循着脉去接看的顺流下站指引
- 怎么把 Token 花费掐死压到底（Token Optimization）: 管好流水不开冤大头耗能口。
- 盘巧了手头的各号筛网（Using Filters Effectively）: 教你练好这排网捕大鱼的看家本领。
- 全引总揽大退归回大全首盘（Back to Best Practices）: 转倒往回看向全局的大铺展首面。