Atmosphere

用于流式传输、可治理 AI Agent 的 JVM 运行时。通过 @Agent 声明行为；Atmosphere 负责处理传输、运行时调度、重连、授权、可观测性以及治理路径。

---

Atmosphere 专为那些要求 AI Agent 表现得如同生产级服务（Production Services）的团队而设计：支持通过真实传输协议进行流式传输、在每次工具调用前进行保护、按租户和运行实例进行可观测性监控，并能在不同的 AI 框架间移植，无需重写端点。

为什么选择 Atmosphere

需求	Atmosphere 提供的解决方案
流式传输到真实客户端	通过统一的广播器管道，支持 HTTP/3 上的 WebTransport、WebSocket、SSE、长轮询 (Long-polling) 和 gRPC
切换 AI 集成	统一的 AgentRuntime SPI，包含 12 个运行时适配器和经过契约测试的特性标志
执行治理	策略准入、@AgentScope、人工审批、计划与验证、成本上限、PII 重写以及管理员终止开关
人工干预暂停	耐久化的 HITL（人机协作）审批可挂起虚拟线程、持久化工作流状态，并通过 REST 审批界面恢复
恢复长流程运行	耐久化会话、运行 ID、重放缓冲区、检查点及支持重连的连续性
全渠道发布 Agent	浏览器端点及 MCP、A2A、AG-UI、Slack、Telegram、Discord、WhatsApp 和 Messenger 模块

适用范围

Atmosphere 是一个 JVM 框架，而非 Agent 托管平台。我们提供应用程序在运行时所需的底层基元（Primitives）；你所选择的主机环境（Tomcat、Jetty、Netty、Undertow、Quarkus、Spring Boot 或任何 Servlet 容器）负责计算和调度。与目前围绕 Cloudflare Agents、AWS Bedrock Agents 和 Vertex AI Agents 等产品出现的相关术语相比，其区别如下：

层级	Atmosphere 提供的内容	由你的技术栈提供
流式传输	atmosphere-runtime（WebTransport/HTTP3, WebSocket, SSE, 长轮询, gRPC）	—
运行时调度	atmosphere-ai AgentRuntime SPI + 12 个带契约测试标志的适配器	模型托管（我们仅调用提供商，不托管权重）
编排	@Coordinator, AgentFleet, 移交, 条件路由, 事件源协调日志, 结果评估, 以及基于 CheckpointStore 的耐久化休眠 Workflow（支持单步重试、JVM 重启后恢复，休眠时不占用线程）	Cron / 时钟调度（由你的容器调度程序或专用调度程序触发工作流）
内存	AiConversationMemory（按会话记录）、LongTermMemory（按用户记录）、SemanticRecallInterceptor（用于接入向量存储）	托管向量存储（可使用 Spring AI 的 VectorStore、LangChain4j 嵌入或你自己的实现）
治理	策略准入、@AgentScope、计划与验证、PII 脱敏、成本上限、耐久化 HITL 审批、管理员终止开关	—
协议接入	MCP, A2A, AG-UI, Slack/Telegram/Discord/WhatsApp/Messenger 通道适配器	支付渠道 / 商业基元（超出范围）
代码执行	atmosphere-sandbox SandboxProvider SPI + DockerSandboxProvider 默认实现	浏览器自动化、Headless Chromium
SDK	atmosphere.js (React, Vue, Svelte, React Native, 原生 TS), wasync (JVM 客户端)	—

其核心差异在于“流式传输 + JVM + 治理”的组合：在实时传输协议之上实现长生命周期的有状态 Agent 会话，并在关键路径上实施策略准入。对于那些空闲时应进入休眠的无状态、突发性自治 Agent，Serverless Agent 平台通常更合适。但对于需要在现有 JVM 架构内进行人机协作、多渠道交付、受治理的 Agent，Atmosphere 是理想之选。

快速开始

运行示例

brew install Atmosphere/tap/atmosphere

# 或者:
curl -fsSL https://raw.githubusercontent.com/Atmosphere/atmosphere/main/cli/install.sh | sh

atmosphere run spring-boot-multi-agent-startup-team

创建应用

atmosphere new my-agent --template ai-chat
cd my-agent
LLM_API_KEY=your-key ./mvnw spring-boot:run

切换运行时适配器

# 默认使用内置适配器。此命令会注入 Spring AI 适配器依赖。
atmosphere new my-agent --template ai-chat --runtime spring-ai

# 当示例已锁定运行时适配器时，使用 --force 强制覆盖。
atmosphere new my-agent --template ai-tools --runtime langchain4j --force

导入技能

atmosphere import https://github.com/anthropics/skills/blob/main/skills/frontend-design/SKILL.md
cd frontend-design
LLM_API_KEY=your-key ./mvnw spring-boot:run

术语表