1. 에러 코드 가이드
Storm OpenAPI
  • Welcome to STORM
    • STORM 소개
  • Quickstart
    • 시작하기
      • 계정 생성
      • 에이전트 생성
    • 주요 활용 시나리오
      • 문서 업로드
      • 워크플로우 설계
      • 테스트
      • 배포
      • 채널 연동
  • Feature Guide
    • 콘솔
      • 에이전트 관리
      • 대시보드
      • 권한 설정
    • 에이전트 템플릿
      • 심층 지식 탐색
      • 지식 탐색
      • 자유 대화
      • 보고서 작성
      • FAQ 챗봇
      • 이력서 스크리닝
      • 캐릭터 대화
      • 상담기록 분석
      • 기사 작성
      • SQL문 작성
    • 에이전트 빌더
      • 지식
        • 문서
        • 폴더
        • 피드백
      • 워크플로우
        • 노드 설명
          • LLM
          • 검색(RAG)
          • 에이전틱 RAG
          • API
          • IF ELSE
          • 변수 선언과 할당
          • 후처리
          • 응답
          • 루프
          • 문서 생성
      • 테스트
      • 로그
      • 대시보드
    • 관리자 도구
      • 배포 관리
      • 채널 연동
      • 모델 파인튜닝
      • 학습 데이터 품질 관리
      • 기타 설정
      • Teams 채널 연동
  • Apis
    • 에이전트
      • 에이전트 조회
      • 에이전트 배포
      • 에이전트 배포 이력 조회
      • 워크플로우 목록 조회
      • 최신 워크플로우 조회
      • 워크플로우 단건 조회
      • 신규 워크플로우 생성
    • 버킷
      • 버킷 생성
      • 버킷 조회
    • 문서
      • 문서 학습 요청 by file
      • 문서 학습 요청 by url
      • 문서 조회
      • 문서 삭제
    • 채팅
      • 채팅 중 파일 업로드
        • 파일 생성 및 Presigned URL 발급
        • 파일 업로드 완료 처리
        • 파일 상태 조회
      • 채팅 전송 (OpenAI 호환)
      • 채팅 전송 (non-stream)
      • 채팅 전송 (stream)
      • 컨텍스트 검색
  • Learn More
    • 자주 묻는 질문
    • 과금 플랜
    • 에러 코드 가이드
      • AgentRag
      • DocGen
      • ApiCall
      • Function
      • IfElse
      • Loop
      • OpenLLM
      • Post
      • Rag
      • Response
      • Variable
  • Schemas
    • Response
      • CheckedException
    • [common] status
    • [object] document
    • [object] chat
    • [object] agent
    • [object] deployment
    • [object] chat stream chunk
    • [object] context
    • [object] user
    • [object] bucket
    • message
    • [res] pageinfo
  1. 에러 코드 가이드

Rag

유효성 검사 에러#


RAG_EMPTY_QUERY#

RAG 노드의 검색 쿼리가 비어 있어 검색을 실행할 수 없습니다.
query 필드에 검색어를 입력해주세요.
query_template 필드에 유효한 템플릿을 입력해주세요.
두 필드 중 하나에라도 값을 입력했는지 확인해주세요.

네트워크 에러#


RAG_DNS_FAILURE#

RAG 노드에서 DNS 이름 확인에 실패했습니다. RAG 서버 주소가 올바르지 않거나 연결할 수 없는 상태입니다.
RAG 노드 설정에서 서버 호스트 이름이 정확한지 확인해주세요.
네트워크 연결 상태를 점검하고 RAG 서버에 접근할 수 있는지 확인해주세요.

RAG_CONNECTION_REFUSED#

RAG 노드가 검색 서버와의 연결을 거부했습니다. 검색 서버가 응답하지 않습니다.
RAG 검색 서버가 정상적으로 작동하는지 확인해주세요.
RAG 노드의 설정에서 서버 주소가 정확한지 확인해주세요.
네트워크 연결 상태를 확인하고 다시 시도해주세요.

RAG_CONNECTION_TIMEOUT#

RAG 노드가 검색 서버에 연결하는 데 시간이 초과되었습니다. 검색이 실패했습니다.
RAG 노드 설정에서 검색 서버 연결 설정을 확인해주세요.
검색 서버가 정상적으로 작동하는지 확인해주세요.
워크플로우를 다시 실행해주세요.

RAG_READ_TIMEOUT#

RAG 노드에서 검색 요청 시간이 초과되어 실패했습니다.
RAG 노드의 timeout 값을 늘려주세요.
RAG 서버의 응답 시간을 단축하거나, RAG 서버의 성능을 개선해주세요.
RAG 노드의 indexName이 올바른지 확인해주세요.

RAG_WRITE_TIMEOUT#

RAG 노드에서 검색 요청 시간이 초과되어 검색을 완료하지 못했습니다.
RAG 노드의 timeout 속성 값을 늘려주세요.
검색하려는 데이터베이스의 응답 시간을 확인해주세요.
네트워크 연결 상태를 확인해주세요.

RAG_SSL_ERROR#

RAG 노드에서 보안 연결(SSL/TLS)에 실패하여 검색을 완료할 수 없습니다.
RAG 서버의 SSL 인증서가 유효한지 확인해주세요.
RAG 서버의 주소가 올바른지 확인해주세요.
워크플로우 빌더에서 RAG 노드의 설정이 정확한지 다시 확인해주세요.

RAG_CONNECTION_ERROR#

RAG 노드가 RAG 서버에 연결할 수 없어 검색에 실패했습니다.
RAG 서버가 실행 중인지 확인해주세요.
네트워크 연결 상태를 확인해주세요.
RAG 노드의 설정이 올바른지 확인해주세요.

RAG_TIMEOUT#

RAG 노드에서 검색 요청 시간이 초과되었습니다. RAG 서버가 설정된 시간 내에 응답하지 않았습니다.
RAG 노드의 타임아웃 설정을 늘려주세요.
RAG 서버의 응답 시간을 줄이거나 서버 성능을 향상시켜주세요.
RAG 노드의 indexName 속성이 올바르게 설정되었는지 확인해주세요.

HTTP 상태 에러#


RAG_HTTP_400#

RAG 검색에 실패했습니다. RAG 서버가 요청을 거부했습니다.
query 속성이 올바른지 확인해주세요.
RAG 서버의 상태를 확인해주세요.
RAG 노드 설정에서 요청 파라미터가 정확한지 확인해주세요.

RAG_HTTP_401#

RAG 노드 검색에 실패했습니다. 인증이 필요합니다 (401 오류).
RAG 노드 설정에서 API 키 또는 인증 헤더가 올바르게 설정되었는지 확인해주세요.
API 키 또는 인증 헤더가 만료되지 않았는지 확인해주세요.
RAG 서비스 제공업체에 문의하여 API 키 또는 인증 헤더가 유효한지 확인해주세요.

RAG_HTTP_403#

RAG 노드 검색에 실패했습니다. RAG 리소스에 대한 접근 권한이 없습니다.
RAG 리소스에 접근할 수 있는 권한을 확인해주세요.
워크플로우 빌더의 RAG 노드 설정에서 올바른 indexName을 사용하고 있는지 확인해주세요.
RAG 리소스 관리자에게 문의하여 필요한 권한을 요청해주세요.

RAG_HTTP_404#

RAG 검색에 실패했습니다. RAG 서버에서 리소스를 찾을 수 없습니다.
RAG 노드 설정에서 RAG 서버 URL 및 엔드포인트 경로가 정확한지 확인해주세요.
RAG 서버가 정상적으로 실행 중인지 확인해주세요.
RAG 서버에 필요한 리소스가 존재하는지 확인해주세요.

RAG_HTTP_429#

RAG 검색 요청이 너무 많아 일시적으로 실패했습니다. RAG 서비스의 요청 제한을 초과했습니다.
RAG 노드의 검색 빈도를 줄여주세요.
RAG 서비스 제공업체의 사용량 제한을 확인하고 늘려주세요.
잠시 후 워크플로우를 다시 실행해주세요.

RAG_HTTP_500#

RAG 노드에서 검색 중 서버 내부 오류가 발생했습니다.
RAG 서비스가 정상적으로 작동하는지 확인해주세요.
RAG 노드의 설정(indexName, query 등)이 올바른지 확인해주세요.
RAG 서비스 제공업체에 문의하여 문제 해결을 요청해주세요.

RAG_HTTP_502#

RAG 검색 중 서버 연결에 문제가 발생했습니다. 일시적인 오류일 수 있습니다.
잠시 후 워크플로우를 다시 실행해주세요.
RAG 노드의 indexName 속성이 올바른지 확인해주세요.
RAG 서비스 제공업체에 문의하여 서비스 상태를 확인해주세요.

RAG_HTTP_503#

RAG 검색에 실패했습니다. RAG 서비스가 일시적으로 사용할 수 없습니다.
잠시 후 워크플로우를 다시 실행해주세요.
문제가 지속되면 관리자에게 문의해주세요.

RAG_HTTP_504#

RAG 검색에 실패했습니다. RAG 서버가 응답 시간이 초과되었습니다.
RAG 서버의 상태를 확인해주세요.
RAG 노드의 indexName 속성이 올바른지 확인해주세요.
RAG 서버 연결 설정을 점검하거나, 관리자에게 문의해주세요.

RAG_HTTP_CLIENT_ERROR#

RAG 노드에서 검색 요청 실패. 요청 파라미터 또는 RAG 서버 설정을 확인해야 합니다.
RAG 노드의 url 속성이 올바른지 확인해주세요.
RAG 서버가 정상적으로 실행 중인지 확인해주세요.
RAG 서버의 API 키가 정확하게 설정되었는지 확인해주세요.
RAG 서버의 네트워크 연결 상태를 확인해주세요.

RAG_HTTP_SERVER_ERROR#

RAG 노드에서 검색을 실패했습니다. RAG 서비스에서 예기치 않은 오류가 발생했습니다.
RAG 서비스가 정상적으로 작동하는지 확인해주세요.
잠시 후 워크플로우를 다시 실행해주세요.
문제가 지속되면 관리자에게 문의해주세요.

처리 에러#


RAG_INVALID_RESPONSE#

RAG 노드에서 검색 결과 형식이 예상과 다릅니다. RAG 서버 응답 구조를 확인해주세요.
RAG 서버 버전과 API 호환성을 확인해주세요.
RAG 서버의 응답 형식이 올바른지 확인해주세요.
워크플로우 빌더의 RAG 노드 설정이 RAG 서버와 호환되는지 확인해주세요.

RAG_MISSING_CONTEXTS#

RAG 노드 검색 결과에서 일치하는 내용을 찾을 수 없습니다.
query를 넓히거나 지식 베이스에 관련 콘텐츠가 있는지 확인해주세요.
RAG 노드의 indexName 속성이 올바른 인덱스를 가리키는지 확인해주세요.
RAG에 사용할 벡터 데이터베이스가 제대로 설정되었는지 확인해주세요.

RAG_UNKNOWN_ERROR#

RAG 노드에서 검색을 실패했습니다. 예상치 못한 오류가 발생했습니다.
RAG 노드의 설정이 올바른지 확인해주세요.
RAG 서버가 정상적으로 작동하는지 확인해주세요.
RAG 서버 로그를 확인하여 문제의 원인을 파악해주세요.
Modified at 2026-05-27 10:32:45
Previous
Post
Next
Response
Built with