Google agents-cli 스위트의 게시 기능(SKILL.md 서명: Google): 배포된 에이전트를 Gemini 앱(구 Gemini Enterprise)에 등록하고, gcloud를 사용하여 Agent Registry의 에이전트 및 MCP 서버를 관리합니다.
skills.sh 설치 횟수 516262(+2918 / 24시간)
보안 감사: 위험 경고 있음
- 서드파티 패키지(npx / pip 등)를 설치하거나 실행하며, 이는 명령어 실행에 해당함
- 에이전트가 셸 / 스크립트 명령어를 실행하도록 함
- 네트워크 요청을 발생시키거나 외부 API / 원격 MCP를 호출함
- 스캔되지 않은 스크립트 참조: tools/list
- 감사 범위: GitHub google/agents-cli/skills/google-agents-cli-publish/SKILL.md(SKILL.md 텍스트만 스캔)
이유
- 두 가지 등록 방식 설명: Agent Runtime에 배포된 ADK 에이전트는 기본적으로 ADK 네이티브 호출(:streamQuery)을 사용하며, Cloud Run / GKE의 다른 프레임워크 에이전트는 A2A만 사용 가능하고 에이전트 카드 URL만 전달하면 됨
- deployment_metadata.json이 있을 경우 Agent Runtime ID와 등록 방식을 자동으로 읽어내며, 최소한 --gemini-app-id만 제공하면 됨. 기본적으로 비대화형(non-interactive)이므로 CI에 바로 포함할 수 있고, 반복 게시 시 제자리에서 업데이트됨
- Agent Registry용 gcloud 명령어와 문제 해결 표(권한 403, 구버전 google-cloud-aiplatform의 'Session not found' 오류 등) 포함
- agents-cli 스위트에는 순위권에 있는 다른 6개의 기능이 있음. skills.sh의 24시간당 설치 횟수는 2918이며, 누적 설치 횟수는 516262임. 최근 몇 주간 주간 설치 횟수가 132534에서 11115로 감소함(이는 관심도를 나타냄)
사용법
- npx skills add https://github.com/google/agents-cli --skill google-agents-cli-publish; CLI는 uv tool install google-agents-cli로 설치
- 전제 조건: 에이전트가 이미 배포되어 접근 가능해야 하며, Google Cloud 콘솔에 Gemini 앱이 생성되어 있어야 함. 배포 자체는 google-agents-cli-deploy에 위임
- Google Cloud 프로젝트 및 계정 필요. 등록 계정에는 Discovery Engine Editor 권한이 있어야 함. Cloud Run에서 A2A를 사용하는 경우 Discovery Engine 서비스 계정에 roles/run.servicesInvoker 권한을 부여해야 함
위험
- 감사 경고에서 언급한 설치, 셸 및 네트워크 요청은 용도와 일치함. '스캔되지 않은 스크립트 tools/list'는 실제로는 MCP 프로토콜의 메서드 이름이며 스크립트가 아님
- 명령어는 Google Cloud의 실제 리소스(등록, 업데이트, 삭제)를 변경하며, 비용은 --project-id로 지정된 프로젝트에 청구됨
- 텍스트 에이전트만 지원되며, 음성 / Live 에이전트는 Gemini 앱에 게시할 수 없음