SuperAPI AI 工具集

interactive-shell

编程与开发

查看项目

更新于 10-15 21:09

技能介绍

用途:interactive-shell 是 pi_agent_rust 的技能,提供启动交互式编码智能体 CLI 的速查表与工作流,通过 interactive_shell 工具把任务委派给 Claude Code、Gemini CLI、Codex CLI、Cursor CLI 或 pi 自身。

主要能力:支持三种委派方式。前台子智能体在覆盖层中运行,用户可见并可随时接管,模式为 hands-free 时非阻塞返回 sessionId,可轮询状态、发送输入、结束时 kill;dispatch 模式为即发即忘,完成时通过 triggerTurn 通知,加 background: true 可无头并发执行;后台子智能体通过 subagent 工具运行,仅限 pi,隐藏执行并捕获完整输出。

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

适用场景:需要用户监督的长任务、即发即忘的委派、并行任务、结构化委派,以及需要捕获 TUI 输出(如 pi --help)时配合 timeout 使用。

限制:reason 参数仅用于界面显示,不会传给子进程,初始提示必须嵌入 command;状态查询限每 60 秒一次;后台子智能体仅支持 pi;TUI 智能体不应通过 bash 运行,否则会挂起。其他收费、价格与平台信息暂未提供。