Zarządzanie dokumentami

Zarządzaj bazą wiedzy z poziomu panelu bazy wiedzy, CLI lub API. Więcej o tym, czym jest baza wiedzy i jak korzystają z niej agenci, znajdziesz w artykule Baza wiedzy.

Dodawanie dokumentów

Dokumenty możesz tworzyć z plików, stron internetowych lub zwykłego tekstu. Po utworzeniu przypnij je do agenta, aby ich treść była dostępna w rozmowach.

User agent crawléra

Importy URL i zadania crawlowania pobierają strony z user agentem ElevenlabsBot/1.0.

Crawler respektuje też robots.txt. Strony niedozwolone dla ElevenlabsBot lub wszystkich user agentów są pomijane, więc sprawdź reguły, jeśli brakuje strony, która powinna zostać zindeksowana. Aby wyraźnie zezwolić crawlerowi:

User-agent: ElevenlabsBot
Allow: /

Dodawanie istniejących dokumentów do agenta

Dokumenty możesz wykorzystywać ponownie w różnych agentach, więc wspólną wiedzę wystarczy utrzymywać tylko raz.

1. Przejdź do konfiguracji agenta.
2. Znajdź sekcję bazy wiedzy i kliknij Dodaj dokument.
3. Wybierz istniejący dokument z bazy wiedzy lub prześlij nowy.

Edytowanie dokumentów

Możesz edytować treść dokumentu bezpośrednio, zamiast go usuwać i ponownie przesyłać. Edycja dokumentu automatycznie odtwarza fragmenty do wyszukiwania treści i embeddingi RAG, dzięki czemu wyszukiwanie i pobieranie danych przez agenta pozostają zsynchronizowane.

• Dokumenty tekstowe i pliki: Edytuj treść bezpośrednio i zapisz.
• Dokumenty plikowe: Możesz też zastąpić plik źródłowy nową wersją.
• Dokumenty URL: Edytuj treść, gdy automatyczna synchronizacja jest wyłączona. Gdy jest włączona, cykl synchronizacji zarządza dokumentem, a ręczna edycja jest zablokowana.

# 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"),
)

Aktualizowanie treści URL

Dokumenty utworzone z URL można odświeżać, aby ponownie pobrać najnowszą treść ze źródła. Odświeżenie ponownie indeksuje dokument, dzięki czemu agenci z RAG używają zaktualizowanej treści.

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

W panelu możesz też włączyć automatyczną synchronizację, aby odświeżać dokumenty URL automatycznie według harmonogramu. Dzięki temu ich treść pozostaje aktualna bez ręcznych zmian.

Organizowanie w folderach

Foldery grupują powiązane dokumenty, ułatwiając zarządzanie nimi i przypinanie ich zbiorczo. Utwórz folder, a następnie przenieś do niego dokumenty z panelu lub przez API.

Folder przypięty do agenta udostępnia przez RAG wszystkie zawarte w nim dokumenty, więc agent musi mieć włączone RAG, aby używać folderów.

# 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,
)

Zależności i usuwanie

Każdy dokument ma kartę Zależni agenci, która zawiera listę agentów obecnie od niego zależnych.

Nie można usunąć dokumentu, gdy zależy od niego agent. Najpierw usuń dokument z tych agentów albo użyj wymuszonego usunięcia, aby odpiąć go od wszystkich zależnych agentów naraz.