Google Agents CLI, 프레임워크 확장 기능 추가

Google Cloud는 Agents CLI 1.5.0에서 확장 기능을 지원한다고 발표했습니다. 개발자는 이를 통해 도구를 포크하지 않고 기본 명령어를 바꾸거나 새 명령어를 추가할 수 있습니다. 1.8.0에는 LangChain 전용 템플릿이 포함돼 프레임워크별 명령어를 LangChain 명령어로 바꾸면서 나머지 에이전트 개발 절차는 유지합니다. 확장 시스템은 1.8.0에서 실험 단계이며, 매니페스트와 명령어가 호환성을 깨뜨리는 방식으로 바뀔 수 있습니다. Google은 사용 팀에 Agents CLI 버전을 고정하라고 권고합니다.

확장 시스템은 LangChain, LangGraph, Deep Agents를 쓰는 팀과 공통 정책을 적용하는 기업 플랫폼 팀을 겨냥합니다. 확장 기능은 명령어 대체·추가 목록을 담은 agents-cli-extension.yaml 파일을 포함하는 Git 저장소 디렉터리입니다. Google 저장소나 다른 Git 저장소, 로컬 경로에서 불러올 수 있으며, 저장소 하나에 여러 확장을 두고 #name 조각으로 선택할 수 있습니다. 설치 범위는 확장 기능과 잠금 파일을 프로젝트에 커밋하는 프로젝트 단위 또는 한 컴퓨터의 모든 프로젝트에 적용하는 --global 사용자 단위로 지정합니다. 두 범위에서 같은 명령어를 정의하면 프로젝트 단위 설정이 우선합니다.

잠금 파일은 설치 시 확인한 정확한 Git 커밋 SHA를 기록합니다. 따라서 새로 체크아웃한 환경에서 agents-cli install을 실행하면 고정된 코드를 복원하고, 기준 커밋은 앞서가지 않습니다. 더 새로운 커밋을 적용하려면 agents-cli extension update를 실행해야 하며, 이때 서드파티 코드를 신뢰할지 다시 확인합니다. Google은 확장 기능이 프레임워크별 도구 체계의 제약을 해결한다고 설명합니다. 기존에는 CLI를 포크해 유지하거나 우회될 수 있는 래퍼 스크립트를 쓰고, 대체 도구를 처음부터 만들 수 있었으며, 이 과정에 엔지니어 수개월의 작업이 들 수도 있었습니다. Agents CLI의 명령어 중 6개인 playground, run, eval 하위 명령어 4개는 ADK 런타임을 전제로 합니다. scaffold, infra, deploy, publish, login 등을 포함한 약 18개는 프레임워크에 종속되지 않습니다. 확장 기능이 없으면 ADK를 쓰지 않는 프로젝트는 총 24개 명령어에 접근하지 못할 수 있습니다.

Google의 LangChain 템플릿은 Agents CLI의 개발 절차를 이용해 로컬 실행, 배포, 평가를 할 수 있는 에이전트 프로젝트를 생성하며 google-adk 의존성은 필요하지 않습니다. LangGraph 그래프와 Deep Agents도 지원합니다. 원문은 LangChain 1.0 이상이 상태 관리에 LangGraph를 사용하며, 세 프레임워크가 그래프 표현을 공유한다고 설명합니다. 안내된 절차에는 Python 3.11 이상, uv 패키지 관리자, Google Cloud SDK, 결제가 활성화된 Google Cloud 프로젝트가 필요합니다. 개발자는 v1.8.0에 고정된 템플릿으로 프로젝트를 만든 뒤 agents-cli install을 실행합니다. 생성된 프로젝트에는 확장 매니페스트, LangGraph 개발 서버 설정, 애플리케이션 코드, 평가 파일, Terraform 배포 모듈, uv.lock 의존성 잠금 파일이 포함됩니다.

안내에는 배포 명령어에 소프트웨어 구성 요소 및 의존성 목록인 SBOM 검사를 덧붙이는 사용자 지정 확장 기능도 나옵니다. Google은 이를 플랫폼 팀이 여러 프로젝트에 정책 검사를 적용하는 방식의 예로 들며, 규정 준수 검사, 로그인에 기업용 통합 인증 적용, 평가 단계의 모델 위험 관리 절차도 사례로 제시합니다. 템플릿의 에이전트 예시는 모의 날씨 도구를 사용하는 Gemini ReAct 에이전트이며 모델은 gemini-3.8-flash로 설정됩니다. Google은 이 확장 방식으로 팀이 다른 프레임워크를 선택하거나 명령어 동작을 바꾸면서 Agents CLI의 배포·평가·관측 기능을 활용할 수 있다고 밝혔습니다.

Google Cloud는 Agents CLI 1.5.0에서 확장 기능을 지원한다고 발표했습니다. 개발자는 이를 통해 도구를 포크하지 않고 기본 명령어를 바꾸거나 새 명령어를 추가할 수 있습니다. 1.8.0에는 LangChain 전용 템플릿이 포함돼 프레임워크별 명령어를 LangChain 명령어로 바꾸면서 나머지 에이전트 개발 절차는 유지합니다. 확장 시스템은 1.8.0에서 실험 단계이며, 매니페스트와 명령어가 호환성을 깨뜨리는 방식으로 바뀔 수 있습니다. Google은 사용 팀에 Agents CLI 버전을 고정하라고 권고합니다.

확장 시스템은 LangChain, LangGraph, Deep Agents를 쓰는 팀과 공통 정책을 적용하는 기업 플랫폼 팀을 겨냥합니다. 확장 기능은 명령어 대체·추가 목록을 담은 agents-cli-extension.yaml 파일을 포함하는 Git 저장소 디렉터리입니다. Google 저장소나 다른 Git 저장소, 로컬 경로에서 불러올 수 있으며, 저장소 하나에 여러 확장을 두고 #name 조각으로 선택할 수 있습니다. 설치 범위는 확장 기능과 잠금 파일을 프로젝트에 커밋하는 프로젝트 단위 또는 한 컴퓨터의 모든 프로젝트에 적용하는 --global 사용자 단위로 지정합니다. 두 범위에서 같은 명령어를 정의하면 프로젝트 단위 설정이 우선합니다.

잠금 파일은 설치 시 확인한 정확한 Git 커밋 SHA를 기록합니다. 따라서 새로 체크아웃한 환경에서 agents-cli install을 실행하면 고정된 코드를 복원하고, 기준 커밋은 앞서가지 않습니다. 더 새로운 커밋을 적용하려면 agents-cli extension update를 실행해야 하며, 이때 서드파티 코드를 신뢰할지 다시 확인합니다. Google은 확장 기능이 프레임워크별 도구 체계의 제약을 해결한다고 설명합니다. 기존에는 CLI를 포크해 유지하거나 우회될 수 있는 래퍼 스크립트를 쓰고, 대체 도구를 처음부터 만들 수 있었으며, 이 과정에 엔지니어 수개월의 작업이 들 수도 있었습니다. Agents CLI의 명령어 중 6개인 playground, run, eval 하위 명령어 4개는 ADK 런타임을 전제로 합니다. scaffold, infra, deploy, publish, login 등을 포함한 약 18개는 프레임워크에 종속되지 않습니다. 확장 기능이 없으면 ADK를 쓰지 않는 프로젝트는 총 24개 명령어에 접근하지 못할 수 있습니다.

Google의 LangChain 템플릿은 Agents CLI의 개발 절차를 이용해 로컬 실행, 배포, 평가를 할 수 있는 에이전트 프로젝트를 생성하며 google-adk 의존성은 필요하지 않습니다. LangGraph 그래프와 Deep Agents도 지원합니다. 원문은 LangChain 1.0 이상이 상태 관리에 LangGraph를 사용하며, 세 프레임워크가 그래프 표현을 공유한다고 설명합니다. 안내된 절차에는 Python 3.11 이상, uv 패키지 관리자, Google Cloud SDK, 결제가 활성화된 Google Cloud 프로젝트가 필요합니다. 개발자는 v1.8.0에 고정된 템플릿으로 프로젝트를 만든 뒤 agents-cli install을 실행합니다. 생성된 프로젝트에는 확장 매니페스트, LangGraph 개발 서버 설정, 애플리케이션 코드, 평가 파일, Terraform 배포 모듈, uv.lock 의존성 잠금 파일이 포함됩니다.

안내에는 배포 명령어에 소프트웨어 구성 요소 및 의존성 목록인 SBOM 검사를 덧붙이는 사용자 지정 확장 기능도 나옵니다. Google은 이를 플랫폼 팀이 여러 프로젝트에 정책 검사를 적용하는 방식의 예로 들며, 규정 준수 검사, 로그인에 기업용 통합 인증 적용, 평가 단계의 모델 위험 관리 절차도 사례로 제시합니다. 템플릿의 에이전트 예시는 모의 날씨 도구를 사용하는 Gemini ReAct 에이전트이며 모델은 gemini-3.8-flash로 설정됩니다. Google은 이 확장 방식으로 팀이 다른 프레임워크를 선택하거나 명령어 동작을 바꾸면서 Agents CLI의 배포·평가·관측 기능을 활용할 수 있다고 밝혔습니다.