Repolode
google

google/ax

AX 是一个声明式编排工具,用于在 Kubernetes 集群中运行大量沙箱化的自主智能体任务。

Star
13,963
Fork
723
未关闭 Issue
91
最近提交
22小时前

这是什么?

AX 通过 YAML 清单描述智能体任务,包含 Task、Workspace、Model 三类资源。Task 在带 CPU 和内存限制的隔离沙箱中运行;Workspace 预先配置 Git 仓库、MCP 服务器和技能包,让智能体启动时工具已就绪;Model 指定平台使用的大模型,凭据来自 Kubernetes Secret。清单使用 ax.io/v1alpha1 API,通过 ax 命令行工具提交,命令风格与 kubectl 相近。

AX 基于 Agent Substrate 执行沙箱任务。支持通过 ax suspend 对空闲任务做检查点并暂停,之后用 ax resume 恢复;也可以用 ax ssh 进入运行中的沙箱进行调试。命令行通过 gRPC 与控制面通信,并依据当前 kubectl 上下文定位集群。

项目仍处于高强度开发阶段,核心概念、协议和 API 可能在稳定版本前出现破坏性变更。安装前需要一个已部署 Agent Substrate 的 Kubernetes 集群。

核心功能

  • 01通过声明式的 Task、Workspace、Model 清单统一描述智能体任务,一条命令即可提交。
  • 02在带 CPU 和内存限制的沙箱中运行任务。
  • 03支持对运行中的智能体任务做检查点,并暂停与恢复。
  • 04使用 ax ssh 进入运行中的沙箱执行命令或交互式调试。
  • 05命令风格类似 kubectl,并跟随当前 Kubernetes 上下文切换集群。

适用场景

  • 在 Kubernetes 集群中隔离运行大量不可信或自主运行的智能体任务。
  • 预先配置 Git 仓库和 MCP 工具服务器,让智能体启动即具备所需上下文。
  • 暂停长时间空闲的智能体,之后恢复运行且不丢失状态。

快速上手

  1. 1

    在 Kubernetes 集群中安装 Agent Substrate 并验证其 API 服务

    kubectl get svc api -n ate-system
  2. 2

    安装 ax 命令行工具

    go install github.com/google/ax/cmd/ax@latest
  3. 3

    使用你的容器镜像仓库部署 AX 控制平面

    make deploy AX_IMAGE_REPO=<your-registry>
  4. 4

    应用示例任务并查看其状态

    ax apply -f examples/task.yaml

使用前须知

  • 运行前需要一个已安装 Agent Substrate 的 Kubernetes 集群。
  • 项目仍在大量开发中,在稳定版发布前很可能出现重大破坏性变更。

标签

常见问题

ax 是什么?
AX 是一个声明式编排工具,用于在 Kubernetes 集群中运行大量沙箱化的自主智能体任务。 AX 通过 YAML 清单描述智能体任务,包含 Task、Workspace、Model 三类资源。Task 在带 CPU 和内存限制的隔离沙箱中运行;Workspace 预先配置 Git 仓库、MCP 服务器和技能包,让智能体启动时工具已就绪;Model 指定平台使用的大模型,凭据来自 Kubernetes Secret。清单使用 ax.io/v1alpha1 API,通过 ax 命令行工具提交,命令风格与 kubectl 相近。
ax 可以免费使用吗?用的什么许可证?
ax 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
ax 还在维护吗?
活跃维护中。ax 最近一次提交是在 2026年10月18日。
ax 适合用来做什么?
在 Kubernetes 集群中隔离运行大量不可信或自主运行的智能体任务。 预先配置 Git 仓库和 MCP 工具服务器,让智能体启动即具备所需上下文。 暂停长时间空闲的智能体,之后恢复运行且不丢失状态。
ax 怎么安装和运行?
在 Kubernetes 集群中安装 Agent Substrate 并验证其 API 服务: kubectl get svc api -n ate-system 安装 ax 命令行工具: go install github.com/google/ax/cmd/ax@latest 使用你的容器镜像仓库部署 AX 控制平面: make deploy AX_IMAGE_REPO=<your-registry> 应用示例任务并查看其状态: ax apply -f examples/task.yaml
在哪里获取 ax?
源代码和安装说明在 GitHub 上:https://github.com/google/ax

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目