지식 소스
관리되는 메모, 페이지, 파일, 동영상, 오디오, 피드에 에이전트 답변의 근거를 둡니다.
관리되는 메모, 페이지, 파일, 동영상, 오디오, 피드에 에이전트 답변의 근거를 둡니다.
지식은 에이전트가 검색할 수 있는 근거 자료입니다. 소스를 추가하면 일반 텍스트를 추출하고 구간으로 나누어 임베딩을 생성한 뒤 현재 사이트와 연결합니다. 답변 시 모든 소스를 매번 프롬프트에 넣지 않고 관련 구간을 검색합니다.
올바른 소스 유형 선택하기#
| 소스 | 적합한 용도 | 중요한 동작 |
|---|---|---|
| 붙여넣기 | 정책, 연락처, 짧은 내부 메모 | 5–200,000자, 자동 새로고침 없음 |
| URL | 다른 곳에서 관리되는 공개 페이지 | 기본 한 페이지, 선택적으로 같은 사이트 5, 10, 20페이지 크롤링 |
| 업로드 | PDF, .txt, .md, .markdown, .csv | 최대 20MB, 이미지 스캔 PDF는 선택 가능한 텍스트 없음 |
| YouTube | 유용한 음성 콘텐츠가 있는 공개 동영상 | 자막을 먼저 시도하고 가능한 전사를 사용, 최선 노력 |
| 팟캐스트 | 공개 에피소드 오디오 URL 또는 지원 피드 | 가져올 수 있는 오디오와 사용 가능한 전사 제공자 필요 |
| 피드 | 공개 RSS/Atom 블로그 또는 팟캐스트 업데이트 | 사용 가능한 피드 항목을 텍스트로 추출, 최선 노력 |
예측 가능한 질문/답변이나 카탈로그 필드는 긴 문서에 묻지 말고 FAQ 및 상품을 사용하세요. FAQ 및 상품을 참고하세요.
소스 추가하기#
- 사이트의 에이전트 페이지에서 지식을 찾습니다.
- 붙여넣기, URL, 업로드, YouTube, 팟캐스트, 피드 중 하나를 선택합니다.
- 콘텐츠를 입력하거나 파일을 선택합니다.
- 일반 URL은 크롤링 페이지 수를 선택합니다. 가져오는 소스는 선택적으로 매일, 매주, 안 함 자동 새로고침을 선택합니다.
- 추가를 누르고 인덱싱된 청크 수 결과를 기다립니다.
- 새 소스에만 답이 있는 질문을 보냅니다.
지식 구간을 임베딩하므로 지식 수집에는 크레딧이 사용됩니다. 워크스페이스 접근이 비활성 상태이거나 사용할 크레딧이 없으면 거부됩니다.
공개 페이지를 안전하게 크롤링하기#
크롤러는 공개 HTTP/HTTPS 콘텐츠를 허용하고 안전하지 않은 사설 네트워크 목적지를 차단합니다. 먼저 대표 페이지 하나로 시작하세요. 연결된 페이지가 같은 유용한 정보 집합일 때만 페이지 수를 늘립니다. 큰 크롤링은 탐색, 법적 상용구, 중복 텍스트, 오래된 아카이브를 추가해 검색 품질을 낮출 수 있습니다.
선택한 수는 최대값이지 보장이 아닙니다. robots 동작, 인증, 클라이언트 전용 렌더링, 리디렉션, 콘텐츠 유형, 응답 크기, 링크 구조에 따라 가져오는 수가 줄 수 있습니다. 페이지 응답은 5MB로 제한되며 충분한 추출 가능 텍스트가 있어야 합니다.
로그인 뒤의 중요한 사실은 인증 페이지를 크롤링하려 하지 말고 승인된 요약을 붙여 넣거나 정제된 내보내기를 업로드하세요.
파일 및 미디어 사용하기#
업로드한 PDF와 텍스트 계열 파일에는 추출 가능한 텍스트가 있어야 합니다. 이미지 전용 스캔 PDF에는 OCR을 수행하지 않으므로 업로드 전에 검색 가능한 텍스트로 변환하세요. 레이아웃이 복잡한 문서는 추출 중 읽기 순서로 평탄화되므로 표를 단순하게 유지합니다.
YouTube 수집은 사용 가능한 자막 트랙을 우선합니다. 자막이 없으면 전사는 제공자와 네트워크에 따라 달라집니다. 팟캐스트 오디오는 공개적으로 가져올 수 있어야 합니다. 피드 결과는 피드가 노출하는 글/에피소드 텍스트 양에 따라 달라집니다. 미디어를 가져온 뒤 전체 녹음이 수집됐다고 가정하지 말고 소스 제목/청크 수를 확인하고 구체적 사실을 테스트하세요.
새로고침 및 교체 계획하기#
URL, YouTube, 팟캐스트, 피드 소스에는 매일/매주 일정을 사용할 수 있습니다. 예약 크롤링이 성공하면 저장된 소스 오리진을 다시 가져와 검색 가능한 구간을 교체합니다. 소스 목록에는 새로고침 주기와 마지막 새로고침 시간이 표시됩니다.
붙여넣기와 업로드는 스냅샷입니다. 수정하거나 교체하려면 삭제하고 최신 콘텐츠를 다시 추가하세요. 소스를 삭제하면 향후 검색에서 구간이 제거되지만 이전 버전을 인용하거나 요약한 과거 메시지는 수정되지 않습니다.
가격, 정책, 일정에는 명확한 단일 소유 소스를 사용하세요. 활성 소스 두 개가 서로 다르면 검색에서 어느 문장이든 나타날 수 있습니다. “새 버전”을 옆에 추가하지 말고 교체된 버전을 제거하세요.
검색 가능한 콘텐츠 작성하기#
- 각 섹션에 주제를 명시합니다. “자세한 내용”보다 “Pro 요금제 취소 정책”이 검색하기 쉽습니다.
- 관련 제목 가까이에 일반 언어로 답을 작성합니다.
- 필요한 경우 단위, 통화, 시간대, 적용일, 예외를 포함합니다.
- 안정적인 대표 URL과 설명적인 파일 이름을 사용합니다.
- 공개 정보와 내부 지침/비공개 기록을 분리합니다.
- 사실 소스가 아니라 페르소나 및 지침에 행동 규칙을 둡니다.
근거 기반 답변 테스트하기#
게시 전 작은 승인 테스트 세트를 만드세요.
- 소스에 답이 명확한 직접 질문.
- 다른 단어를 사용하는 바꿔 말한 질문.
- 소스가 답하지 않는 경계 질문.
- 최근 변경된 사실.
- 설정한 각 에이전트 언어의 변형.
올바른 결과가 항상 확신 있는 답변은 아닙니다. 소스에 사실이 없으면 에이전트가 지어내지 않고 폴백/에스컬레이션 지침을 따라야 합니다. 출시 후 대화에서 반복되는 미답변 질문을 확인하고 검증된 답을 소스나 구조화 FAQ로 만드세요.
문제 해결#
| 증상 | 확인 사항 |
|---|---|
| URL에 사용 가능한 텍스트 없음 | 공개 접근, 지원 콘텐츠 유형, 서버 렌더링 텍스트, 리디렉션 대상, 페이지 크기 |
| PDF에 선택 가능한 텍스트 없음 | 스캔 여부; OCR 후 검색 가능한 PDF 또는 텍스트로 내보내기 |
| YouTube/팟캐스트 가져오기 실패 | 공개 URL, 자막/오디오 가용성, 전사 제공자 키, 가져오기 제한 |
| 올바른 사실을 무시 | 처리 결과, 표현, 충돌 소스, 소스 나이, 정확한 테스트 질문 |
| 에이전트가 너무 많이 공개 | 비공개 소스를 즉시 제거하고 페르소나 경계와 계정 접근 강화 |
| 이전 답변이 계속됨 | 오래된 소스 삭제/교체, 재인덱싱 대기, 새 테스트 대화 시작 |
자격 증명, 개인 키, 제한 없는 고객 내보내기, 건강 기록 등 공개 에이전트가 절대 공개해서는 안 되는 콘텐츠를 업로드하지 마세요.