Feature 模型治理、价格表与部署 Info

这一组 System API 决定两个生产基础：某个 LangSmith feature 可使用哪些模型/默认哪个模型，以及 tracing 中的模型调用如何匹配成本。Info/Health 则用于版本门禁和实例存活检查，不是应向公网完整暴露的运维信息页。

Feature 级模型治理

PUT body 是 model 字符串，path 中的 model 必须 URL encode。列表返回 feature、default_model、disabled_models、org_disabled_providers。disabled_models 是 workspace 禁用集与 organization 级禁用 provider 的并集；org_disabled_providers 是其中上级强制部分，workspace 管理员不能重新启用。

变更不变式：默认模型必须在有效 catalog 中、未被 workspace/org 禁用、已配置 provider 凭据并符合数据地域/合规策略。切换前在目标 feature 做能力/成本/延迟/输出兼容验证，保存旧值并可一键回滚。变更 204 无 body，应紧接 GET 校验有效配置，不仅根据 HTTP 成功更新 UI。

Model Price Map

创建与 PUT 都必填 name、match_pattern、prompt_cost、completion_cost，可带 match_path、provider、start_time、prompt/completion cost details。请求 cost 可为 number 或 decimal string，读取统一是 string；用 Decimal 解析，不用二进制 float 做账务聚合。

当前 endpoint 页没有定义 cost 的币种、token 缩放单位、pattern 语法/优先级、重叠规则中谁胜出；不能从字段名自行推导。上线前在目标部署用代表性 model metadata 做匹配契约测试，明确单位与优先级，再写运维手册。

match_pattern 若是正则/类正则可导致过宽匹配或 ReDoS；限长、禁危险构造、在全量已知模型上预演冲突。价格变更使用新记录 + start_time 版本化更易审计；直接 PUT/删除可改变历史成本重算，执行前保存快照、评估报表影响并建立回滚。写/删成功只返 200 无资源 body，后续 GET 校验。

Health 和 Info

GET /api/v1/info/health 当前无 security requirement，返回 clickhouse_disk_free_pct。这是存活/容量信号，不证明所有依赖、写入、查询或异步 worker 都可用。Kubernetes 等环境中将 liveness 与 readiness 分开；通过内网 ingress/监控网段保护此容量信息。

GET /api/v1/info 返回 version、git SHA、instance flags、batch-ingest config、SDK 版本界限、license expiration 和 customer info。页面描述称默认无认证，设 FF_INFO_ENDPOINT_AUTH_REQUIRED=true 后要认证；但当前 operation 的 OpenAPI security 又列出 API key/Tenant/Bearer。这是配置相关且文档/schema 表述不一致的边界；客户端要在目标部署做 200/401 contract test，运维上按需认证的更安全基线配置。

不将完整 instance flags、license/customer info 暴露给匿名用户或记入公开日志。升级前用 Info 做 SDK/server 版本门禁，但不仅根据版本字符串宣称功能可用；结合 feature flag、实际 API contract test 和迁移检查。