SuperAPI AI 工具集

pi-interactive-shell

编程与开发

查看项目

更新于 10-15 21:36

技能介绍

用途:该技能用于在 Pi 中把任务委派给其他 AI 编码智能体 CLI,并管理这些交互式终端会话。

主要能力:提供三种委派方式。前台子智能体通过 interactive_shell 在覆盖层中运行,用户可见并可随时接管;dispatch 模式为触发后即走,完成时通过 triggerTurn 通知,加 background: true 可无界面运行;后台子智能体通过 subagent 工具运行,仅限 Pi,支持并行与完整输出捕获。

使用方式:默认智能体为 pi,仅当用户明确要求时才用 claude、gemini、codex 等。启动示例:interactive_shell({ command: 'pi "Review this codebase"', mode: "hands-free" }),返回 sessionId 后可用 interactive_shell({ sessionId: "calm-reef" }) 查询状态与输出,用 kill: true 结束。发送输入支持 input、inputKeys(如 ctrl+c、down、enter)、inputPaste 与 inputHex。输出查询默认 20 行、5KB,可用 outputLines(最大 200)与 outputMaxChars(最大 50KB)调整,incremental: true 可分页读取。查询有每 60 秒一次的限制。

适用场景:需要监督的长任务、即发即弃的委派、并行任务、需要特定智能体能力(用户指定时)以及安全捕获 TUI 输出(配合 timeout)。

限制:reason 参数仅用于界面显示,不会传给子进程,初始提示必须写入 command;TUI 智能体不要用 bash 运行,应使用 interactive_shell 加 timeout;后台 subagent 仅支持 Pi。资料未提供收费、价格与平台信息。