Skip to content

特性

核心特性

  • ReAct 引擎DefaultReActAgent 实现完整的推理-行动循环,支持可配置迭代上限、流式响应和多层错误恢复
  • 6 级上下文压缩管道 — 渐进式管道(Snip → Micro → Collapse → Auto → Partial → 熔断器),采用"Facts First"策略尽可能保留原始上下文
  • 56 个内置工具 — 文件操作(Read/Write/Edit/Glob/Grep/Patch/MultiEdit/NotebookRead/NotebookEdit)、执行(Bash/Monitor)、Web(WebFetch/WebSearch)、Git(GitLog/GitDiff/GitShow/GitBlame/GitStash/GitCommit)、交互(AskUser/TodoRead/TodoWrite)、技能(SkillList/SkillLoad/SkillManage)、Agent 操作(Spawn/Message/Team/Plan)、计划模式(PlanRead/PlanWrite)、记忆(MemoryRead/MemoryWrite)、Cron(CronList/CronCreate/CronDelete)、代码智能(LspDiagnostics/LspReferences/LspDefinition)
  • 读写分区 — READ_ONLY 工具并行执行,WRITE/SYSTEM_CHANGE 工具自动串行化
  • 人机协作 — 三态权限模型(ALLOWED/ASK/DENIED),通过 PermissionGuard 控制
  • 多 Agent 编排TeamCoordinator SPI(默认 expert-team 编排:plan → generate → evaluate)和进程内 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 自动清理
  • 插件系统 — 兼容 Claude Code 格式的插件系统,5 种安装来源(LocalPath/GitHub/GitUrl/GitSubdir/Npm),支持 skills、hooks、MCP 服务器、agents 组件
  • 网关 — 通过 Gateway SPI 实现多 Channel 路由、会话管理、流式传输、镜像
  • 执行沙箱 — ExecutionSandbox SPI,默认 LocalProcessSandbox,安全命令执行
  • 工作空间提供者 — WorkspaceProvider SPI,路径穿越防御
  • 租户上下文 — TenantContextHolder,Reactor 上下文传播,多租户隔离
  • Bridge SPI — 基于 WebSocket 的 IDE 集成(5 个操作目录)
  • ACP — Agent Client Protocol 编辑器集成(基于 stdio 的 JSON-RPC,支持 initialize/session.new/session.prompt)
  • LSP 诊断 — 编辑后基线 diff("这次编辑是否引入了新错误?"),snapshotBaseline + notifyChange + diagnosticsSince
  • Cron 调度器 — 内置定时任务执行,通过 CronList/CronCreate/CronDelete 工具管理

模型支持

提供商模型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