Kurz gesagt
- Nutzt Ihren eigenen Seitencode.Der Agent ruft die Tools auf, die Sie in Ihrem Dashboard deklarieren und auf der Seite registrieren, mit der eigenen Sitzung und dem eigenen Warenkorb des Besuchers.
- Fragt, bevor er etwas ändert.Aktionen, die etwas ändern, zeigen eine Bestätigungskarte, und nur der Klick des Besuchers genehmigt sie.
- Erst suchen, dann handeln.Der Agent kann Schritte verketten, etwa ein Produkt finden und es dann in den Warenkorb legen, in einer Antwort.
- Nur auf den richtigen Seiten.Beschränken Sie jede Aktion auf Pfade wie /shop/*, damit sie nur dort angeboten wird, wo sie sinnvoll ist.
Besucher wissen oft genau, was sie wollen, aber nicht, wo sie klicken müssen. Mit Site-Aktionen sagen sie es einfach. Legen Sie zwei Beutel des Kenia-Kaffees in den Warenkorb, zeigen Sie mir nur vegane Optionen, buchen Sie mir am Dienstag eine Demo. Der Agent erledigt es auf Ihrer Seite, und der Besucher sieht das Ergebnis sofort.
So funktioniert es
Ihr Entwickler registriert ein Tool mit einem Aufruf auf der Seite, onetype addTool, und Sie deklarieren dasselbe Tool in Ihrem Dashboard unter Developer › Tools. Ein Tool hat einen Namen, eine Beschreibung in einfachen Worten, wann es zu verwenden ist, die Eingaben, die es annimmt, als kleines JSON Schema, und einen Handler: Ihr eigenes JavaScript, das die Arbeit erledigt, etwa Ihren Warenkorb aufzurufen. Fragt ein Besucher etwas Passendes, füllt der Agent die Eingaben aus, OneType prüft sie gegen Ihr Schema, und Ihr Handler läuft im Browser des Besuchers.
- Geben Sie an, was die Aktion tut: lesen, schreiben oder destruktiv.
- Formulieren Sie die Bestätigungsfrage, mit {param}-Platzhaltern, die aus den Eingaben gefüllt werden.
- Beschränken Sie sie auf bestimmte Seiten, bis zu 50 Pfade.
- Legen Sie ein Timeout von 1 bis 120 Sekunden fest, standardmäßig 15.
- Aktualisieren oder entfernen Sie ein Tool jederzeit mit updateTool und removeTool.
Zeigen Sie dem Agenten, was auf dem Bildschirm ist
Der Agent kann nur eine Produkt-ID verwenden, die er tatsächlich gesehen hat. Übergeben Sie die Produkte der aktuellen Seite mit setContext, fügen Sie für große Kataloge ein Such-Tool hinzu, oder lassen Sie Ihr Tool Produktnamen akzeptieren und die ID in Ihrem eigenen Code nachschlagen. Eine vom Modell erfundene ID zählt nicht: Der Aufruf läuft nicht, und der Agent wird angewiesen, zuerst zu suchen oder den Besucher zu fragen.
Der Besucher behält die Kontrolle
Alles, was die Seite oder den Warenkorb ändert, fragt zuerst nach, es sei denn, Sie legen ausdrücklich etwas anderes fest. Destruktive Aktionen, etwa das Entfernen eines Artikels, fragen immer nach. Die Zustimmung ist ein Klick im Chat, den weder das Modell noch Text auf einer Webseite fälschen kann. Lehnt der Besucher ab, läuft Ihr Handler nie.
Schrittketten
Der Agent kann Tools in einer Antwort kombinieren. Er kann Ihren Katalog durchsuchen und dann den passenden Artikel in den Warenkorb legen, oder mit einer API-Aktion eine Bestellung auf Ihrem Server nachschlagen und dann die Bestellseite im Browser öffnen. Er kann in einer einzigen Antwort bis zu 20 Tool-Aufrufe machen.
Argumente werden gegen Ihr Schema geprüft, bevor Ihr Handler läuft, sodass ein ungültiger Aufruf nie Ihren Code erreicht und der Agent erfährt, was falsch war. Ihr Handler kann jedes JSON-Ergebnis zurückgeben, und der Agent nutzt es in seiner Antwort. Geben Sie Beträge mit ihrem Währungscode an, damit der Agent nie raten muss.