Gemini Enterprise Agent Platform 문제 해결

이 페이지는 Gemini Enterprise Agent Platform 문제 해결의 시작점입니다. 오류를 진단하거나, 특정 오류를 조회하거나, 작업 가이드를 찾거나, 지원을 받을 수 있습니다.

오류 진단

특정 수정사항을 찾기 전에 다음 정보를 수집하세요.

오류 읽기

400 또는 429과 같은 상태 코드와 정확한 메시지 텍스트를 기록합니다. 오류 카탈로그에서 두 가지 모두 조회할 수 있습니다.

오류 메시지에 머신 리더블 이유, 문서 링크 또는 사전 필터링된 로그 보기가 있는 경우 이를 통해 특정 실패를 식별할 수도 있습니다.

로그 찾기

에이전트 오류 로그를 검색하고 필터링하려면 로그 탐색기를 사용하고 리소스 유형을 Vertex AI 추론 엔진으로 설정한 후 해당하는 리소스 컨테이너 값 (프로젝트 번호)과 추론 엔진 ID 값을 선택합니다.

할당량 및 서비스 상태 확인

간헐적으로 표시되거나 내 쪽에서 변경하지 않았는데 시작된 오류는 할당량 또는 진행 중인 인시던트로 인해 발생하는 경우가 많습니다.

오류 카탈로그

다음 표에서 수신한 오류를 찾습니다. 오류가 목록에 없으면 완료하려는 작업에 대한 문제 해결 가이드를 사용하세요.

상태 코드 또는 메시지 해결 방법
ImportError: cannot import name 'reasoning_engines', ImportError: cannot import name 'agent_engines' 오래된 버전의 Python용 Agent Platform SDK
401 Context-Aware Access requirements are not met, 401 Request had invalid authentication credentials 401 승인 오류
ValueError: Cannot get the Candidate text 콘텐츠 생성 오류
failed to start and cannot serve traffic(리전의 첫 번째 커스텀 컨테이너(BYOC) 배포 시) BYOC 최초 생성 오류
failed to start and cannot serve traffic 또는 Request is prohibited by organization's policy(VPC 서비스 제어 경계 내) VPC-SC 위반 오류
429, RESOURCE_EXHAUSTED 리소스 소진 또는 비율 제한 오류
429, RESOURCE_EXHAUSTED, at capacity 일시적으로 용량이 초과된 지역
429, RESOURCE_EXHAUSTED, max_instances 최대 인스턴스가 지역 제한을 초과함
500 사전 빌드된 템플릿에서 발생하는 내부 서버 오류 사전 빌드된 템플릿 오류
에이전트를 직렬화할 때 cloudpickle 또는 pydantic 버전 충돌 직렬화 오류
NotFound: 404 Can not copy from "gs://..." Cloud Storage 버킷 하위 디렉터리가 생성되지 않음
iam.serviceAccounts.actAs 거부됨, 메타데이터 서버를 사용할 수 없음 커스텀 서비스 계정 오류
400, INVALID_ARGUMENT, REASONING_ENGINE_SECRET_ACCESS_DENIED, referenced by spec.deployment_spec.secret_env Secret Manager 액세스 오류
InvalidArgument: 400 Provided filter is not valid 에이전트 목록을 필터링할 때 오류 발생
google.api_core.exceptions.Unknown: None, Failed to convert project number to project ID, 시작 중 Agent Runtime 시작 중 오류
아웃바운드 요청에 대한 403 Forbidden 403 금지됨 오류
자체 서명 또는 비공개 CA 대상에 도달하는 인증서 확인 실패 자체 서명 또는 비공개 CA 대상에 연결할 수 없음
커스텀 컨테이너 (BYOC) 에이전트의 TLS 핸드셰이크 실패 맞춤 컨테이너(BYOC)로 배포된 에이전트가 연결되지 않음
샌드박스 생성 실패 샌드박스 생성 문제
샌드박스에서 코드 실행 시간 초과, 파일 I/O 실패 코드 실행 문제
RuntimeError: Failed to generate memory 또는 세션 후 반환된 메모리가 없음 생성된 추억이 없습니다

문제 해결 가이드

특정 오류 메시지가 없거나 오류가 오류 카탈로그에 없는 경우 다음 표에서 작업에 해당하는 가이드를 확인하세요.

작업 가이드
Agent Platform SDK 설치 및 환경 설정 Agent Runtime 환경 설정
에이전트 만들기 에이전트 만들기
Agent Runtime에 에이전트 배포 에이전트 배포
상담사에서 외부 서비스 호출 Agent Gateway 연결
배포된 에이전트 나열, 업데이트 또는 삭제 배포된 에이전트 관리
샌드박스에서 코드 실행 코드 실행
메모리 생성 또는 검색 Agent Platform Memory Bank
모델을 제공하거나 모델 할당량에 도달함 머신러닝 서비스 문제 해결

지원 받기

이 페이지의 가이드로 문제가 해결되지 않으면 상담사를 위한 지원 받기에서 지원 패키지, 커뮤니티 포럼, 버그 신고를 확인하세요. 결제 관련 질문은 결제 관련 질문을 참고하세요.

버그를 신고하는 경우 다음 정보를 제공하세요.

  • 상태 코드
  • 오류 메시지
  • (선택사항) 오류 메시지가 잘못되었거나, 오해를 유발하거나, 조치를 취할 수 없는 경우의 의견