按优先级顺序解析一条 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.