模型供应商

推理模型运行在 Scopwis Server 后面。客户端不需要 provider API key；provider 凭据也不会通过 Bootstrap、Agent observation、报表或公共分享返回。

支持的协议

Scopwis 支持四种标准模型 transport：

openai-compatible —— Chat Completions；
openai-responses —— OpenAI Responses；
anthropic-messages —— Anthropic Messages；
gemini-generate-content —— Gemini GenerateContent。

模型 ID 是 opaque string。Scopwis 不会把模型名 allowlist 编译进 planning 或 policy。

Provider Catalog 提供常见全球、中国、云端、gateway 和本地 runtime 预设。preset 只是配置元数据，不是授权绕过；只要 endpoint 符合已支持标准协议，即使暂时没有命名 preset，也可以走 Custom。

在设置中配置

对于已有 preset 的 provider：

打开 设置 → 模型；
选择 provider；
输入 token 或凭据；
provider 支持时加载模型目录；
选择模型；
点击测试；
保存。

Protocol、Base URL、认证模式、timeout 和 output token 设置保留在高级配置里。

Test 不会持久化。Save 会加密配置，并让后续新 Agent run 热加载；已经在运行的任务继续使用启动时的 provider。

环境变量配置

Headless 部署可以使用：

SCOPWIS_MODEL_PROTOCOL=openai-compatible
SCOPWIS_MODEL_AUTH=bearer
SCOPWIS_MODEL_API_KEY=...
SCOPWIS_MODEL_BASE_URL=https://api.example.com/v1
SCOPWIS_MODEL_NAME=provider/model-id

SCOPWIS_MODEL_AUTH 支持 bearer、api-key 和 none。无认证和纯 HTTP 只适用于可信 loopback 模型服务。

用量指标

Anthropic 返回 prompt cache 创建或读取计数时，输入 Token 指标会把它们与未缓存输入一起统计。没有 usage 时不根据文本估算。已知计数字段畸形或输入加总溢出会使 provider 响应校验失败，不发布部分结果。这些指标不是费用估算，也不会新增每轮 Token 限额。

兼容性要求

生产 Agent 必须依赖原生 tool/function calling。只能返回自然语言的模型无法满足结构化 submit_answer 和业务 tool 契约。

Scopwis 不会跟随模型 HTTP redirect；远端 Base URL 也不能包含凭据、query 或 fragment。