문서 관리

지식 베이스 대시보드, CLI 또는 API에서 지식 베이스를 관리하세요. 지식 베이스의 정의와 에이전트의 활용 방법은 지식 베이스를 참조하세요.

문서 추가

문서는 파일, 웹페이지 또는 일반 텍스트로 만들 수 있습니다. 만든 후 에이전트에 연결하면 대화에서 해당 내용을 사용할 수 있습니다.

크롤러 사용자 에이전트

URL 가져오기와 크롤링 작업은 사용자 에이전트 ElevenlabsBot/1.0을 사용해 페이지를 가져옵니다.

크롤러는 robots.txt도 준수합니다. ElevenlabsBot 또는 모든 사용자 에이전트에 대해 허용되지 않은 페이지는 건너뛰므로, 색인화될 것으로 예상한 페이지가 누락된 경우 규칙을 확인하세요. 크롤러를 명시적으로 허용하려면 다음과 같이 설정하세요.

User-agent: ElevenlabsBot
Allow: /

기존 문서를 에이전트에 추가

문서는 여러 에이전트에서 재사용할 수 있으므로 공유 지식은 한 번만 관리하면 됩니다.

1. 에이전트 구성으로 이동하세요.
2. 지식 베이스 섹션을 찾아 문서 추가를 클릭하세요.
3. 지식 베이스에서 기존 문서를 선택하거나 새 문서를 업로드하세요.

문서 편집

문서를 삭제하고 다시 업로드하는 대신 콘텐츠를 직접 편집할 수 있습니다. 문서를 편집하면 콘텐츠 검색 청크와 RAG 임베딩이 자동으로 다시 생성되므로 검색과 에이전트 검색 결과가 동기화된 상태로 유지됩니다.

• 텍스트 및 파일 문서: 콘텐츠를 인라인으로 편집하고 저장하세요.
• 파일 문서: 또는 원본 파일을 새 버전으로 교체하세요.
• URL 문서: 자동 동기화가 꺼져 있을 때 콘텐츠를 편집하세요. 자동 동기화가 켜져 있으면 동기화 주기가 문서를 관리하며 수동 편집은 차단됩니다.

# Update a document's name or content
elevenlabs.conversational_ai.knowledge_base.documents.update(
    documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
    name="Unladen Swallow Facts",
    content="The airspeed velocity of an unladen swallow (European) is 24 miles per hour.",
)
# Replace the underlying file of a file document
elevenlabs.conversational_ai.knowledge_base.document.update_file(
documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
file=open("/path/to/unladen-swallow-facts-v2.txt", "rb"),
)

URL 콘텐츠 최신 상태 유지

URL에서 만든 문서는 새로고침하여 소스에서 최신 콘텐츠를 다시 가져올 수 있습니다. 새로고침하면 문서가 다시 색인화되므로 RAG가 활성화된 에이전트가 업데이트된 콘텐츠를 사용합니다.

elevenlabs.conversational_ai.knowledge_base.document.refresh(
    documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
)

대시보드에서는 자동 동기화를 활성화하여 일정에 따라 URL 문서를 자동으로 새로고침할 수도 있으므로, 수동 업데이트 없이도 콘텐츠를 최신 상태로 유지할 수 있습니다.

폴더로 정리

폴더는 관련 문서를 그룹화하여 더 쉽게 관리하고 한 번에 연결할 수 있게 해줍니다. 폴더를 만든 다음 대시보드나 API에서 문서를 폴더로 옮기세요.

에이전트에 연결된 폴더는 모든 문서를 RAG를 통해 사용할 수 있게 하므로, 폴더를 사용하려면 에이전트에서 RAG를 활성화해야 합니다.

# Create a folder
folder = elevenlabs.conversational_ai.knowledge_base.documents.create_folder(
    name="Product documentation",
)
# Move a document into the folder
elevenlabs.conversational_ai.knowledge_base.documents.move(
document_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
move_to=folder.id,
)

종속성 및 삭제

각 문서에는 현재 해당 문서에 종속된 에이전트를 나열하는 종속 에이전트 탭이 있습니다.

에이전트가 종속되어 있는 동안에는 문서를 삭제할 수 없습니다. 먼저 해당 에이전트에서 문서를 제거하거나 강제 삭제를 사용해 모든 종속 항목에서 한 번에 분리하세요.