Das Streaming Avatar SDK von AKOOL bietet bereits die Grundlage für Echtzeit-Interaktionen in Video, Audio, Text und Mikrofon. Der nächste Schritt besteht darin, diesen Avatar für Ihr Unternehmen nutzbar zu machen, indem Sie ihn mit vertrauenswürdigen Produktdokumentationen, Richtlinien, Schulungsmaterialien oder Support-Inhalten verknüpfen.
Dieser Leitfaden konzentriert sich auf diese Wissensebene. Sie erstellen eine AKOOL Knowledge Base, verbinden sie mit einer Streaming-Avatar-Sitzung über die knowledge_idund stellen sicher, dass der Avatar fundierte Antworten innerhalb Ihrer eigenen Anwendung liefert.
Die offizielle SDK-Dokumentation zeigt Ihnen, wie Sie einen Avatar streamen. Dieser Leitfaden zeigt Ihnen, wie Sie diesen Avatar dazu bringen, Ihr Unternehmen zu verstehen.
Was Sie erstellen
Das fertige Erlebnis kombiniert drei Komponenten: Ihre genehmigten Wissensquellen, eine AKOOL Knowledge Base, die diese Quellen für Konversationen aufbereitet, und einen in Ihre Anwendung eingebetteten Streaming-Avatar. Wenn ein Benutzer eine Frage stellt, nutzt der Avatar die verbundene Wissensdatenbank als Kontext und gibt die Antwort über synchronisierte Sprache und Video aus.
Die Verbindung zwischen der Wissensebene und der Live-Sitzung ist das knowledge_id -Feld. Es wird bei der Erstellung der Streaming-Avatar-Sitzung hinzugefügt, bevor der Browser dem Echtzeit-Kanal beitritt.
Die Wissensquellen werden innerhalb von AKOOL verarbeitet und durch eine knowledge_idrepräsentiert. Ihr Backend fügt diese ID hinzu, wenn es die Streaming-Avatar-Sitzung erstellt. Der Browser tritt dann über das AKOOL SDK der zurückgegebenen Sitzung bei, wodurch der Avatar mit dem genehmigten Wissen antworten kann, während die Anmeldedaten auf dem Server verbleiben.
Wählen Sie Ihren Entwicklungspfad
Wenn Sie schnell einen funktionierenden Prototyp benötigen, kopieren Sie den unten stehenden Prompt in einen KI-Coding-Agenten. Wenn Sie bereits eine AKOOL Streaming-Avatar-Integration haben – oder den Workflow lieber selbst konfigurieren möchten – fahren Sie mit dem Quick Start fort. Beide Wege führen zum gleichen Ergebnis: ein Live-Avatar, dessen Antworten auf Ihren eigenen Inhalten basieren.
Option 1: Entwicklung mit einem KI-Agenten
Kopieren Sie diesen Prompt in Ihren bevorzugten KI-Coding-Agenten und geben Sie bei Aufforderung Ihre AKOOL-Konfiguration an.
Prompt für den KI-Agenten
Build a knowledge-powered AKOOL Streaming Avatar application.
Use AKOOL’s official Streaming Avatar SDK Quick Start as the implementation reference:
https://docs.akool.com/sdk/jssdk-start
Start from the official SDK workflow instead of recreating a generic streaming demo. Add the following knowledge-base workflow:
1. Create the avatar session from a backend endpoint.
2. Read the Avatar ID, Knowledge Base ID, optional Voice ID, language, and duration from server-side configuration.
3. Include knowledge_id and mode_type: 2 in the session-creation request.
4. Return only the temporary session credentials required by the browser.
5. Use the official AKOOL JavaScript SDK for video, audio, text, microphone, and interruption controls.
6. Add an explicit End Session action.
7. Provide a small test panel for an exact-source question, a paraphrased question, and an out-of-scope question.
Keep the interface simple and use the linked AKOOL documentation as the source of truth.Option 2: Folgen Sie dem Quick Start
Wählen Sie diesen Weg, wenn Sie die Wissensebene zu einer bestehenden Anwendung hinzufügen möchten oder die Integration verstehen wollen, bevor Sie sie an einen KI-Agenten übergeben.
Bevor Sie beginnen
Sie benötigen ein AKOOL-Konto mit API-Zugriff, eine Streaming-Avatar-ID und eine funktionierende Streaming-Avatar-Anwendung, die auf dem offiziellen JavaScript-SDK basiert. Sie können Streaming Avatar in AKOOL erstellen oder verwalten. Bereiten Sie die Dokumente oder öffentlichen URLs vor, die der Avatar verwenden soll. Eine Voice ID ist optional.
Falls Sie noch keine Verbindung zum Streaming Avatar hergestellt haben, schließen Sie zuerst den Streaming Avatar SDK Quick Start ab. Dieser Artikel wiederholt bewusst nicht die Schritte zur Installation, Kanalverbindung oder Medienverarbeitung.
Schritt 1: Wissensquellen vorbereiten
Laden Sie unterstützte Dokumente hoch oder fügen Sie öffentliche URLs hinzu. Für einen einfachen ersten Test ist ein sauberes, gut strukturiertes DOCX ein praktischer Ausgangspunkt. Konzentrieren Sie jede Quelle auf ein Thema, damit die Wissensdatenbank die richtige Passage zuverlässig abrufen kann.
Beginnen Sie mit einem kleinen, maßgeblichen Quellensatz und einem begrenzten Testumfang. Nachdem die ersten Fragen präzise beantwortet wurden, fügen Sie in kontrollierten Schritten weitere Dokumente oder URLs hinzu und testen Sie erneut.
Schritt 2: AKOOL-Wissensdatenbank erstellen
Füllen Sie die grundlegenden Einrichtungsfelder aus: einen eindeutigen Namen, eine Eröffnungssequenz (Prolog in der API), einen Anweisungs-Prompt sowie die unterstützten Dokumente oder öffentlichen URLs, die AKOOL als Quellen verwenden soll.
Eröffnungssequenz (Prolog): Schreiben Sie die erste Nachricht, die der Avatar zu Beginn der Sitzung sagen soll. Halten Sie sie kurz, einladend und auf den Umfang der Wissensdatenbank abgestimmt.
Prompt: „Beantworte Fragen unter Verwendung der zugelassenen Wissensquellen. Sei prägnant und hilfreich. Wenn die Information nicht verfügbar ist, sage dies deutlich und schlage den nächsten Support-Schritt vor.“
Warten Sie, bis die Verarbeitung der Quellen abgeschlossen ist, und kopieren Sie dann die Knowledge Base ID. AKOOL verwendet diesen Wert als knowledge_id für die Live-Sitzung.
Schritt 3: Wissensdatenbank mit der Sitzung verbinden
Fügen Sie beim Erstellen der Streaming-Avatar-Sitzung über Ihr Backend die Knowledge-Base-ID zur Anfrage hinzu. Verwenden Sie den Dialogmodus, damit der Avatar Fragen beantworten und das Gespräch fortführen kann.
Beispiel für die Sitzungskonfiguration
{
"avatar_id": "your_avatar_id",
"voice_id": "your_voice_id",
"knowledge_id": "your_knowledge_id",
"mode_type": 2
}Der entscheidende Punkt ist der Zeitpunkt: knowledge_id gehört in die Sitzungserstellung, nicht in den joinChat() -Aufruf des Browsers. Sobald die Sitzung erstellt ist, kann der Browser eine Verbindung mit den von AKOOL zurückgegebenen temporären Anmeldedaten herstellen und den Standard-SDK-Interaktionsablauf nutzen.
Erstellen Sie die Sitzung über Ihr Backend und nicht direkt im Browser, damit der API-Schlüssel geschützt bleibt. Dieses cURL-Beispiel sendet die Knowledge-Base-ID bei der Sitzungserstellung und aktiviert den Dialogmodus mit mode_type: 2.
Erstellen einer wissensbasierten Streaming-Avatar-Sitzung
curl --request POST \
--url https://openapi.akool.com/api/open/v4/liveAvatar/session/create \
--header "Content-Type: application/json" \
--header "x-api-key: <api-key>" \
--data '{
"avatar_id": "<avatar-id>",
"voice_id": "<voice-id>",
"language": "en",
"duration": 600,
"mode_type": 2,
"knowledge_id": "<knowledge-id>",
"stream_type": "agora"
}'Speichern Sie die zurückgegebenen Sitzungsdaten auf dem Server, übermitteln Sie nur die erforderlichen Join-Werte an Ihren Client und verwenden Sie diese zur Initialisierung des AKOOL Streaming Avatar SDK.
Schritt 4: Hinzufügen des Avatars zu Ihrer Anwendung
Verwenden Sie das AKOOL JavaScript SDK, um dem Echtzeitkanal beizutreten, den Chat im Dialogmodus zu starten, Video und Audio wiederzugeben sowie Text- oder Mikrofoneingaben zu senden. Dieser Teil entspricht dem offiziellen SDK-Schnellstart; Ihre anwendungsspezifische Aufgabe besteht darin, festzulegen, wo der Avatar erscheint und wie Benutzer ein Gespräch beginnen, unterbrechen oder beenden.
Belassen Sie die Wissenskonfiguration im Prozess der Sitzungserstellung. So kann dasselbe Frontend verschiedene Produkte, Regionen oder Zielgruppen unterstützen, indem auf dem Backend jeweils eine andere autorisierte Knowledge-Base-ID ausgewählt wird.
Schritt 5: Überprüfung der fundierten Antworten
Hören Sie nicht auf, sobald der Avatar erfolgreich verbunden ist. Überprüfen Sie, ob er tatsächlich das vorgesehene Wissen nutzt und angemessen reagiert, wenn keine Antwort verfügbar ist.
Fehlerbehebung bei häufigen Problemen mit der Knowledge Base
Der Avatar ignoriert die Knowledge Base. Stellen Sie sicher, dass die korrekte knowledge_id in der Anfrage zur Sitzungserstellung enthalten ist. Eine Knowledge Base kann im Dashboard existieren, ohne mit der aktiven Streaming-Avatar-Sitzung verknüpft zu sein.
Inhalte der Wissensdatenbank wurden nicht gefunden. Stellen Sie vor dem Testen sicher, dass die Verarbeitung aller hochgeladenen Dateien oder öffentlichen URLs abgeschlossen ist. Wenn die Verarbeitung noch aussteht oder fehlgeschlagen ist, sind die Inhalte noch nicht abrufbar.
Die Antworten sind widersprüchlich. Entfernen Sie veraltete, doppelte oder widersprüchliche Quellen. Behalten Sie für jeden Fakt eine maßgebliche Version bei, verwenden Sie klare Überschriften und testen Sie erneut mit direkten Fragen, deren Antworten explizit in den Quellen enthalten sind.
Die Sitzung funktioniert, aber der Dialog nicht. Überprüfen Sie, ob die Sitzung mit mode_type: 2erstellt wurde. Stellen Sie anschließend sicher, dass das SDK der vom Backend zurückgegebenen Sitzung beitritt und dass Avatar, Stimme, Sprache sowie die Sitzungskonfiguration gültig sind. Wenn Sie während des Debuggens eine Ersatzsitzung erstellen, achten Sie darauf, dass der Client keine abgelaufenen Anmeldedaten aus einer früheren Antwort verwendet.
Anwendungsfälle
Kundensupport. Ermöglichen Sie Besuchern, Fragen zu Produkten, Einrichtung, Garantie oder Richtlinien über eine natürlichere Schnittstelle als eine herkömmliche Hilfecenter-Suche zu stellen.
Produktfindung. Führen Sie Interessenten mithilfe von freigegebenen Vertriebs- und Produktinhalten durch Funktionen, Pläne und empfohlene Arbeitsabläufe.
Mitarbeiterschulung. Verwandeln Sie Onboarding-Leitfäden und interne Verfahren in einen interaktiven Schulungsassistenten.
Bildung und Veranstaltungen. Bieten Sie Lernenden oder Teilnehmern einen Live-Präsentator, der Fragen zu Kursmaterialien, Rednernotizen oder Veranstaltungsressourcen beantworten kann.
Checkliste für den Start
☐ Wissensquellen sind aktuell, maßgeblich und vollständig verarbeitet.
☐ Das beabsichtigte knowledge_id ist bei der Erstellung der Sitzung enthalten.
☐ Exakte Fragen, paraphrasierte Fragen, Fragen außerhalb des Themenbereichs sowie Folgefragen wurden getestet.
☐ Die Anwendung bietet klare Steuerelemente für Start, Unterbrechung und Beendigung einer Sitzung.
☐ Das finale Erlebnis wurde sowohl mit Texteingabe als auch mit Mikrofoneingabe getestet.
Ressourcen
- AKOOL Wissensdatenbank
- Streaming-Avatar-Sitzung erstellen
- Streaming Avatar SDK Quick Start
- Best Practices für das Streaming Avatar SDK
Häufig gestellte Fragen
Was ist knowledge_id in AKOOL Streaming Avatar?
knowledge_id ist die Kennung für eine AKOOL Knowledge Base. Wenn Sie diese zu einer Streaming Avatar-Sitzung hinzufügen, erfährt AKOOL, welche verarbeiteten Dokumente und URLs der Avatar bei der Beantwortung wissensbasierter Fragen verwenden soll.
Wann sollte ich knowledge_id zur Streaming Avatar-Sitzung hinzufügen?
Fügen Sie sie während der Sitzungserstellung auf Ihrem Backend hinzu, bevor der Browser der Sitzung beitritt. Dies stellt sicher, dass die Knowledge Base von Anfang an eingebunden ist, und verhindert, dass Ihr AKOOL-API-Schlüssel im clientseitigen Code offengelegt wird.
Welche Dateitypen kann eine AKOOL Knowledge Base verwenden?
AKOOL-Dokumente unterstützen PDF-, DOC-, DOCX-, TXT-, MD-, JSON-, XML- und CSV-Dateien. Sie können auch öffentliche URLs hinzufügen. Verwenden Sie saubere, aktuelle Quellen mit aussagekräftigen Überschriften und warten Sie den Abschluss der Verarbeitung ab, bevor Sie den Abruf testen.
Kann ich ein externes LLM oder eine RAG-Knowledge-Base direkt verbinden?
Der dokumentierte Streaming Avatar-Workflow verwendet eine AKOOL Knowledge Base: Fügen Sie Dokumente oder URLs hinzu, rufen Sie deren knowledge_idab und geben Sie diese ID bei der Erstellung der Sitzung an. Gehen Sie nicht davon aus, dass eine beliebige externe Vektordatenbank oder ein RAG-Dienst direkt eingebunden werden kann, es sei denn, Sie entwerfen und validieren eine separate Integration auf Anwendungsebene.
