SuperAPI AI 工具集

orchestration

智能体与模型

查看项目

更新于 10-16 09:30

技能介绍

用途:本技能用于结构化的多智能体协调,适合需要线程消息、阻塞式 ask/reply 流程、任务派发、worker_done/升级等待、任务 DAG、决策门、协调循环或把工作拆分给多个智能体的场景。若用户只是要做所有权交接(handoff、把任务交给另一个智能体或工作树),并未要求监督、监控、等待结果或协调 DAG,或只需普通终端控制、shell 命令、worktree 管理与内置浏览器,应改用 orca-cli 技能。协调依赖真实的 Orca 运行时状态,不要用非 Orca 的子智能体工具替代。

本文件是发现用 stub,不是使用指南;与版本匹配的完整 Orca 编排参考由 orca 二进制自身提供,以免与真正执行命令的二进制产生偏差。

使用方式:先为本会话解析 CLI 可执行文件,选定后所有后续命令复用它。若设置了环境变量 ORCA_CLI_COMMAND,使用其值(Orca 为受管 WSL 会话导出该变量)。否则,在暴露 ORCA_DEV_REPO_ROOT 的开发检出中使用 orca-dev。否则,在 Orca 管理终端之外的 Linux 上使用 orca-ide;切勿在那里直接运行裸 orca,因为在 Orca 终端之外它通常解析为 GNOME Orca 屏幕阅读器(/usr/bin/orca)并会在用户机器上开始朗读。其他情况使用 orca。下文 ORCA 是所解析可执行文件的占位符,运行前需替换;不要创建 shell 变量或按字面运行 ORCA。该方法在 POSIX shell、PowerShell 和 cmd.exe 中一致。若所选可执行文件无法运行,报告其确切错误并停止,不要改用其他可执行文件,以免静默指向不同的 Orca 构建。

运行 Orca 命令前先加载完整指南:ORCA skills get orchestration。该命令打印与将处理后续命令的确切二进制版本匹配的完整指南,涵盖任务创建与派发、注入的生命周期前言、worker_done 权限、决策门与协调循环。先阅读,再运行需要的具体命令。不要凭记忆或缓存的 stub 猜测子命令与标志,它们会随 Orca 版本变化。用 ORCA status --json 确认应用已启动(如需要可用 ORCA open --json 启动),面向智能体的调用优先使用 --json。

限制:若较旧 Orca 不识别 skills get,仅当所选二进制明确报告 skills get 是未知命令时才使用回退,其他失败不等于旧二进制,应报告而非猜测或更换可执行文件。对确认的旧版二进制,仅使用以下有界只读引导:ORCA status --json、ORCA orchestration task-list --json、ORCA terminal list --json;随后告知用户更新 Orca 可通过 ORCA skills get orchestration 恢复完整匹配指南。除此之外应询问用户,不要猜测旧二进制可能不支持的命令面。收费、价格、平台与效果等资料未提供。