Gemini Enterprise Agent Platform 문제 해결

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

오류 진단

특정 해결 방법을 찾기 전에 다음 정보를 수집하세요.

오류 읽기

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

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

로그 찾기

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

할당량 및 서비스 상태 확인

간헐적으로 표시되거나 사용자가 변경하지 않았는데 시작된 오류는 할당량 또는 진행 중인 문제로 인해 발생하는 경우가 많습니다.

오류 카탈로그

다음 표에서 수신한 오류를 찾습니다. 오류가 나열되어 있지 않으면, 문제 해결 가이드를 사용하여 완료하려던 작업을 완료하세요.

상태 코드 또는 메시지 해결 방법
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 콘텐츠 생성 오류
리전의 첫 번째 커스텀 컨테이너 (BYOC) 배포에서 failed to start and cannot serve traffic BYOC 첫 번째 생성 오류
VPC 서비스 제어 경계 내에서 failed to start and cannot serve traffic 또는 Request is prohibited by organization's policy, VPC-SC 위반 오류
429, RESOURCE_EXHAUSTED 리소스 소진 또는 비율 제한 오류
사전 빌드된 템플릿의 500 내부 서버 오류 사전 빌드된 템플릿 오류
에이전트를 직렬화할 때 cloudpickle 또는 pydantic 버전 충돌 직렬화 오류
NotFound: 404 Can not copy from "gs://..." Cloud Storage 버킷 하위 디렉터리가 생성되지 않음
iam.serviceAccounts.actAs 거부됨, 메타데이터 서버를 사용할 수 없음 커스텀 서비스 계정 오류
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또는 세션 후 반환된 메모리가 없음 메모리가 생성되지 않음

문제 해결 가이드

특정 오류 메시지가 없거나 오류가 error catalog에 없는 경우 다음 표에서 작업에 해당하는 guide 를 확인하세요.

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

지원 받기

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

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

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