事故调查 LLM 提供方配置

可用性:preview

本页记录当前事故应用中的 project-scoped provider 行为,不是 Local Harness 源码预览或 planned 通用 Service 的 binding 格式。中立 core 只依赖 ModelProvider 与 opaque turn binding;endpoint、model 与 credential 由具体 adapter 和可信 composition 解析。

Mendry 支持项目范围内的 OpenAI-compatible 与 Anthropic provider 配置。Provider 是可选配置;Webhook classifier 调用失败时会退回确定性归一化。在启用相关模式时,remediation model turn 需要有效的项目 provider 配置。

  1. 创建保存 provider API key 的 http_bearer 项目凭据。
  2. 保存 provider、兼容 HTTPS 的 baseUrl、credential ID、model ID 与 API 模式:
    • Provider openai(OpenAI-compatible)支持两种 API 模式:
      • chat_completions 调用 /v1/chat/completions。
      • responses 调用 /v1/responses。
    • Provider anthropic 固定使用 API 模式 messages,调用 Anthropic Messages API /v1/messages。默认 baseUrl 为 https://api.anthropic.com,model ID 形如 claude-sonnet-5 或 claude-opus-5-5。
  3. 通过项目 probe 端点列出 model,并选择提供方返回的 ID。
  4. 使用所选 API 模式运行有界连接 probe,再保存操作配置。

已有 provider 记录默认使用 chat_completions。连接 probe、日志规则生成和 remediation model turn 会一致使用所选模式;所有模式都通过 /v1/models 发现模型。

对 Anthropic,已保存的凭据以 x-api-key 请求头发送,并附带 anthropic-version: 2023-06-01,而不是 bearer token。Messages API 没有 JSON object 响应模式,因此 Mendry 会指示模型只回复一个 JSON 对象,并在校验回复前去除 markdown 代码围栏。不发送 temperature 等采样参数。回复中包含 tool call 时,其前面的文字会被丢弃。

API key 只写不读。Provider 读取返回配置 metadata,不返回 secret。

只有已配置的 provider 调用可以离开客户环境。日志记录安全的 host/path、model、status、duration、可用 token usage metadata 与有界清洗诊断,不持久化原始 prompt、原始模型响应、bearer token 或 provider control payload。

模型输出是不可信的建议数据。服务端策略验证 schema、tool name、project/run scope、budget、evidence citation、stop condition 与 candidate plan。模型不能选择凭据、任意 URL、shell 命令、合并批准、部署批准或恢复状态。

删除或省略项目 LLM provider 可阻止新的 provider-backed 分析。通过外部运维记录检查进行中的活动;单用户事故应用不提供应用审计事件流,当前源码评估也不包含通用持久 worker queue。

  • backend/README.md