Google AX는 어떻게 사용할까? 오픈소스 AI Agent 오케스트레이션 런타임 설치 및 개발 튜토리얼

작업은 실행되지만 파일 접근 범위와 실행 로그가 불분명하다면, 로컬 예제를 곧바로 운영 환경으로 옮기지 마세요.
가장 빠른 해법은 공식 Quickstart로 단일 작업과 작업공간을 먼저 확인한 뒤, 샌드박스·네트워크·관측 경계를 검증하고 통과한 환경만 소규모 배포 시험에 올리는 것입니다.

이 글은 사용자 에이전트를 실행기에 연결하려는 Go 개발자, 실행 환경을 분리하려는 SRE와 플랫폼 엔지니어를 위한 안내입니다.
원격 개발 환경을 검토하는 기술 책임자라면, 어떤 조건을 확인한 뒤 시험 환경을 정할지 살펴볼 수 있습니다.

마지막 업데이트: 2026년 9월 25일. 확인 기준은 Google AX 공식 저장소와 Quickstart, 개념 문서, runner·manifest·네트워크·샌드박스 문서입니다.

구글 액스 설치와 배포 전 런타임 경계

Google AX는 모델도, 바로 업무에 투입할 수 있는 완성형 Agent도 아닙니다. 공식 개념 설명을 기준으로 보면, AX는 작업을 구성하고 작업공간을 준비하며 Agent 실행을 다루는 런타임으로 이해하는 편이 정확합니다. 실제 판단이나 도구 사용을 수행하는 Agent 프로그램과 그 프로그램이 호출하는 모델은 별도 구성 요소입니다. 따라서 AX를 도입한다고 해서 모델 선택, Agent 동작, 권한 정책까지 자동으로 결정되는 것은 아닙니다.

Google AX는 어떻게 설치하고 첫 작업을 시작하나요?
저장소의 현재 Quickstart를 기준으로 환경을 맞추고, 예제 작업 파일과 공식 실행 절차를 그대로 따라가세요. 저장소를 내려받는 기본 절차는 다음과 같습니다.

git clone https://github.com/google/ax.git
cd ax

그다음 저장소의 Quickstart에서 현재 요구하는 Go 도구 체인과 실행 의존성을 확인합니다. 이 글에서는 문서에 고정 버전이 확인되지 않은 도구 버전이나 시스템 사양을 임의로 지정하지 않습니다. 설치가 끝나면 저장소의 안내에 적힌 명령으로 예제 작업을 실행하고, 성공 여부뿐 아니라 작업 입력, 준비된 작업공간, 실행 결과가 각각 어떻게 연결되는지 살펴보세요.

첫 실행에서 중요한 기준은 특정 화면이나 로그 문구를 기대하는 것이 아닙니다. 공식 예제와 현재 실행 절차가 맞는지 확인하고, 결과를 추적할 수 있는 작업 상태와 출력이 노출되는지 확인하는 것입니다. 실제 출력은 사용 중인 runner와 설정에 따라 달라질 수 있으므로, 예시와 다른 결과가 나오면 명령과 설정을 먼저 대조하세요.

환경 준비와 작업공간 수명 주기

작업 요청은 실행할 내용만 담는다고 끝나지 않습니다. 실행 전에 작업공간을 어떻게 만들고, 필요한 파일을 어디서 가져오며, 작업 종료 뒤 무엇을 보존하거나 지울지 정해야 합니다. 공식 작업 예제 파일과 manifest 필드 설명을 함께 확인하면 작업 입력과 작업공간 설정을 추측하지 않고 문서에 맞춰 살펴볼 수 있습니다.

Google AX가 작업공간을 준비하는 방식은 무엇인가요?
작업 요청에 해당하는 Task와 실행에 필요한 Workspace를 구분해 추적하세요. Task는 무엇을 실행할지 전달하는 단위이고, Workspace는 그 작업이 사용할 파일과 실행 맥락을 제공하는 영역입니다. 예제 manifest에 정의된 필드와 실제 runner가 읽는 값을 비교해야 합니다. 필드 이름이나 생략 가능한 항목은 현재 문서를 따르며, 이 글에서 확인되지 않은 설정 키를 추가하지 않습니다.

초기 시험에서는 작업공간에 비밀 정보나 개인 개발 파일을 복사하지 마세요. 입력 파일을 최소화하고, 작업이 끝난 뒤 산출물만 별도로 확인하면 파일 접근 문제가 생겼을 때 원인을 좁히기 쉽습니다. 작업공간 정리 시점과 보존해야 할 로그도 실행 전에 정해 두어야 합니다. 정리 절차가 명확하지 않으면 작업 실패 후 같은 상태를 재현하기 어렵습니다.

주의: 작업공간을 분리했다는 사실만으로 프로세스 격리나 호스트 파일 접근 차단이 보장되지는 않습니다. 어떤 제한이 AX의 공식 기능이고 어떤 제한이 실행 환경의 설정인지 각각 확인하세요.

runner 연결과 사용자 Agent 실행

Google AX runner는 제어 영역에서 전달된 Task와 Workspace를 받아 명령 실행과 실행 관측을 이어 주는 접점입니다. 공식 runner 문서를 읽을 때는 입력을 받는 지점, 명령을 시작하는 지점, 실행 상태나 결과를 관찰하는 지점을 나눠 살펴보세요. 사용자 Agent 연결은 이 경계를 확인한 다음, 예제에 제시된 확장 지점을 이용해 구현하는 편이 안전합니다.

사용자 Agent를 runner에 연결할 때 어디부터 바꾸나요?
먼저 공식 예제의 Task와 Workspace 전달 방식을 유지한 채, Agent 실행을 시작하는 부분을 찾아보세요. 다음으로 Agent가 받는 입력과 반환하는 결과를 명시하고, 실패가 runner에서 드러나는지 확인합니다. 실제 인터페이스 이름과 메서드는 문서와 저장소의 현재 코드에서 확인해야 합니다. 문서에 없는 함수나 완성된 운영 아키텍처를 가정해 코드를 복사하지 마세요.

현장 사례를 가정해 보겠습니다. 코드 변경을 검증하는 Agent를 붙인다면, Task에는 검증 대상과 수행할 작업을 담고 Workspace에는 시험에 필요한 저장소 파일만 준비합니다. Agent가 실행된 뒤에는 종료 결과뿐 아니라 변경된 파일, 오류 출력, 재시도 여부를 확인합니다. 파일은 남았는데 작업 상태가 실패로 기록되는 경우도 있으므로, 결과물만 보고 성공으로 판정하지 않는 것이 중요합니다.

샌드박스·네트워크·관측 검증

배포 전에 살펴볼 항목은 세 경계로 나뉩니다. 프로세스와 파일 접근은 공식 샌드박스 문서, 외부 통신은 네트워크 설정 문서, 작업 입력과 실행 관측은 runner 및 manifest 문서에서 각각 확인하세요. 이 문서들이 설명하는 기능과 배포자가 별도로 마련해야 할 OS 권한, 방화벽, 로그 보존 정책은 같은 것으로 취급하면 안 됩니다.

네트워크와 샌드박스를 확인할 때 무엇을 점검해야 하나요?
작업 프로세스가 읽고 쓸 수 있는 경로를 시험하고, 의도하지 않은 호스트 파일 접근이 가능한지 살펴보세요. 이어서 필요한 통신만 허용되는지 확인하고, SSH나 디버깅 진입점은 실제 배포 설정에서 언제 활성화되는지 검토합니다. 관측 항목은 작업 시작, 종료, 실패 원인, 표준 출력과 오류 출력이 운영자가 확인할 수 있는지 중심으로 점검합니다. 공식 문서에 기능이 언급돼 있어도 현재 배포 설정에서 자동으로 켜져 있다고 단정하지 마세요.

실행 전 점검 목록은 다음과 같습니다.

• [ ] Quickstart의 Go 도구 체인과 의존성 요구 사항을 현재 저장소에서 확인했습니다.
• [ ] 공식 예제 Task와 Workspace로 단일 작업을 실행하고 입력과 결과의 연결을 확인했습니다.
• [ ] 작업 프로세스의 파일 접근 범위와 작업 종료 뒤 작업공간 정리 절차를 점검했습니다.
• [ ] 네트워크 허용 범위와 차단 대상이 설정으로 확인되며, SSH·디버깅 진입 조건도 정리했습니다.
• [ ] 실패 상태와 로그를 확인할 수 있고, 재실행 시 작업공간을 어떻게 복구할지 정했습니다.

시험 환경 선택과 확대 기준

아래 표는 제품 성능 비교가 아니라, 어디서 시험을 시작할지 결정하기 위한 운영 기준입니다. Google AX의 동작 가능 여부와 격리 수준은 선택한 환경의 설정 및 현재 공식 문서로 별도 검증해야 합니다.

단일 작업이 성공해도 곧바로 동시 실행을 늘리지 마세요. 먼저 작업공간 정리, 실패 후 재시도, 로그 확인이 같은 절차로 반복 가능한지 확인합니다. 그다음 작은 시험 범위에서 동시 실행을 추가하고, 파일 충돌이나 로그 누락이 생기면 단일 작업 단계로 되돌려 원인을 분리하세요. 공식 예제는 시작점이지, 모든 운영 형태에 대한 생산 검증 결과는 아닙니다.

구글 액스 설치와 배포를 검토할 때는 먼저 로컬에서 인터페이스와 작업 흐름을 확인하고, 권한·네트워크·관측이 분리된 시험 환경으로 옮기는 순서가 합리적입니다. 로컬 개발은 시작이 간단하지만 개인 작업 파일과 실행 환경을 분리하기 어렵고, 직접 마련한 서버는 네트워크 정책과 유지 관리를 팀이 책임져야 합니다. 일시적인 검증 환경이 필요하다면 Kvmjet의 인프라 안내를 확인하고, 실제 시험에 쓸 원격 환경은 서울 노드 안내에서 조건을 살펴보세요. 다만 장기간 안정적인 고부하 작업이나 물리 인터페이스가 필요한 경우에는 임대 환경이 적합하지 않을 수 있습니다. 먼저 AX의 실행 방식과 격리 요구 사항을 정리한 뒤 환경을 선택하세요.