SuperAPI AI 工具集

orca-ask

智能体与模型

查看项目

更新于 10-16 06:14

技能介绍

用途:orca-ask 用于在需要真实人类决策、无法通过阅读代码、配置或测试确定时,向用户提问并阻塞直到其回答。它不同于请求继续执行的许可,也不同于 orchestration ask(后者是编排运行中 worker 与 coordinator 之间的消息传递)。触发场景包括用户需要在选项间选择、确认决定或提供非机密值。

主要能力:支持 select、multiselect、text、number、date、confirm 等提问类型,并返回结构化 JSON 答案。

使用方式:先确定本次会话使用的可执行文件并复用。若设置了 ORCA_CLI_COMMAND 环境变量则使用其值;否则在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev;否则在非 Orca 管理的 Linux 终端使用 orca-ide,切勿直接运行裸 orca,因为那里通常解析为 GNOME Orca 屏幕阅读器;其余情况使用 orca。运行命令前先执行 ORCA skills get orca-ask 加载与版本匹配的完整指南,再运行具体命令。优先使用 --json。指南未覆盖的命令或标志可用所选可执行文件的 --help 查询。

限制:ask 本身没有安全的只读替代,注册即产生用户可见副作用,旧版二进制可能没有该命令。不要回退到 orca orchestration ask。若命令报告 Orca 未运行,可用 ORCA open --json 启动后重试;若报 runtime_access_denied,说明沙箱阻止连接,应以提升权限重跑,且不要运行 ORCA open 或重启 Orca。若 skills get 未知,说明更新 Orca 可恢复指南,此时用 --help 做只读发现,不要猜测不支持的命令。