Repolode
google

google/ax

AX é um orquestrador declarativo de código aberto para executar grandes quantidades de tarefas autônomas de agentes em sandboxes dentro de um cluster Kubernetes.

Estrelas
13,963
Forks
723
Issues abertas
91
Último commit
anteontem

O que é?

Com o AX, você descreve uma tarefa de agente em YAML usando três tipos de recursos: Task, Workspace e Model. Uma Task é executada em um sandbox isolado, com limites de CPU e memória; um Workspace pré-configura repositórios Git, servidores MCP e pacotes de skills para que os agentes já comecem com as ferramentas disponíveis; e um Model configura qual LLM a plataforma usa, com as credenciais obtidas de um secret do Kubernetes. Os manifests usam a API ax.io/v1alpha1 e são aplicados com a CLI ax, que segue os verbos do kubectl.

O AX usa o Agent Substrate para executar tarefas em sandboxes. Ele permite suspender uma tarefa ociosa com um checkpoint e retomá-la depois, além de abrir um shell em um sandbox em execução com ax ssh para depuração. A CLI se comunica com o control plane via gRPC e identifica o cluster pelo contexto ativo do kubectl.

O projeto está em intenso desenvolvimento, e seus conceitos, protocolos e APIs podem mudar com atualizações incompatíveis antes de uma versão estável. Para instalar o projeto, é necessário ter um cluster Kubernetes com o Agent Substrate já em execução.

Recursos principais

  • 01Manifests declarativos de Task, Workspace e Model, aplicados com um único comando.
  • 02Execução de tarefas em sandboxes com limites de CPU e memória.
  • 03Suspensão e retomada de tarefas de agentes em execução usando checkpoints.
  • 04Acesso interativo ao shell de um sandbox em execução com ax ssh.
  • 05CLI no estilo do kubectl, que segue o contexto ativo do Kubernetes.

Casos de uso

  • Executar grandes quantidades de workloads de agentes autônomos ou não confiáveis, isolados em um cluster Kubernetes.
  • Pré-configurar repositórios Git e servidores de ferramentas MCP para que os agentes comecem com o contexto necessário.
  • Pausar agentes ociosos de longa duração e retomá-los depois sem perder o estado.

Início rápido

  1. 1

    Instale o Agent Substrate no seu cluster Kubernetes e verifique o serviço de API

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

    Instale a CLI ax

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

    Implante o plano de controle do AX usando seu registro de contêineres

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

    Aplique a tarefa de exemplo e verifique o status

    ax apply -f examples/task.yaml

Antes de usar

  • O AX requer um cluster Kubernetes com o Agent Substrate instalado previamente.
  • O projeto está em pleno desenvolvimento e provavelmente terá mudanças significativas que quebram a compatibilidade antes de uma versão estável.

Tópicos

Perguntas frequentes

O que é ax?
AX é um orquestrador declarativo de código aberto para executar grandes quantidades de tarefas autônomas de agentes em sandboxes dentro de um cluster Kubernetes. Com o AX, você descreve uma tarefa de agente em YAML usando três tipos de recursos: Task, Workspace e Model. Uma Task é executada em um sandbox isolado, com limites de CPU e memória; um Workspace pré-configura repositórios Git, servidores MCP e pacotes de skills para que os agentes já comecem com as ferramentas disponíveis; e um Model configura qual LLM a plataforma usa, com as credenciais obtidas de um secret do Kubernetes. Os manifests usam a API ax.io/v1alpha1 e são aplicados com a CLI ax, que segue os verbos do kubectl.
ax é gratuito? Qual é a licença?
ax é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
ax ainda é mantido?
Manutenção ativa. O último commit de ax foi em 18 de out. de 2026.
Para que posso usar ax?
Executar grandes quantidades de workloads de agentes autônomos ou não confiáveis, isolados em um cluster Kubernetes. Pré-configurar repositórios Git e servidores de ferramentas MCP para que os agentes comecem com o contexto necessário. Pausar agentes ociosos de longa duração e retomá-los depois sem perder o estado.
Como instalar ax?
Instale o Agent Substrate no seu cluster Kubernetes e verifique o serviço de API: kubectl get svc api -n ate-system Instale a CLI ax: go install github.com/google/ax/cmd/ax@latest Implante o plano de controle do AX usando seu registro de contêineres: make deploy AX_IMAGE_REPO=<your-registry> Aplique a tarefa de exemplo e verifique o status: ax apply -f examples/task.yaml
Onde consigo ax?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/google/ax

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados