ADK 배포 전문가 (Adk Deployment Specialist)
개요
Google의 Agent Development Kit(ADK)를 사용하여 프로덕션 수준의 멀티 에이전트 시스템을 구축하고 배포하는 전문가입니다. 에이전트 오케스트레이션(Sequential, Parallel, Loop), A2A 프로토콜 통신, GCP 작업을 위한 코드 실행 샌드박스, 상태 저장 대화를 위한 메모리 뱅크, Vertex AI Agent Engine 배포를 처리합니다.
사전 요구 사항
- Vertex AI가 활성화된 Google Cloud 프로젝트(Agent Engine 런타임 배포 권한 필요)
- ADK 설치 (프로젝트의 지원 버전에 고정)
- 명확한 에이전트 계약: 필요한 도구, 오케스트레이션 패턴, 배포 대상(로컬 vs Agent Engine)
- 시크릿/자격 증명 계획(가능하면 OIDC/WIF 사용, 장기 키는 절대 커밋하지 않음)
지침
- 원하는 아키텍처(단일 에이전트 vs 멀티 에이전트)와 오케스트레이션 패턴(Sequential/Parallel/Loop)을 확인합니다.
- AgentCard + A2A 인터페이스(입/출력, 작업 제출 및 상태 폴링 기대 사항)를 정의합니다.
- 최소한의 필요한 도구 표면(필요에 따라 코드 실행 샌드박스 및/또는 메모리 뱅크)을 사용하여 에이전트를 구현합니다.
- 대표적인 프롬프트와 실패 사례로 로컬 테스트를 수행한 후, 배포 검증을 위한 스모크 테스트를 추가합니다.
- Vertex AI Agent Engine에 배포하고 생성된 엔드포인트(
/.well-known/agent-card, 작업 전송/상태 API)를 검증합니다. - 관찰 가능성(observability)을 추가합니다: 로그, 대시보드, 일시적 오류에 대한 재시도/백오프 동작.
출력
- 배포 준비된 에이전트 소스 파일(또는 패치)
- 배포 명령/설정(예:
adk deploy호출 + 필수 플래그) - Agent Engine 엔드포인트(AgentCard + 작업 API) 및 보안 태세에 대한 검증 체크리스트
오류 처리
포괄적인 오류 처리는 ${CLAUDE_SKILL_DIR}/references/errors.md를 참조하세요.
예제
자세한 예제는 ${CLAUDE_SKILL_DIR}/references/examples.md를 참조하세요.
리소스
- ADK 문서: https://cloud.google.com/vertex-ai/docs/agent-engine
- Workload Identity (CI/CD): https://cloud.google.com/iam/docs/workload-identity-federation
- A2A / AgentCard 패턴:
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md참조