Documentation Index
Fetch the complete documentation index at: https://docs.cosmo.humanizing.com/llms.txt
Use this file to discover all available pages before exploring further.
Ü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
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 }}.Kontext im Einbettungscode übergeben
Gehen Sie zu Bereitstellen → Chat-Widget, kopieren Sie den Einbettungscode und ergänzen Sie ein
context-Objekt in humanizing.init.Automatischer Seitenkontext
Das Einbettungsskript sendet automatisch diese Werte von der aktuellen Seite. Wenn ein Besucher zum Beispielhttps://example.com/products/widget?utm_source=newsletter#details öffnet, sendet das Widget:
| Platzhalter | Beispiel | Beschreibung |
|---|---|---|
{{ page_url }} | https://example.com/products/widget | Aktuelle Seiten-URL ohne Query-String oder Hash |
{{ page_origin }} | https://example.com | Origin der Website, inklusive Protokoll und Domain |
{{ page_path }} | /products/widget | Aktueller Pfad auf der Website |
Prompt-Beispiel
Fügen Sie dies unter Playground → Anweisungen (System-Prompt) ein:Benutzerdefinierter Kontext
Sie können auch eigene Kontextwerte als zweiten Parameter anhumanizing.init übergeben.
Regeln und Grenzen
| Regel | Details |
|---|---|
| Platzhalterformat | Verwenden Sie {{ key }} im System-Prompt |
| Schlüsselformat | Beginnt mit einem Buchstaben, danach Buchstaben, Zahlen oder Unterstriche |
| Werte | Strings, Zahlen und Booleans werden unterstützt |
| Maximale Anzahl Schlüssel | Bis zu 50 Kontextschlüssel werden akzeptiert |
| Maximale Wertlänge | Werte sind auf 500 Zeichen begrenzt |
| Fehlende Werte | Wenn ein Schlüssel nicht übergeben wird, bleibt der Platzhalter als {{ key }} sichtbar |
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
Der Platzhalter erscheint in der Antwort
Der Platzhalter erscheint in der Antwort
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.Mein benutzerdefinierter Wert wird ignoriert
Mein benutzerdefinierter Wert wird ignoriert
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.
Der Seitenpfad ist veraltet
Der Seitenpfad ist veraltet
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.