Pi Agent

Pi 是一款面向开发者的终端自主编程助手，支持在本地的 models.json 中配置自定义 OpenAI 兼容后端并指定调用端点。

1. 配置环境变量

在终端中导出管理控制台生成的 API Key：

export ANYSTARX_API_KEY="sk-..."

2. 编辑 models.json 配置文件

打开或创建本地配置文件：

~/.pi/agent/models.json

在文件中添加（或合并进现有的 providers 节点）：

{
  "providers": {
    "anystarx": {
      "baseUrl": "https://console.anystarx.com/v1",
      "api": "openai-completions",
      "apiKey": "$ANYSTARX_API_KEY",
      "models": [
        {
          "id": "MODEL_ID",
          "name": "AnyStarX Model",
          "contextWindow": 128000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

将 MODEL_ID 替换为管理控制台模型列表中标注的完整模型标识符。

3. 协议兼容性选项

如果所选模型在处理 developer 角色或 reasoning_effort 参数时返回不支持的错误，可在 provider 节点中加入兼容性声明：

"compat": {
  "supportsDeveloperRole": false,
  "supportsReasoningEffort": false
}

该配置也可单独声明在具体的 model 项中。详细字段说明可查阅 Pi Custom Models。

4. 切换模型与验证

启动 Pi 交互会话后，执行 /model 命令调出模型选择菜单，选中 anystarx 分组下的目标模型，随后发送一条测试消息确认连通状态。

Pi 在执行 /model 命令时会重新读取 models.json，修改配置文件后通常无需重启终端进程。

常见问题排查

• 模型菜单中未展示自定义服务商：检查 JSON 文件格式是否有效（注意末尾逗号与双引号闭合），并确认 baseUrl 与 api 字段声明在 provider 层级。
• 提示鉴权失败：确认当前终端会话已导出 $ANYSTARX_API_KEY，或在配置文件中直接填入密钥明文进行隔离排查。