다크 모드
FAQ
AI Forge Console을 사용하면서 자주 확인하는 항목을 현재 화면 기준으로 정리했습니다.
시작과 애플리케이션
처음에는 어디서 시작하나요?
빠른 시작 가이드를 따라 LLM 자격 증명을 확인하고, 애플리케이션 생성·기본 설정·파이프라인 구성 순서로 진행하세요. 문서 검색이 필요하면 지식 베이스를 먼저 준비해도 됩니다.
애플리케이션을 생성할 수 없습니다.
현재 Console은 목록 화면에 생성 가능 개수나 할당량을 표시하지 않습니다. 애플리케이션 추가 버튼과 공개 범위 입력이 활성화되어 있는지 확인하고, 권한 문제로 보이면 ADMIN 또는 MANAGER 사용자에게 현재 역할과 그룹 권한을 확인해 달라고 요청하세요.
애플리케이션을 삭제하면 복구할 수 있나요?
삭제한 애플리케이션은 Console에서 복구할 수 없습니다. 연결 리소스와 필요한 이력을 확인한 뒤 삭제하세요.
지식 베이스와 검색
문서는 어디에서 추가하나요?
지식 베이스 자체가 아니라 Document 컬렉션의 문서 탭에서 직접 추가하거나, 데이터소스 탭에 수집 소스를 연결한 뒤 적재합니다. QA 컬렉션에서는 질문·답변 쌍을 직접 관리합니다.
수동 업로드에서 지원하는 파일 형식은 무엇인가요?
데이터소스의 수동 업로드는 DOCX, XLSX, PPTX, HWP, HWPX, PDF, TXT, MD, CSV, HTML, HTM, JSON, XML, YAML, YML을 지원하며 파일당 기본 최대 크기는 40 MB입니다. 이 목록에 없는 형식은 업로드할 수 없습니다.
Embedding 모델이나 VectorDB를 나중에 바꿔도 되나요?
기존 컬렉션의 벡터는 선택한 Embedding 모델과 VectorDB를 기준으로 만들어집니다. 연결을 바꿔야 한다면 새 지식 베이스를 만들고 데이터를 다시 적재하는 흐름을 권장합니다.
검색 결과가 나오지 않습니다.
다음 순서로 확인하세요.
- 컬렉션의 문서와 적재 이력이 완료 상태인지 확인합니다.
- 질문 표현을 원문에 가까운 용어로 바꿉니다.
- 점수 임계값을 낮추고 상위 K를 늘립니다.
- 벡터, 전체 텍스트, 하이브리드 검색 결과를 비교합니다.
- 정답 청크가 후보에 포함된 뒤에 Rerank를 적용합니다.
자세한 설정은 검색 테스트를 참고하세요.
하이브리드 비율을 1:0으로 했는데 벡터 검색과 결과가 다릅니다.
하이브리드 검색과 벡터 검색은 서로 다른 검색 방법이며, 표시하는 점수 기준도 다를 수 있습니다. 같은 방식 안에서 상위 결과와 근거 문서를 비교하고, 벡터 검색 단독 결과가 필요하면 검색 방법 자체를 벡터 검색으로 선택하세요.
Rerank 모델을 선택할 수 없습니다.
Rerank 자격 증명이 등록되어 있고 현재 사용자에게 접근 권한이 있어야 합니다. 자격 증명의 공개 범위와 그룹 권한도 함께 확인하세요.
데이터소스
수집 실패 원인은 어디에서 확인하나요?
데이터소스 상세의 수집 이력에서 작업 상태, 성공·실패·스킵 건수와 실패 파일의 오류 메시지를 확인합니다. 일부 파일만 실패했다면 실패 항목만 재수집을 사용할 수 있습니다.
웹 페이지 내용이 비어 있거나 일부만 수집됩니다.
페이지 유형을 동적 페이지로 바꾸거나 CSS 셀렉터를 조정하세요. 로그인이 필요한 페이지는 Login URL, 계정 정보나 인증 헤더도 확인합니다.
자동 수집 시간이 예상과 다릅니다.
스케줄의 실행 시간과 시간대를 함께 확인하세요. 매시간·매일·매주·매월 주기마다 필요한 분, 시각, 요일 또는 일자 설정이 다릅니다.
모델과 프롬프트
사용할 수 있는 LLM은 어떻게 결정되나요?
현재 환경에서 활성화된 제공업체와 모델이 LLM 자격 증명 등록 화면에 표시됩니다. 필요한 모델이 보이지 않으면 관리자에게 모델 활성화 상태를 확인하세요.
Temperature는 어떤 값으로 설정하나요?
현재 LLM 자격 증명에서는 0에서 1 사이 값을 사용합니다. 낮은 값은 일관성을, 높은 값은 표현의 다양성을 높입니다. 품질 비교 시 다른 설정을 고정하고 조정하세요.
프롬프트는 어디에서 관리하나요?
독립된 프롬프트 목록이나 버전 이력 화면은 없습니다. 애플리케이션의 파이프라인에서 프롬프트를 사용하는 노드를 선택하고 우측 패널에서 수정·저장합니다.
연동
MCP 서버와 API 도구의 차이는 무엇인가요?
MCP 서버는 서버가 공개한 도구와 입력 스키마를 불러오는 방식입니다. API 도구는 Base URL, 인증과 REST 엔드포인트를 Console에서 직접 정의하거나 OpenAPI 파일로 가져오는 방식입니다.
API 도구를 어디에서 테스트하나요?
현재 API 도구 화면에는 별도 실행 테스트 탭이 없습니다. 그룹의 인증 정보와 각 도구의 메서드, Path, 파라미터 스키마를 검토한 뒤 애플리케이션에 연결해 호출 흐름을 확인하세요.
MCP 서버 인증이 필요합니다.
인증 유형이 OAuth이면 목록에서 인증 절차를 진행합니다. Server Key 또는 Client Key를 사용하면 등록 화면의 인증 헤더 이름과 값을 확인하세요.
정책과 권한
금칙어는 어떻게 동작하나요?
애플리케이션별로 등록한 금칙어가 사용자 질문에 포함되면 답변을 생성하지 않습니다. 애플리케이션의 파이프라인 탭에서 금칙어 노드를 선택하고 금칙어 관리를 열어 목록과 사용 여부를 확인하세요.
사용량 제한 값을 저장할 수 없습니다.
API 호출·토큰·비용 한도는 1 이상의 정수로, 차단 임계치는 50~130 사이의 정수로 입력해야 합니다. 값을 변경하지 않았거나 입력값이 유효하지 않으면 저장 버튼이 비활성화됩니다. 올바른 값을 입력해도 저장되지 않으면 현재 역할이 MANAGER인지와 사용량 제한 API 연결 상태를 확인하세요.
사용자 역할과 그룹 권한은 어떻게 다른가요?
사용자 역할은 ADMIN, MANAGER, MEMBER이고, 그룹 안의 리소스 권한은 OWNER, EDITOR, VIEWER입니다. 리소스의 공개 범위와 두 권한이 함께 실제 작업 가능 범위를 결정합니다.
품질과 이력
평가 결과는 어떻게 비교하나요?
같은 Golden Set 버전과 평가 프로필로 실행한 결과를 비교하세요. 질문 세트나 메트릭 구성이 다르면 점수 변화의 원인을 분리하기 어렵습니다.
대화 이력과 피드백은 어디에 있나요?
먼저 애플리케이션을 선택한 뒤 이력 관리 탭으로 이동합니다. 대화 이력과 사용자 피드백이 하위 메뉴로 제공되며, 전역 모니터링 메뉴는 없습니다.
LLM 호출 오류는 어디에서 확인하나요?
독립된 LLM 이력 목록은 없습니다. 대화 상세에서 노드를 선택해 해당 요청의 프롬프트, 모델 응답, 처리 시간과 오류 정보를 확인합니다.
문제 해결
애플리케이션 호출이 실패합니다.
- LLM 자격 증명의 엔드포인트와 인증 정보를 확인합니다.
- 애플리케이션 기본 설정에서 LLM과 필요한 리소스가 연결되어 있는지 확인합니다.
- 파이프라인 노드가 활성화되어 있고 필요한 프롬프트가 저장됐는지 확인합니다.
- 대화 상세의 노드별 호출 정보에서 오류가 난 단계를 찾습니다.
- 사용량에서 같은 시점의 요청·비용 추이를 확인합니다.
로그인할 수 없습니다.
이메일과 비밀번호를 확인하고, 계정 상태가 차단·잠김·가입 대기 상태인지 관리자에게 문의하세요. 비밀번호를 잊었다면 로그인 화면의 재설정 흐름을 사용합니다.