문제 해결

대부분의 인시던트는 자격 증명, 범위, 오래된 콘텐츠와 관련됩니다. 본 페이지는 빠른 트리아지 순서를 보여 줍니다. 티켓 생성 시 로그와 타임스탬프를 첨부하세요.

대시보드 테스트 채팅에서 재현하여 문제가 채널별인지 에이전트 전체에 해당하는지 판단하세요.

API 키 및 모델 키 오류

401/403은 일반적으로 잘못된 키, 잘못된 조직 또는 만료된 BYOK 자격 증명을 나타냅니다. 환경(프로덕션 vs 스테이징)이 설정한 키와 일치하는지 확인하세요.

로테이션 후 헤더를 캐시하는 종속 서비스를 재시작하거나 업데이트하세요.

약하거나 빈 답변

에이전트가 기대하는 지식 베이스를 사용하는지 확인하세요. 콘텐츠가 최근 변경된 경우 동기화 또는 크롤 작업을 재실행하세요.

지시가 과도하게 제한적이지 않은지 확인하세요 — 검색이 올바르더라도 모델이 거부할 수 있습니다.

가져오기 또는 크롤 할당량 오류(402 / 「상한 도달」)

많은 이미지 또는 미디어 파일 후 지식 가져오기가 할당량 또는 결제 오류로 실패하면 호스팅형 월간 Gemini 이미지 인식 또는 미디어 전사 제한을 소진했을 수 있습니다.

완화: 설정 → LLM API 키에서 Google Gemini API 키를 추가하여 이러한 작업이 Google 프로젝트를 사용하도록 하거나, 관리자에게 플랜 상한 인상을 요청하거나, 일시적으로 네이티브 텍스트 형식을 가져오고 크롤 미디어 처리를 비활성화하세요.

이미지 또는 미디어를 활성화한 크롤에는 해결 가능한 Gemini 설정(호스팅형 또는 조직)이 필요합니다. 없으면 API는 Gemini 부족 메시지로 크롤 시작을 거부합니다.
Vision을 건너뛰어도 이미지에서 OCR 텍스트만 표시될 수 있습니다. 파일이 완전히 실패했다고 단정하지 마세요 — 저장된 문서 본문을 확인하세요.

API 키 및 모델 키 오류