Dokumente verwalten

Verwalten Sie Ihre Wissensdatenbank über das Wissensdatenbank-Dashboard, die CLI oder die API. Was eine Wissensdatenbank ist und wie Agents sie verwenden, erfahren Sie unter Wissensdatenbank.

Dokumente hinzufügen

Sie können Dokumente aus Dateien, Webseiten oder Klartext erstellen. Fügen Sie sie nach der Erstellung einem Agent hinzu, damit ihre Inhalte in Gesprächen verfügbar sind.

Crawler-User-Agent

URL-Importe und Crawl-Jobs rufen Seiten mit dem User-Agent ElevenlabsBot/1.0 ab.

Der Crawler berücksichtigt auch robots.txt. Seiten, die für ElevenlabsBot oder für alle User-Agents nicht erlaubt sind, werden übersprungen. Prüfen Sie daher Ihre Regeln, wenn eine erwartete indexierte Seite fehlt. So erlauben Sie den Crawler explizit:

User-agent: ElevenlabsBot
Allow: /

Vorhandene Dokumente zu einem Agent hinzufügen

Dokumente können agentübergreifend wiederverwendet werden. Gemeinsames Wissen muss daher nur einmal gepflegt werden.

1. Navigieren Sie zur Konfiguration des Agents.
2. Suchen Sie den Abschnitt Wissensdatenbank und klicken Sie auf Dokument hinzufügen.
3. Wählen Sie ein vorhandenes Dokument aus Ihrer Wissensdatenbank aus oder laden Sie ein neues hoch.

Dokumente bearbeiten

Sie können den Inhalt eines Dokuments direkt bearbeiten, statt es zu löschen und erneut hochzuladen. Beim Bearbeiten eines Dokuments werden seine Inhalts-Suchsegmente und RAG-Embeddings automatisch neu erstellt. So bleiben Suche und Agent-Abruf synchron.

• Text- und Dateidokumente: Bearbeiten Sie den Inhalt direkt und speichern Sie ihn.
• Dateidokumente: Alternativ können Sie die zugrunde liegende Datei durch eine neue Version ersetzen.
• URL-Dokumente: Bearbeiten Sie den Inhalt, wenn die automatische Synchronisierung deaktiviert ist. Wenn sie aktiviert ist, verwaltet der Synchronisierungszyklus das Dokument und manuelle Bearbeitungen sind blockiert.

# 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-Inhalte aktuell halten

Dokumente, die aus einer URL erstellt wurden, können aktualisiert werden, um die neuesten Inhalte ihrer Quelle erneut abzurufen. Durch die Aktualisierung wird das Dokument neu indexiert, sodass RAG-fähige Agents die aktualisierten Inhalte verwenden.

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

Im Dashboard können Sie auch die automatische Synchronisierung aktivieren, um URL-Dokumente nach einem Zeitplan automatisch zu aktualisieren. So bleiben ihre Inhalte ohne manuelle Aktualisierungen aktuell.

Mit Ordnern organisieren

Ordner gruppieren zusammengehörige Dokumente, sodass sie leichter zu verwalten und gesammelt anzuhängen sind. Erstellen Sie einen Ordner und verschieben Sie dann Dokumente über das Dashboard oder die API hinein.

Ein an einen Agent angehängter Ordner macht alle seine Dokumente über RAG verfügbar. Der Agent muss daher RAG aktiviert haben, um Ordner verwenden zu können.

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

Abhängigkeiten und Löschung

Jedes Dokument hat einen Tab Abhängige Agents, der die Agents auflistet, die aktuell davon abhängen.

Ein Dokument kann nicht gelöscht werden, solange ein Agent davon abhängt. Entfernen Sie das Dokument zuerst aus diesen Agents oder verwenden Sie die erzwungene Löschung, um es auf einmal von allen Abhängigkeiten zu trennen.