google/ax

AX

[! ВНИМАНИЕ] AX и несколько её функций находятся в активной разработке. Мы активно участвуем совершенствовать наши основные концепции, протоколы и спецификации, и, вероятно, это будет вводят серьёзные изменения в срывах перед стабильным релизом.

Объявить агентную задачу с рабочими пространствами и спецификациями модели. AX использует её в песочницу, подключает рабочее пространство и помогает запускать его в масштабе.

AX — это высокопроизводительный, декларативный оркестратор для выполнения миллиардов автономных нагрузок агентов в кластере. Он работает поверх Agent Substrate для песочницы и рассчитан на миллиарды задач на кластер. Если вы использовали Kubernetes, ax будет ощущаться похоже.

Затем нанеси его, наблюдай, как он поднимается, и посмотри через плечо агента:

Почему?

Агенты — это новый тип нагрузки. Они не являются микросервисами без состояния и не являются пакетными заданиями от запуска до завершения. Они накапливают состояние, требуют строгой изоляции, вызывают API модели и серверы инструментов, и могут сжигать деньги в цикле, если никто не наблюдает. AX даёт три небольших примитива, которые обрабатывают всё это декларативно:

AX

[!WARNING] AX and several of its features are in heavy development. We are actively refining our core concepts, protocols, and specifications, and will likely introduce major breaking changes prior to a stable release.

Declare an agentic task with workspaces and model specifications. AX sandboxes it, wires up its workspace, and helps running it at scale.

AX is a highly efficient, declarative orchestrator to run millions of autonomous agent workloads in a cluster. It runs on top of Agent Substrate for sandboxed execution and is built to run millions of tasks per cluster. If you have used Kubernetes, ax will feel similar.

# task.yaml
apiVersion: ax.io/v1alpha1
kind: Workspace
metadata:
  name: golang
spec:
  git:
    - repo: https://github.com/golang/go.git
      branch: "my-fix"
  files:
    - path: "AGENTS.md"
      content: |
        - Run `go test` to ensure that tests are passing.
        - Do not modify the public API.
---
apiVersion: ax.io/v1alpha1
kind: Task
metadata:
  name: test
spec:
  image: "ghcr.io/my-org/my-coding-agent@sha256:..."
  config:
    goal: "Fix what's broken please."
  workspace:
    name: golang
  debug: true   # enables `ax ssh`

Then apply it, check on it, and look over the agent’s shoulder:

ax apply -f task.yaml
ax describe task test
ax ssh test -- ls -al /workspace

Why?

Agents are a new kind of workload. They are neither stateless microservices nor run-to-completion batch jobs. They accumulate state, need strict isolation, call out to model APIs and tool servers, and can burn money in a loop if nobody is watching. AX gives you three small primitives that handle all of that declaratively:

Everything is expressed as ax.io/v1alpha1 manifests and applied with a single command.

Quick start

Prerequisites

AX schedules every task as a sandboxed actor on Agent Substrate, so Substrate must be running in your cluster before you deploy AX. You need:

• A Kubernetes cluster with Agent Substrate installed (see below)
• Go and kubectl
• Podman or Docker, authenticated to a container registry your cluster can pull from