Repolode
제출하기
google

google/ax

AX는 Kubernetes 클러스터에서 다수의 샌드박스 자율 에이전트 작업을 실행하는 오픈소스 선언형 오케스트레이터입니다.

GitHub에서 보기웹사이트
스타
13,963
포크
723
열린 이슈
91
마지막 커밋
어제

어떤 프로젝트인가요?

AX에서는 Task, Workspace, Model 세 가지 리소스 종류를 사용해 YAML로 에이전트 작업을 정의합니다. Task는 CPU와 메모리 제한이 적용된 격리 샌드박스에서 실행되고, Workspace는 Git 저장소, MCP 서버, 스킬 패키지를 미리 연결해 에이전트가 필요한 도구를 갖춘 상태로 시작하게 합니다. Model은 플랫폼에서 사용할 LLM을 지정하며, 인증 정보는 Kubernetes secret에서 가져옵니다. 매니페스트는 ax.io/v1alpha1 API를 사용하고, kubectl과 비슷한 동사 형식을 따르는 ax CLI로 적용합니다.

AX는 샌드박스 실행을 위해 Agent Substrate 위에서 동작합니다. 유휴 상태인 작업을 체크포인트와 함께 일시 중지했다가 나중에 재개할 수 있으며, 디버깅을 위해 ax ssh로 실행 중인 샌드박스에 접속할 수도 있습니다. CLI는 gRPC를 통해 컨트롤 플레인과 통신하고, 활성 kubectl context를 기준으로 클러스터를 찾습니다.

이 프로젝트는 활발히 개발 중이며, 안정 버전이 출시되기 전까지 개념, 프로토콜, API가 호환성을 깨는 변경과 함께 바뀔 수 있습니다. 설치하려면 Agent Substrate가 이미 실행 중인 Kubernetes 클러스터가 필요합니다.

핵심 기능

  • 01단일 명령으로 적용하는 선언형 Task, Workspace, Model 매니페스트.
  • 02CPU와 메모리 제한이 적용된 샌드박스 작업 실행.
  • 03체크포인트를 이용해 실행 중인 에이전트 작업 일시 중지 및 재개.
  • 04ax ssh로 실행 중인 샌드박스에 대화형 셸 접속.
  • 05활성 Kubernetes context를 따르는 kubectl 스타일 CLI.

활용 사례

  • 신뢰할 수 없거나 자율적으로 동작하는 에이전트 워크로드를 Kubernetes 클러스터 안에서 격리해 다수 실행.
  • Git 저장소와 MCP 도구 서버를 미리 구성해 에이전트가 필요한 컨텍스트를 갖춘 상태로 시작하도록 지원.
  • 오래 실행되며 유휴 상태인 에이전트를 일시 중지했다가 상태를 잃지 않고 나중에 재개.

빠른 시작

  1. 1

    Kubernetes 클러스터에 Agent Substrate를 설치하고 API 서비스를 확인합니다

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

    ax CLI를 설치합니다

    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

사용 전 알아둘 점

  • AX를 실행하려면 Agent Substrate가 설치된 Kubernetes 클러스터가 먼저 필요합니다.
  • 프로젝트가 활발히 개발 중이므로 안정 버전이 출시되기 전에 호환성을 깨는 주요 변경 사항이 도입될 가능성이 높습니다.

토픽

#ai-agents#kubernetes#orchestration#sandbox#llm#go#mcp#cli

자주 묻는 질문

ax은(는) 무엇인가요?
AX는 Kubernetes 클러스터에서 다수의 샌드박스 자율 에이전트 작업을 실행하는 오픈소스 선언형 오케스트레이터입니다. AX에서는 Task, Workspace, Model 세 가지 리소스 종류를 사용해 YAML로 에이전트 작업을 정의합니다. Task는 CPU와 메모리 제한이 적용된 격리 샌드박스에서 실행되고, Workspace는 Git 저장소, MCP 서버, 스킬 패키지를 미리 연결해 에이전트가 필요한 도구를 갖춘 상태로 시작하게 합니다. Model은 플랫폼에서 사용할 LLM을 지정하며, 인증 정보는 Kubernetes secret에서 가져옵니다. 매니페스트는 ax.io/v1alpha1 API를 사용하고, kubectl과 비슷한 동사 형식을 따르는 ax CLI로 적용합니다.
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 CLI를 설치합니다: 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

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트