文档目录 Pi

Pi Coding Agent 多模型路由:复用已有模型,按难度分流

在 Pi 的 /model 中选一条 HiRoute 路由,继续用熟悉的工具和工作流。读文件、找定义等常规工作用经济模型,需要跨模块推理时用主力;也能让 Codex CLI 独立验证结果。

下载 HiRoute · 查看其他 Agent 教程

1. 扫描或登录,获取模型 · 2. 配置智能路由 · 3. 接入 Agent · 4. 了解任务委派

1. 扫描或登录,获取模型

打开“模型 → 通用模型 → 添加模型 → 扫描本机”,找到 Pi 的模型来源。HiRoute 会读取支持的 models.json 声明、API Key 来源和可识别的已安装模型目录。选中接入,检查并保存要用的模型。

如果插件提供了可用的 API 地址和 Key,可以从“新建 API 接入”填写并检查。也可以在“连接订阅”导入 Codex 或 Claude Code 模型,或通过 Magpie 接入 Qoder 模型。

2. 配置智能路由

  1. 打开“智能路由 → 新建智能路由”,命名为“Pi 日常开发”,选择 “按难度分流”。
  2. 在“常规模型”组点击“添加模型”,选择第一步接入的快速或经济模型,处理读文件、找定义、整理资料等常规工作。
  3. 在“主力模型”组添加适合复杂分析、方案判断或多文件修改的模型。两组可以使用不同订阅、API 或本地模型,按各自账号可用的模型组合。
  4. “判断方式”先选 “启发式规则”,然后点击 “启用”。发布后,这条路由就能在下一步的 Agent 接入设置里选到。
HiRoute 按难度分流配置中的判断方式、常规模型组和主力模型组
常规组负责日常步骤,主力组处理复杂轮次。图中的模型可替换为你第一步接入的模型。

想根据执行表现进一步调整时,可在同一位置选择决策模型,使用阶段评分和低分保护。了解难度路由的判断方式

3. 接入 Agent

打开“Agent → Pi → 模型路由”,勾选“Pi 日常开发”,按模型支持情况选择协议并保存。

Pi 模型路由配置中的路由勾选项与接口协议
勾选已发布的路由,保存后在 Pi 的 /model 中选择。

重启 Pi,输入 /model,选中新增的 HiRoute 路由。让它查找一个函数的调用位置,再回到 HiRoute“会话 → 路由时间线”查看模型选择。

4. 了解任务委派

在主 Pi 会话里用主力模型设计方案时,可以让另一条轻量 Pi 执行计划去收集相关测试和调用位置。让经济模型处理文件读取和搜索,主 Pi 读一段索引后继续推理。需要实现复杂改动时,也可以选择绑定 Codex CLI 的计划。

建一条“Pi 快速检索”固定模型路由,在“更多设置 → 任务委派”中开启委派并选 Pi,填写用途并启用。然后在主 Agent 的“Pi → 任务路由”中开启委派。

使用 HiRoute 把这个函数的测试检索交给“Pi 快速检索”。只返回测试文件、用例名和覆盖到的行为。

在主会话和执行任务的时间线中分别核对实际模型和用量。给 Pi 配置轻量执行计划