A2A 에이전트 배포 테스트 및 모니터링

A2A 에이전트를 Cloud Run에 성공적으로 배포한 후 기능을 철저히 테스트합니다. 지속적인 성능과 안정성을 보장하기 위해 강력한 모니터링 관행을 수립하세요.

A2A 검사기: 에이전트 규정 준수 검증

a2a-inspector 도구를 사용하여 배포된 Google A2A 에이전트를 검사, 디버그, 검증합니다. 이 도구를 사용하면 에이전트가 A2A 사양을 완전히 준수하고 올바르게 작동하는지 확인할 수 있습니다.

연결이 완료되면 인스펙터는 다음 작업을 실행합니다.

  • 에이전트 카드 표시: 에이전트 카드를 자동으로 표시합니다.
  • 규정 준수 검증: 카드가 A2A 사양을 충족하는지 확인합니다.
  • 실시간 채팅 사용 설정: 상담사와 메시지를 주고받을 수 있습니다.
  • 원시 데이터 표시: 디버깅을 위해 콘솔에 원시 JSON-RPC 2.0 메시지를 표시합니다.

배포된 A2A 에이전트와의 CLI 상호작용

A2A 샘플 저장소의 명령줄 인터페이스 (CLI) 도구를 사용하여 배포된 서비스와 상호작용합니다. 이 CLI는 베어러 토큰 기반 인증을 지원합니다.

서비스에서 IAM 기반 인증을 사용하는 경우 성공적인 상호작용을 위해 gcloud 토큰을 내보냅니다.

export A2A_CLI_BEARER_TOKEN=$(gcloud auth print-identity-token)
# From CLI directory
uv run . --agent CLOUD_RUN_SERVICE_URL

CLOUD_RUN_SERVICE_URL을 배포된 Cloud Run 서비스의 URL로 바꿉니다.

배포된 A2A 서비스의 로컬 테스트

배포된 Cloud Run 서비스를 로컬로 테스트할 수 있습니다. 이는 IAM 기반 인증을 구현할 때 특히 유용합니다.

Cloud Run 에이전트의 IAM 기반 인증 테스트

Identity and Access Management (IAM)로 보안이 설정된 Cloud Run 서비스와 상호작용하는 클라이언트는 roles/run.invoker IAM 역할을 보유해야 합니다.

gcloud auth print-identity-token 명령어를 사용하여 배포된 서비스 인증 흐름을 로컬로 테스트합니다.

curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" CLOUD_RUN_SERVICE_URL/.well-known/agent.json

CLOUD_RUN_SERVICE_URL을 배포된 Cloud Run 서비스의 URL로 바꿉니다.