agent space api是flex框架内置的java接口层,非独立服务,用于agent间共享上下文与状态;由defaultagentspace实现,默认内存存储,需启用agents.flex.space.enabled=true才生效,不可直接http暴露。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要弄清Agent Space API和Flex的关系,必须先明确二者在Agents-Flex框架中的定位:Agent Space API不是独立服务,而是Flex框架内部用于管理智能体运行时上下文与共享状态的核心接口层。
Agent Space API的本质
Agent Space API是一组Java接口定义(如AgentSpace、AgentContext),位于agents-flex-core模块的com.agentsflex.space包下。它不对外暴露HTTP端点,也不单独部署。
这组API的作用是为多个协同工作的Agent提供统一的“共享工作台”——所有Agent实例可通过它读写会话级变量、传递中间结果、触发跨Agent事件。比如一个数据分析Agent把清洗后的DataFrame存入Agent Space,后续报告生成Agent就能直接获取,无需通过外部数据库中转。
Flex框架如何承载Agent Space API
Flex框架通过DefaultAgentSpace实现类将该API落地。该实现默认基于内存Map,支持插件化替换为Redis或Consul后端。
启动时,Flex容器自动初始化一个单例AgentSpace实例,并注入到每个AgentExecutor中。你无需手动构造或注册——只要使用@Agent注解声明智能体,其执行上下文就天然具备对Agent Space的访问能力。
【必须启用agents.flex.space.enabled=true】否则Agent Space功能被禁用,所有space.get()调用将返回null且不抛异常,极易导致空指针却难以定位。
与外部API网关的区别
有人误以为Agent Space API可通过HTTP调用,这是错误认知。它完全运行在JVM进程内,与Spring WebMVC或WebFlux无耦合。
若需对外暴露能力,应通过Flex提供的HttpSkill或自定义Controller封装——此时调用链是:HTTP请求→Controller→调用本地Agent→Agent内部通过Agent Space API协调子任务。
这一步不能跳过。直接把Agent Space API映射成REST端点会导致线程安全问题和状态泄漏,因为Agent Space设计初衷是单次会话内隔离,而非全局共享资源池。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











