SuperAPI AI 工具集

a2a-executor-patterns

编程与开发

查看项目

更新于 10-15 21:09

技能介绍

用途:为 A2A 协议任务处理器提供可落地的执行器模式,覆盖任务处理、执行管理与智能体协调,适合在构建 A2A 执行器、任务处理函数、执行流程、任务生命周期与状态管理、重试与错误恢复、执行器中间件、任务校验与清洗时使用。

主要能力:提供四类核心执行器模式——基础同步执行器(快速简单任务)、异步执行器(长耗时任务,立即返回任务 ID 并异步处理、提供状态端点与完成回调)、流式执行器(增量返回结果、处理背压)、批量执行器(按相似性分组并行处理并聚合结果)。执行流程组件包括任务校验、错误处理(ValidationError 不重试、RetryableError 可重试、FatalError 终止)、重试逻辑(指数/线性/固定退避,maxAttempts、initialDelay、maxDelay)与任务状态管理(pending/running/completed/failed)。还提供日志、指标、限流三类执行器中间件,以及超时、资源清理、优雅关闭等生产实践。

使用方式:仓库含 TypeScript 与 Python 模板(basic-executor、async-executor、streaming-executor、batch-executor)、校验与测试脚本(scripts/validate-executor.sh、scripts/test-executor.sh)及示例(llm-executor、function-executor、workflow-executor、validation-executor)。运行校验:bash scripts/validate-executor.sh your-executor.ts;运行测试:bash scripts/test-executor.sh your-executor.ts。

适用场景:LLM 推理、文件处理、数据分析、文本生成、实时数据、批量操作与多步工作流编排等。

限制:协议版本为 A2A Protocol v1.0,运行时要求 Node.js 18+ 或 Python 3.9+;建议从基础执行器起步,按需增加异步、流式与批量复杂度。具体收费、价格与平台信息暂未提供。