Google开源智能体编排运行时AX：分布式AI Agent运行时的完整入门指南

Google开源智能体编排运行时AX分布式AI Agent运行时的完整入门指南【免费下载链接】axGoogles open agentic orchestration runtime项目地址: https://gitcode.com/GitHub_Trending/ax11/axAXAgent Executor是 Google 开源的分布式智能体编排运行时为长时间运行的 AI Agent 提供隔离执行环境、失败自动恢复Resumption和持久化事件日志。本文带你从零开始快速上手这个面向分布式 AI Agent 场景的运行时。⚠️ 注意AX 目前处于早期积极开发阶段early development在稳定版本发布前可能有较大破坏性变更。一、AX 是什么为什么需要 Agent 编排运行时传统的 AI Agent 应用往往是单体式的——工具、技能、模型调用都写在一个进程里。但随着 Agent 从简单助手演变为长时间自主运行的工作者新需求出现了工具、技能、Agent 需要部署为相互隔离的 Actor独立执行与扩展Agent 任务可能计算一阵后闲置数小时例如等待人工审批长期占用有状态进程成本极高执行过程必须可审计、可恢复故障后能从断点继续而不是从头重来。AX 正是为这些缺口而生的基础层它从可挂起/可恢复的镜像中动态拉起隔离环境来执行 Harness 和 Agent并且对计算层保持中立同时在 Kubernetes 上提供最佳体验。核心特性一览特性说明 分布式运行时Harness、技能、工具、Agent 可隔离执行 断点恢复从故障或中断中自动恢复执行 内置 Harness支持前沿 Harness如 Antigravity与自定义实现 可移植性随处运行支持从单机到大规模集群⚙️ 高度可定制支持自定义环境、MCP 工具、技能、指令等在一致性保障方面AX 内置了三大机制单写者架构Single-Writer由单一控制器保证状态一致、持久事件日志Event Log执行状态自动恢复、高级恢复在兼容平台上支持计算层 Actor 的挂起与恢复。 架构细节与历史背景可见项目文档README.md二、安装与快速开始5 分钟跑通第一个 Agent1. 安装 ax CLIAX 用 Go 语言编写安装只需一条命令go install github.com/google/ax/cmd/axlatest ax --help # 验证安装是否成功CLI 入口的源码位于 cmd/ax/main.go它定义了exec执行对话与serve启动控制器服务两个核心命令。2. 配置认证二选一内置的 Antigravity Harness 支持 Google AI Studio 和 Vertex AI 两种后端# 方式一Google AI Studio最简单推荐新手 export GEMINI_API_KEYyour-api-key # 方式二Vertex AI适合已有 GCP 项目的团队 gcloud auth application-default login export GOOGLE_CLOUD_PROJECTyour-project-id export GOOGLE_CLOUD_LOCATIONus-central1 export GOOGLE_GENAI_USE_VERTEXAItrue3. 第一次对话最简单的调用方式CLI 会自动启动内置的 Antigravity Harness无需额外搭建 Harness 服务器ax --input Can you list this directory?如果一切顺利你会看到 Agent 的流式回复。就这么简单——你已经在运行一个由 AX 编排的 AI Agent 了 三、会话管理续聊、恢复与服务模式继续一个会话AX 的每次执行都属于一个Conversation会话由 UUID 标识。拿到会话 ID 后随时可以继续ax --conversation d85a4b4e-c53b-4c84-b879-f10d905bce40 \ --input Show me the contents of README.md恢复一次中断的执行这是 AX 最亮眼的特性如果 Harness 执行中途出错你可以从断点续跑而不必推倒重来ax --conversation edf98ef5-4bb1-4a9e-a091-3a77e03727e6 --resume连接独立的 gRPC 服务器加上--server参数即可把执行请求发给远程的 AX 控制器不指定时CLI 会在本地内嵌一个 AX 服务器ax --server localhost:8494 --input Can you write me a simple HTTP server in Python?此外还支持--agent-config/--agent-config-file允许按请求传入 JSON 配置例如指定系统指令和模型ax --agent-config {system_instructions:Answer in one sentence.,model:gemini-3.5-flash} \ --input Explain durable execution.启动 AX 控制器服务器ax serve命令会把控制器跑成一个 gRPC 服务配置从 YAML 文件加载默认 ax.yamlax serve # 使用默认配置 ax.yaml ax serve --config my.yaml默认的 ax.yaml 展示了完整配置项服务监听地址:8494、事件日志的 SQLite 存储路径以及内置的 Antigravity Harness 与遥测OTLP开关。服务器启动逻辑见 cmd/ax/serve.go。四、扩展 AX自定义 Harness、Skills 与 MCP 工具AX 的强大在于一切皆可插拔三大扩展点如下1️⃣ Harness执行外壳Harness 是 AX 中最核心的抽象定义了启动执行会话的统一边界。除了内置的 Antigravity你可以实现HarnessService接口把传统 Agent工具调用型、工作流型甚至语言模型本身封装为 Harness。在支持的计算平台如 Agent Substrate上AX 会自动将其隔离运行并自动挂起/恢复。接口定义见 internal/harness/harness.go。2️⃣ Agent Skills智能体技能内置的 Antigravity Harness 原生支持 Agent Skills——用SKILL.md描述技能、用脚本实现能力。项目自带两个可直接参考的示例Emoji 技能examples/skills/emoji/SKILL.md小写转换技能examples/skills/lowercase/SKILL.md3️⃣ MCP 工具配置好 MCP 服务器后Harness 可自动发现并调用MCP 工具让 Agent 无缝接入外部工具生态。五、部署到 Kubernetes生产级 Agent 运行时对于生产环境AX 推荐部署在 Kubernetes 上的Agent Substrate提供更高密度的 Agent 沙箱算力。manifests/ 目录包含完整的清单文件与安装脚本export GOOGLE_CLOUD_PROJECTax-substrate export GEMINI_API_KEYyour-api-key export AX_EVENTLOG_DSNpostgres://user:passhost:5432/db?sslmoderequire ./manifests/install-ax.sh --deploy-ax-server关键要点事件日志存储在 Postgres 中默认使用你自备的数据库也可加--deploy-postgres让脚本在集群内部署一个测试用的 Postgres安装脚本自动构建并推送 3 个镜像ax 主程序、ax-antigravity Python 侧车、ateom 工作节点部署后通过kubectl port-forward转发 8494 端口再用ax --serverlocalhost:8494 --inputhello做端到端验证日常巡检可用kubectl ate get actors查看运行中的 Actor 状态。完整步骤、Vertex AI 权限配置与卸载方法详见部署指南manifests/README.md六、AX 不是什么以及路线图官方明确了两条边界避免误解不是托管服务AX 是自建自运维self-hosted的开源运行时不是 Agent 框架AX 对构建 Agent 所用的框架完全中立。已公布的路线图包括Elicitation主动询问支持、恢复协议改进、执行轨迹Trajectory暴露、更完善的遥测、与 Google 注册表/网络策略的集成以及新增的FilesystemService。关于贡献AX 正处于架构重构期暂停接收外部 PR但欢迎提交 Issue 反馈 Bug 与功能建议。代码规范与测试流程见 CONTRIBUTING.md构建任务可用 Makefile 一键执行make test、make install等。项目采用 Apache 2.0 许可证LICENSE。七、总结AX 代表了 Google 对生产级 Agent 基础设施的一次开源输出核心价值可以浓缩为三点隔离与分布式Harness、技能、Agent 作为独立 Actor 动态拉起天然可扩展可靠的持久执行事件日志 单写者架构 断点恢复长任务不怕中断计算层中立 K8s 最优小到本地一条命令跑通大到 K8s 集群生产部署。如果你正在构建严肃的、长时间运行的 AI Agent 应用AX 值得立刻试用。它解决的正是从Demo Agent到生产 Agent之间最关键的那段路。【免费下载链接】axGoogles open agentic orchestration runtime项目地址: https://gitcode.com/GitHub_Trending/ax11/ax创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考