Skip to content

特性

核心特性

  • ReAct 引擎DefaultReActAgent 实现完整的推理-行动循环,支持可配置迭代上限、流式响应和多层错误恢复
  • 6 级上下文压缩管道 — 渐进式管道(Snip → Micro → Collapse → Auto → Partial → 熔断器),采用"Facts First"策略尽可能保留原始上下文
  • 21 个内置工具 — 文件操作(Read/Write/Edit/Glob/Grep)、执行(Bash/Monitor)、交互(AskUser)、技能(SkillList/SkillLoad)、Agent 操作(Spawn/Message/Task/Team/Plan)
  • 读写分区 — READ_ONLY 工具并行执行,WRITE/SYSTEM_CHANGE 工具自动串行化
  • 人机协作 — 三态权限模型(ALLOWED/ASK/DENIED),通过 PermissionGuard 控制
  • 多 Agent 编排 — TaskBoard、PlanBuilder、TeamScheduler 和进程内 MessageBus
  • A2A 协议 — Agent-to-Agent 通信标准(Google ADK 兼容),进程内发现 + 调用,团队自动注册
  • 中间件管道 — 声明式请求/响应拦截,通过 @MiddlewareOrder 实现横切关注点(日志、认证、限流)
  • Agent 快照/检查点 — 对话中序列化 Agent 状态,通过 AgentBuilder.restoreFrom(snapshot) 从检查点恢复
  • 结构化输出 — 调用模型返回类型化 POJO,格式错误时自动自纠正
  • Hook 生命周期 — 10 个钩子点(Pre/Post Reasoning、Acting 等),支持 CONTINUE/MODIFY/SKIP/ABORT/INJECT 决策
  • 熔断器 — 模型调用和工具调用的三态熔断器,支持可配置阈值
  • 循环检测 — 基于哈希 + 基于频率的双重检测,防止 Agent 无限循环
  • 协作取消 — 优雅的 Agent 终止,保留状态
  • MCP 集成 — StreamableHTTP + Elicitation Protocol,连接外部工具服务器
  • 技能系统 — Markdown 格式技能定义,TriggerGuard 反污染设计
  • 计划模式 — 规划与执行分离,规划期间写工具被阻止
  • 模型适配 — 深度 Anthropic 集成 + OpenAI 兼容回退(GLM、Qwen、GPT 等)
  • 会话持久化 — 基于文件的状态序列化,支持 TTL 自动清理

模型支持

提供商模型API 类型环境变量
AnthropicClaude Sonnet, Claude Opus, Claude Haiku原生 Anthropic APIANTHROPIC_API_KEY
智谱 AIGLM-4-Plus, GLM-4OpenAI 兼容GLM_API_KEY
DashScopeQwen-Plus, Qwen-Max, Qwen-TurboOpenAI 兼容QWEN_API_KEY
OpenAIGPT-4o, GPT-4, GPT-3.5OpenAI 兼容OPENAI_API_KEY
java
// Anthropic(原生 API)
AnthropicProvider claude = new AnthropicProvider(apiKey);

// GLM / Qwen / GPT(OpenAI 兼容)
OpenAIProvider provider = new OpenAIProvider(apiKey, baseUrl, "/chat/completions");

演示示例

Demo需要 API Key测试内容
AgentExample --mock基础 ReAct 循环(Mock 模型)
AgentExample --glmGLMGLM-4-Plus 的 ReAct 循环
AgentExample --qwenQwenQwen-Plus 的 ReAct 循环
FullToolsetExampleQwen全部 6 个工具:read, write, edit, glob, grep, bash
SkillExampleQwen技能系统:列出、加载和使用 Markdown 技能
MultiAgentExampleTaskBoard DAG 依赖追踪 + MessageBus 发布/订阅
SessionExampleFileMemoryStore + SessionSerializer 序列化往返
Spring Boot DemoREST API、流式输出、结构化输出、Hook、MCP