Gemini Enterprise Agent Platform 문제 해결

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

오류 진단

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

오류 읽기

상태 코드(예: 400 또는 429)와 정확한 메시지 텍스트를 기록합니다. 오류 카탈로그에서 둘 다 조회할 수 있습니다.

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

로그 찾기

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

할당량 및 Service Health 확인

간헐적으로 표시되거나 사용자 측에서 변경사항 없이 시작된 오류는 할당량 또는 진행 중인 사고로 인해 발생하는 경우가 많습니다.

오류 카탈로그

다음 표에서 발생한 오류를 찾습니다. 오류가 목록에 없으면 완료하려는 태스크의 문제 해결 가이드를 사용하세요.

상태 코드 또는 메시지 해결 방법
ImportError: cannot import name 'reasoning_engines', ImportError: cannot import name 'agent_engines' 오래된 버전의 Agent Platform SDK for Python
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 액세스 오류
504, DEADLINE_EXCEEDED, REASONING_ENGINE_BUILD_TIMEOUT 컨테이너 이미지 빌드 제한 시간 초과
504, DEADLINE_EXCEEDED, REASONING_ENGINE_CONTAINER_START_TIMEOUT 컨테이너가 제시간에 시작되지 않음
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 메모리 뱅크
모델 서빙 또는 모델 할당량 도달 머신러닝 서비스 문제 해결

지원 받기

이 페이지의 가이드로 문제가 해결되지 않으면 에이전트 도움말 보기에서 지원 패키지, 커뮤니티 포럼, 버그 신고를 참조하세요. 결제와 관련해 궁금한 점이 있으면 결제 관련 문의를 참조하세요.

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

  • 상태 코드
  • 오류 메시지
  • (선택사항) 오류 메시지가 잘못되었거나, 오해의 소지가 있거나, 조치를 취할 수 없는 경우 의견을 제공합니다.