人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习【免费下载链接】agent-core-javaopenJiuwen agent core Java是 openJiuwen Core的 Java版本提供AI Agent开发、运行、调优与演进相关的全套SDK能力。项目地址https://gitcode.com/openJiuwen/agent-core-java点击查看免费下载本指南面向使用 openJiuwen agent-core-javaopenJiuwen Core 的 Java 版本的开发者系统梳理核心命名空间com.openjiuwen.core下 13 个功能模块的定位、子包结构、核心公开类型与阅读导航路径。读完本文你将掌握从命名空间落地页出发、沿文档树逐层定位任意 API 的完整方法并理解 Runner、ContextEngine、Operator、CompiledGraph、BaseGroup 等关键实现的源码级协作关系。一、命名空间定位com.openjiuwen.core是什么com.openjiuwen.core是 openJiuwen Java 核心包的命名空间级落地页namespace-level landing page位于仓库的 documents/zh/2.开发指南/API文档/com.openjiuwen.core/README.md。它本身不承载具体类的 API 细节而是把整个核心包按领域拆分为 13 个模块树作为进入各子包、再深入具体类型页面的第一入口。对应的 Java 源码根包位于 core/src/main/java/com/openjiuwen/core实际包含application、common、context、controller、foundation、graph、kvcache、memory、multiagent、multitenant、operator、retrieval、runner、security、session、singleagent、sysop、workflow等目录。文档树中的 13 个模块与源码根包一一对应其中kvcache、memory、multitenant、retrieval、workflow等能力被收纳在context、session、foundation等文档模块之下组织呈现。该核心包整体作为 AI Agent 开发、运行、调优与演进的 SDK 基座既提供单智能体ReAct、Controller与多智能体分组运行能力也提供工作流图执行、会话状态、上下文窗口管理、系统操作、安全护栏等横切能力。二、阅读流程Reading Flow如何在文档树中导航主文档明确给出了三条导航原则从模块 README 开始先确定你需要的能力属于哪个模块例如模型调用属foundation、会话状态属session、图执行属graph再进入对应的模块 README逐层下钻每个模块 README 都会继续链接到子包 README 与主要公开类型页面形成模块 → 子包 → 类型的层级与全局导航对齐仓库的 documents/zh/SUMMARY.md 镜像了同一棵文档树保证包 README 页面与全局侧边导航始终一致。SUMMARY.md 中com.openjiuwen.core条目下依次挂载application、common、context、controller、foundation、graph、multiagent、operator、runner、security、session、singleagent、sysop各模块及全部子包、类型页面与主文档模块表一一对应。建议的阅读路径是先读完本文的模块地图按业务场景锁定目标模块再沿链接进入对应子包 README 和类型页最后回到源码验证行为。三、模块地图13 个核心模块全景1. application —— 应用层 Agent 与配置 Schema模块入口application.README.md该模块提供应用层 Agent、配置 Schema 与工作流相关类型覆盖三个子包子包说明llmReAct 风格 Agent、控制器封装与任务中断状态对象LlmAgent、LlmController、LlmEventHandler、TaskInterruptionStateschema应用层 Agent 配置、工作流引用、默认响应与约束模型LlmAgentConfig、ReActAgentConfig、WorkflowAgentConfig、WorkflowSchema、AgentMemoryConfig、ConstrainConfig、DefaultResponse、PluginSchemaworkflow工作流 Agent、控制器与意图识别结果类型WorkflowAgent、WorkflowController、WorkflowEventHandler、WorkflowIntent该模块是面向应用开箱即用的一层配置对象以 DTO 形式集中方便上层直接装配。文档明确以LlmAgent.java、WorkflowAgent.java、相关 Schema 类型和应用层回归测试为依据。2. common —— 共享基础能力模块入口common.README.mdcommon汇总框架共享的基础设施串联六个子包子包说明exception统一状态码、异常层级、模板生成工具及按领域细分的异常封装logging日志接口、日志实现与相关事件类型security安全校验、防护与敏感路径处理相关类型utils通用工具函数与辅助类schema共享 card、参数与内容数据结构constants公共常量与轻量枚举根级核心类型是VirtualThreadSupport在 Java 17 编译基线下的 JDK21 虚拟线程运行时兼容层SDK 内部和业务侧均可复用JDK21 使用虚拟线程JDK17 回退到平台线程相关讨论可参见 Java版本与虚拟线程兼容。3. context —— 上下文引擎与窗口管理模块入口context.README.mdcontext提供上下文引擎、上下文窗口、统计对象以及状态持久化和卸载扩展抽象覆盖四个子包子包说明context会话上下文实现、消息缓冲、重载工具与 KV Cache 管理processor上下文处理器抽象以及压缩器compressor和卸载器offloader实现schema上下文引擎配置与卸载消息 schematokenToken 计数抽象与默认启发式实现根级类型包括ContextEngine上下文生命周期管理入口、ContextStats消息数/轮次数/token 统计快照、ContextWindow发往 LLM 的系统消息、上下文消息、工具定义与统计聚合、ModelContext上下文实现的抽象契约、OffloadCapableContext支持卸载消息的扩展接口、StatefulContext保存/恢复上下文状态的接口。源码印证在 core/src/main/java/com/openjiuwen/core/context/ContextEngine.java 中可以看到ContextEngine通过静态注册表内置了 8 种处理器工厂——DialogueCompressor、RoundLevelCompressor、CurrentRoundCompressor、MicroCompactProcessor、FullCompactProcessor压缩类以及MessageOffloader、MessageSummaryOffloader、ToolResultBudgetProcessor卸载/预算类并通过ConcurrentHashMap维护contextPool上下文池。文档注明该实现对应 Python 版context_engine.py。处理器注册机制与子包processor的压缩器/卸载器实现一一对应。4. controller —— 控制器运行时模块入口controller.README.mdcontroller提供 ControllerAgent 的控制器主入口以及围绕事件分发、任务调度、意图识别和控制器输入输出模型的基础类型子包说明legacy旧版控制器兼容层保留早期事件模型、reasoner 和任务结构modules事件处理器、事件队列、任务执行器、任务管理器、调度器与意图识别基础设施schema控制器输入事件、任务与意图模型、输出 chunk/payload 与状态枚举核心类型Controller主入口协调EventQueue、TaskScheduler、TaskManager与EventHandler、ControllerConfig定义并发、超时、事件队列与意图识别参数。文档强调新业务优先参考modules与schema只有兼容旧版调用时才进入legacy。5. foundation —— 基础能力层模块入口foundation.README.mdfoundation汇总基础能力层 API当前包含四个子模块模块说明llm统一模型调用入口与会话调度能力prompt提示模板与占位符组装能力store存储与检索相关 API 的组织入口tool工具调用、MCP 与 REST schema 相关 APIfoundation是模型接入的基座llm子包管理统一模型调用tool子包支撑工具调用与 MCP 接入RunnerConfig中的mcp_servers配置即用于ToolManager初始化。文档提示当前 F01 巡检范围重点覆盖llm及其子包。6. graph —— 工作流图执行模块入口graph.README.mdgraph提供工作流图定义、节点执行封装、编译入口以及基于 Pregel 的图构建能力是 Workflow 的执行引擎子包说明pregelPregel/BSP 运行时、channel 路由、中断处理、循环执行与任务调度原语store图状态持久化抽象、序列化器以及CompiledGraph使用的内存存储实现stream_actor流式节点、payload 协议、consumer、processor 与 transform 辅助能力visualization可绘制图模型以及生成 Mermaid 工作流可视化所需的辅助类型核心类型包括AtomicNode原子节点基类、CompiledGraph封装 Pregel 引擎与 Checkpointer 的可执行图、Executable/ExecutableGraph通用执行体、Graph节点、边与编译流程管理、GraphNodeState、PregelGraph基于 Pregel 的图构建器、Router条件边路由函数接口、Vertex节点生命周期运行时包装器。源码印证在 core/src/main/java/com/openjiuwen/core/graph/CompiledGraph.java 中CompiledGraph内部持有Pregel pregel与GraphCheckpointer checkpointer两个组件invokeInternal在主线执行前调用checkpointer.preWorkflowExecute(session, inputs)随后将规范化后的PregelConfig交给pregel.run(...)完成实际执行。代表性测试为CompiledGraphTest、PregelTest位于 core/src/test/java/com/openjiuwen/core 测试树。7. multiagent —— 多 Agent 分组模块入口multiagent.README.mdmultiagent提供新版多 Agent 分组抽象、运行时配置及顶层会话门面模块说明legacy已废弃的ControllerGroup/GroupEvent/ legacy schema 兼容层schemaGroupCard与EventDrivenGroupCard等分组身份模型核心类型BaseGroup基于 Card Config 模式的抽象分组基类、GroupConfig并发上限与超时配置、MultiAgentSessions在multiagent包内创建Session的静态门面、SessionAgentGroupSessionApi的包级别别名保留com.openjiuwen.core.session.Session导入入口。源码印证在 core/src/main/java/com/openjiuwen/core/multiagent/BaseGroup.java 的类注释中明确了设计原则Card 必选定义 Group 是什么Config 可选定义 Group 如何运行所有配置方法支持链式调用与BaseAgent的设计对齐分组内部通过MapString, BaseAgent agents维护注册的 Agent。MultiAgentFacadeTest验证了Session与MultiAgentSessions.createAgentGroupSession(...)的会话 ID / env 透传行为。8. operator —— 原子算子抽象模块入口operator.README.mdoperator定义 openJiuwen 的原子算子抽象以及围绕 LLM、Memory、Tool 调用的具体算子实现模块说明legacy旧版LLMCall兼容入口保留 optimizer callback 风格回调llm_call基于Model的 LLM 调用算子与兼容别名memory_call记忆调用算子、记忆调用回调及最小 memory 契约tool_call工具直连/路由调用算子、执行结果与 registry 契约核心类型Operator所有算子的抽象基类、OperatorStream带显式close()钩子的迭代式流包装、TunableSpec描述单个可调参数的 record含类型、路径和约束信息。源码印证在 core/src/main/java/com/openjiuwen/core/operator/Operator.java 中Operator是抽象基类统一约束getOperatorId()、getTunables()、getState()状态快照供检查点与回滚使用、setParameter()直接参数替换与applyUpdate()结构化更新兼容 Python 侧的REPLACE_MODE/STATE_EFFECT协议返回ApplyResult。算子与agentevolvingAgent 演进包联动是自优化与强化学习场景的调参载体。9. runner —— 全局运行器模块入口runner.README.mdrunner提供全局运行器入口、运行配置及分布式运行所需的消息队列配置是框架的总装车间子包说明base运行器资源注册和标签系统共用的 Provider、结果和标签基础类型callback事件驱动回调框架、过滤器、链式执行和指标统计能力drunner分布式 Runner 的运行时入口及消息队列启动流程mq本地消息队列抽象、内存实现及请求/流式消息封装resourcemanager统一管理 Agent、Workflow、Tool、Prompt、Model、MCP 与系统操作资源核心类型Runner全局单例门面代理RunnerImpl生命周期、资源管理器访问及 workflow / agent / agent group 执行入口、RunnerImpl装配资源管理器、本地消息队列、回调框架和分布式运行支持、RunnerConfig/DistributedConfig/MessageQueueConfig/MessageQueueType/PulsarConfig各类运行配置封装。源码印证在 core/src/main/java/com/openjiuwen/core/runner/Runner.java 中Runner是final单例门面静态字段GLOBAL_RUNNER new RunnerImpl(RunnerConfig.DEFAULT_RUNNER_CONFIG)并以静态方式对外暴露resourceMgr、pubsub本地消息队列、callbackFramework三个子系统入口——这正好对应RunnerImpl装配的三大部分。在 core/src/main/java/com/openjiuwen/core/runner/RunnerConfig.java 中可看到完整配置项均带 JacksonJsonProperty注解可直接由 JSON/YAML 反序列化配置字段JSON 键默认值说明distributedModedistributed_modetrueBuilder 默认分布式模式开关DEFAULT_RUNNER_CONFIG中实际为falsedistributedConfigdistributed_confignew DistributedConfig()分布式配置超时、消息队列类型等envPrefixenv_prefix环境变量前缀用于组装 agent/reply topic 模板instanceIdinstance_id随机 UUID运行实例标识checkpointerConfigcheckpointer_confignull检查点配置type conf支持 Map 快捷注入mcpServersmcp_servers空列表MCP 服务器配置供ToolManager初始化kvStoreConfigkv_store_confignullKV 存储配置type如in_memory/redisconf为属性 MapvectorStoreConfigvector_store_confignull向量存储配置RAG/检索如milvus/chromaobjectStorageConfigobject_storage_confignull对象存储配置附件/大对象如obs/s3enableSessionControllerenable_session_controllerfalse是否启用 session 控制器enableA2aenable_a2afalse是否启用 A2AAgent-to-Agent能力enableTenantIsolationenable_tenant_isolationfalse是否启用多租户数据隔离tenantDataRoottenant_data_rootnull租户数据根目录DEFAULT_RUNNER_CONFIG的默认分布式配置为requestTimeout 30.0、消息队列类型FAKE内存本地队列。全局配置可通过RunnerConfig.setRunnerConfig(...)/getRunnerConfig()静态读写getRunnerConfig()首次调用会惰性初始化默认配置副本。10. security —— 安全防护模块入口security.README.mdsecurity汇总安全防护 API当前公开类型集中在guardrail子包用于把风险分析后端接入回调框架事件流包含 Guardrail 抽象基类、风险分析后端协议、风险结果模型与内置用户输入护栏。文档说明当前源码范围只有guardrail子包没有根包下独立的公开类型。该模块与 安全护栏Guardrail、工具护栏ToolGuardrail 等使用指南配套。11. session —— 会话状态与流式输出模块入口session.README.mdsession汇总对外会话门面、基础会话抽象以及状态、流式输出、交互、回调、存储和追踪相关子包是 Agent 运行时的状态中枢模块说明callback会话回调处理器、管理器注册与触发注解checkpointer检查点生命周期、工厂注册与存储适配config会话环境变量、工作流配置与 agent 配置constants会话相关环境变量键与配置常量interaction用户交互载荷、打断恢复流程与等待逻辑internal内部运行时 session 实现、包装器与子工作流会话state状态读写、提交回滚抽象与内存实现store文件型与内存型会话持久化存储stream流模式、schema、发射器、队列与 writer 管理tracertracing span、handler、decorator 与辅助工具utils嵌套路径与状态更新相关工具核心类型AgentGroupSessionApi面向 agent group 的会话门面、AgentSessionApi面向单个 agent 的高层会话 API、BaseSession暴露配置、状态、流式输出和回调子系统的基础抽象、NodeSessionApi面向工作流节点的简化会话 API、ProxySession全部调用转发给底层BaseSession的代理实现、SessionContextEngine依赖的最小会话接口、WorkflowSessionApi面向工作流执行生命周期的会话门面。相关测试AgentSessionApiTest、SessionBasicTest、SessionTest、SessionUtilsTest。12. singleagent —— 单智能体运行时模块入口singleagent.README.mdsingleagent提供单智能体运行时的基础抽象、能力管理、回调编排以及面向Controller与 ReAct 的入口类型模块说明agents主要的 ReAct 实现、配置对象和可演进变体legacylegacy 兼容层文档入口railrail 生命周期事件、上下文载荷与重试辅助类型schema单智能体运行时使用的卡片、结果与制品模型skillsskills 子包文档入口核心类型AbilityExecutionError统一封装能力执行失败的异常、AbilityManager管理工具、工作流、agent 与 MCP 服务能力卡片、AgentCallbackManager回调与 rail 的注册、注销和触发、BaseAgent单智能体抽象基类、ControllerAgent基于Controller的单智能体实现、ReActAgent/ReActAgentEvolve对agents子包实现的顶层便捷别名。源码印证在 core/src/main/java/com/openjiuwen/core/singleagent/BaseAgent.java 中可以看到BaseAgent同时依赖ModelContext、AgentSessionApi、AgentCard、rail 回调AgentCallback/AgentRail与 skills 相关类型Skill、SkillToolRegistry、SkillToolBinding是单智能体能力的汇聚点测试覆盖包括ReActAgentTest、ReActAgentEvolveTest、ControllerAgentTest、BaseAgentTest、AgentCallbackManagerTest等。13. sysop —— 系统操作模块入口sysop.README.mdsysop提供系统操作门面、基础抽象、运行模式及工具 ID 组装能力子包说明config本地执行与沙箱网关共用的运行配置对象local基于本地进程和 Java NIO 的文件、命令、代码执行实现registryOperation注解、操作定义对象和注册中心result系统操作统一结果封装、数据载荷和流式 chunk DTOsandbox沙箱模式下的文件、命令、代码执行包装类型核心类型BaseCodeOperation/BaseFsOperation/BaseShellOperation三类操作抽象基类、BaseOperation统一封装操作名称、运行模式、描述和配置、FsConstants文件块大小常量、OperationModeLOCAL与SANDBOX两种运行模式、SysOperation按SysOperationCard装配并缓存操作实例的门面、SysOperationCard操作卡片元数据与本地/沙箱配置、SysOperationToolAdapter把操作封装成LocalFunction工具、ToolIdProxy生成cardId.opType.methodName形式工具 ID。测试覆盖OperationModeTest、SysOperationTest、SysOperationCardTest、SysOperationToolAdapterTest及本地执行测试。该模块与 系统操作、沙箱 使用指南配套。四、从文档树到源码一条完整的验证路径以执行一个工作流为例可串联上述模块的协作关系配置装配runner.RunnerConfig源码定义分布式、MCP、KV/向量/对象存储等全局配置入口调度runner.Runner单例门面源码暴露resourceMgr、pubsub、callbackFramework代理 workflow / agent / agent group 执行入口图执行graph.CompiledGraph源码将Pregel引擎与GraphCheckpointer组合通过pregel.run(PregelConfig)驱动节点执行会话状态session.BaseSession及各类 Session API 提供状态、流式输出与回调上下文管理context.ContextEngine源码通过 8 种内置压缩/卸载处理器维持上下文窗口模型与工具foundation.llm统一模型调用foundation.tool支撑工具/MCP 接入调参演进operator.Operator源码提供 tunable 描述与结构化更新协议与agentevolving联动支持自优化。对应地在文档树中沿着 com.openjiuwen.core/README.md → 各模块 README → 子包 README → 类型页即可为上述每一环找到 API 级说明在 documents/zh/SUMMARY.md 中可以按同一棵树核对导航一致性。五、使用建议按场景选择入口接入模型看foundation/llm编排 Agent 能力看singleagent与multiagent构建/执行工作流看application/workflow与graph管理运行生命周期看runner与session治理上下文看context安全防护看security/guardrail执行系统命令与文件操作看sysop。新旧分层识别多个模块保留了legacy兼容子包controller/legacy、multiagent/legacy、operator/legacy、singleagent/legacy。文档明确建议新业务优先使用modules/schema/ 新抽象仅在兼容旧调用路径时进入legacy。以源码与测试为最终依据各模块 README 均标注了依据源码与测试如CompiledGraphTest、PregelTest、AgentSessionApiTest、MultiAgentFacadeTest等需要确认行为时可直接在 core/src/test/java/com/openjiuwen/core 测试树中查找对应用例。赞分享人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习【免费下载链接】agent-core-javaopenJiuwen agent core Java是 openJiuwen Core的 Java版本提供AI Agent开发、运行、调优与演进相关的全套SDK能力。项目地址https://gitcode.com/openJiuwen/agent-core-java点击查看免费下载相关推荐openJiuwen agent-core-java 核心 API 全景解析com.openjiuwen.core 十六大模块导航与源码脉络openJiuwen agent core java 核心 API 全景解析com.openjiuwen.core 十六大模块导航与源码脉络 com.open人工智能AI AgentAgent 框架工具调用Agent 工作流RAGMCP Clients强化学习APITable core 包架构解析技术模块与业务模块全景指南APITable core 包架构解析技术模块与业务模块全景指南 导读 packages/core npm 包名 apitable/core 是 API低代码后端前端协同办公openJiuwen agent-core 技能打包与 skill_id 管理skill_package 模块全解析openJiuwen agent core 技能打包与 skill_id 管理skill_package 模块全解析 导读 本文深入剖析 openJiuwen人工智能AI AgentAgent 框架大模型工具调用RAG提示工程强化学习上一篇SearXNG 开机自启实战用 systemd 托管 Docker 服务的保姆级教程下一篇TrafficMonitor硬件监控插件完整上手指南任务栏实时看CPU/GPU温度一学就会创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
