SuperAPI AI 工具集

orchestrator

通用与其它

查看项目

更新于 10-15 19:55

技能介绍

用途:orchestrator 用于分布式系统中的多实例委派,把任务路由到 A-H 实例,支持 fanout 与聚合、会话创建与发送,以及实例健康检查,适合跨分布式通信集群协调复杂工作流。

主要能力:路由可将任务定向委派到指定实例;fanout/聚合可向多个实例广播请求并收集汇总响应;会话管理通过 sessions_spawn 创建会话、sessions_send 发送数据;健康检查可查询实例状态,如 /api/health/check 返回状态码(200 表示健康);失败委派可按可配置阈值自动重试最多 3 次。

使用方式:需先设置环境变量 $ORCHESTRATOR_API_KEY。CLI 示例:openclaw orchestrator route --instances A B --payload '{"data": "task"}';openclaw orchestrator fanout --targets A-H --aggregate true --timeout 10s;openclaw orchestrator sessions_spawn --id session1;openclaw orchestrator sessions_send --id session1 --data '{"key": "value"}';openclaw orchestrator health --instances A-H --output json。API 端点包括 POST /api/orchestrator/route、POST /api/orchestrator/fanout、POST /api/orchestrator/sessions/spawn、GET /api/orchestrator/health,请求头使用 Authorization: Bearer $ORCHESTRATOR_API_KEY。配置可用 JSON 文件并通过 --config config.json 传入。

适用场景:多实例负载均衡、分布式节点数据聚合、长会话管理、容错系统中的实例健康监控,以及单实例处理不足的可扩展服务或并行计算。

限制:资料未提供具体收费、价格、平台支持范围与性能指标;集成需在集群注册该技能,并依赖 health-checks 模块;常见错误包括 401 认证失败、503 实例不可达、聚合超时,需检查密钥、使用 --retry 3 或指数退避并记录带时间戳的日志。