Example

按优先级顺序解析一条 provider 凭据

看 Pi 依次查询那四个凭据来源的顺序,以及为什么一个模型可以从 models.json 加载却仍然不可用。

Pi 从四个来源解析一条 provider 凭据,并使用第一个产出值的那个:一个运行时 API 密钥、一条已存储的 auth.json 凭据、models.json 里的一个 apiKey,然后 是该 provider 的环境变量。这是对第 3 章那些测试的一次配置与决策表走查;下面的 每个密钥都是占位值,它不解析任何真实凭据。

四个来源,按顺序

顺序 来源 它来自哪里
1 运行时密钥 --api-key,或一次运行时 API 调用
2 已存储的凭据 <agent-dir>/auth.json
3 模型密钥 <agent-dir>/models.json 中该 provider 上的 apiKey
4 环境变量 该 provider 的环境变量

这个顺序会让人意外:models.json 里的一个密钥位于一条已存储凭据的下面,而 不是上面。它的存在是为了给一个自定义或自托管的模型提供密钥;它不覆盖一个你已 经登录所用的密钥。

一条已存储的凭据是这个样子的(占位值):

{ "anthropic": { "type": "api_key", "key": "stored" } }

models.json 里的一个自定义端点以同样的方式提供它的密钥:

{
  "providers": {
    "mylocal": {
      "baseUrl": "http://localhost:11434/v1",
      "api": "openai-completions",
      "apiKey": "dummy",
      "models": [{ "id": "my-model" }]
    }
  }
}

已观察到的解析

那个标准测试通过 Pi 真实的 ModelRuntime 解析同样的那些来源,然后一次移除一 个。每一步断言胜出的来源:

在场的来源 解析出的凭据
运行时 + auth.json + models.json + 环境 运行时
auth.json + models.json + 环境 auth.json
models.json + 环境 models.json
仅有环境 环境变量
无 没有凭据

能加载不等于可用

测试的后半部分是一个值得记住的症状。models.json 里的一个 provider 条目可以 解析成功、模型也可以存在(getModel 会返回它),而在该 provider 拥有可用身份 验证之前,它不在可用列表里。加一个假的 apiKey 就足以让它出现。这就是为 什么一个正确的 models.json 仍可能让 /model 空着。

机制与局限

**有文档记载:**导出的 ModelRuntime、它的 getAuth 和 getAvailable 方法, 以及 auth.json / models.json 的文件形状。已观察:credentials.test.ts 在真实文件上驱动真实的运行时,并断言解析表的每一行,包括可用性差异。它还显 示,同一个脚本的行为完全一致,不论 provider 的密钥写成字面量、 $PI_TEST_KEY 还是 !command——provider 配置不是智能体行为。

这里的片段是示意性的:它们展示文件形状和优先级,不是在这台机器上的一次运 行,而且这里没有任何东西能证明一个真实模型会如何表现。一个 provider 扩展可以 定义它自己的解析;上面的顺序是有文档记载的默认链条。

完整源码与测试 。

Understand this example

Copy this prompt into your AI tool. No code runs here.

Apply this example

Copy this prompt into your AI tool. No code runs here.