Skip to main content

Überblick

Mit Widget-Kontext kann sich ein Chatbot an die Seite oder den Standort anpassen, auf der er eingebettet ist. Das Widget sendet Kontextwerte mit jeder Chat-Anfrage, und Ihr Agent verwendet sie nur, wenn Sie sie im System-Prompt mit Platzhaltern wie {{ page_path }} oder {{ location }} referenzieren. Verwenden Sie Widget-Kontext, wenn derselbe Agent auf mehreren Seiten, in mehreren Filialen, Abteilungen oder Kundenstandorten eingebettet ist und mit den passenden lokalen Details antworten soll.
Kontextwerte sind Daten, keine Anweisungen. Sie ändern Ihren Agenten nur, wenn Ihr gespeicherter Prompt einen passenden Platzhalter enthält.

Wo Sie es konfigurieren

1

Platzhalter im Playground hinzufügen

Öffnen Sie Ihren Agenten im Dashboard, gehen Sie zu Playground und bearbeiten Sie Anweisungen (System-Prompt). Fügen Sie Platzhalter mit doppelten geschweiften Klammern hinzu, zum Beispiel {{ location }}.
2

Kontext im Einbettungscode übergeben

Gehen Sie zu Bereitstellen → Chat-Widget, kopieren Sie den Einbettungscode und ergänzen Sie ein context-Objekt in humanizing.init.
3

Auf der eingebetteten Seite testen

Öffnen Sie die Seite, auf der das Widget installiert ist, starten Sie eine Konversation und prüfen Sie, ob der Agent mit dem Seiten- oder benutzerdefinierten Wert antwortet.

Automatischer Seitenkontext

Das Einbettungsskript sendet automatisch diese Werte von der aktuellen Seite. Wenn ein Besucher zum Beispiel https://example.com/products/widget?utm_source=newsletter#details öffnet, sendet das Widget: Bei Single-Page-Applications aktualisiert das Widget diesen Seitenkontext, wenn sich die Browser-URL ändert.

Prompt-Beispiel

Fügen Sie dies unter Playground → Anweisungen (System-Prompt) ein:
Betten Sie das Widget dann mit dem Standard-Snippet ein:

Benutzerdefinierter Kontext

Sie können auch eigene Kontextwerte als zweiten Parameter an humanizing.init übergeben.
Referenzieren Sie diese Werte anschließend im System-Prompt:
Zur Anfragezeit erhält der Agent:
Nutzen Sie benutzerdefinierten Kontext für Werte, die Ihre Website kennt, zum Beispiel Filiale, Markt, Produktlinie, Kampagne, Kundensegment oder Sprachvariante.

Regeln und Grenzen

Fügen Sie keine Anweisungen, Secrets, Zugriffstoken oder privaten Kundendaten in den Widget-Kontext ein. Der Einbettungscode läuft im Browser des Besuchers und sollte nur Daten enthalten, die auf dieser Seite sichtbar sein dürfen.

Häufige Muster

Agent für mehrere Standorte

Verwenden Sie denselben Agenten für mehrere Filialen:

Seitenbewusster Support

Teilen Sie dem Agenten mit, auf welcher Seite sich der Besucher befindet:

Unterschiedliche Abteilungen

Nutzen Sie einen Agenten auf verschiedenen Abteilungsseiten:

Fehlerbehebung

Prüfen Sie, ob der Schlüssel im Prompt exakt zum Schlüssel im Kontextobjekt passt. {{ location }} wird zum Beispiel nur aufgelöst, wenn der Embed-Code context: { location: "North Branch" } sendet.
Stellen Sie sicher, dass der Wert ein String, eine Zahl oder ein Boolean ist. Objekte, Arrays, null-Werte und Schlüssel, die mit einem Unterstrich beginnen, werden ignoriert.
In den meisten Single-Page-Applications aktualisiert das Widget den Seitenkontext nach Routenwechseln. Wenn Ihr Framework Inhalte ändert, ohne die Browser-URL zu ändern, übergeben Sie beim Initialisieren oder Aktualisieren des Widgets einen benutzerdefinierten Kontextwert.

Nächste Schritte

Prompts bearbeiten

Fügen Sie Platzhalter zu Ihren Agenten-Anweisungen hinzu.

Widget einbetten

Ergänzen Sie Kontext in Ihrem Widget-Snippet.