Kurz gesagt
- Echte Antworten aus Ihren Systemen.Der Agent liest Live-Daten aus Ihrer API, etwa einen Bestellstatus, statt anhand einer Hilfeseite zu raten.
- Signiert und wiederholbar.Jeder Aufruf ist signiert, sodass Ihr Server belegen kann, dass er von OneType stammt, und trägt einen stabilen Idempotenzschlüssel.
- Besucher geben Änderungen frei.Tools, die etwas ändern, fragen zuerst den Besucher im Chat, und destruktive fragen immer.
- Keine erfundenen Bestellnummern.Eine Bestellnummer oder eine andere ID muss vom Besucher, von der Seite oder aus einem früheren Ergebnis stammen, nie aus der Fantasie des Modells.
Die meisten Chatbots hören beim Antworten auf. Ein Besucher fragt, wo seine Bestellung ist, und der Bot schickt ihn auf eine Sendungsverfolgungsseite. Mit API-Aktionen ruft Ihr Agent Ihr eigenes System auf, liest den echten Status und teilt ihn in derselben Unterhaltung mit. Es fühlt sich an, als spräche man mit jemandem aus Ihrem Team, der den richtigen Bildschirm geöffnet hat.
So funktioniert es
Eine API ist die Adresse, unter der Ihre eigene Software antwortet. Mit API-Aktionen (in Kürze verfügbar) fügen Sie ein Tool hinzu: Sie geben ihm einen Namen, beschreiben in einfachen Worten, wann der Agent es nutzen soll, und tragen die Methode und die https-Adresse Ihres Endpunkts ein. Die nötigen Eingaben, etwa eine Bestellnummer, beschreiben Sie als kleines JSON Schema. Stellt ein Besucher eine passende Frage, füllt der Agent diese Eingaben aus, OneType ruft Ihren Endpunkt auf, und der Agent antwortet anhand dessen, was Ihre API zurückgeschickt hat.
- Wählen Sie die Methode: GET, POST, PUT, PATCH oder DELETE.
- Eingaben gehören mit {parameter} in den Pfad, der Rest in die Query oder den JSON-Body.
- Fügen Sie Header hinzu und markieren Sie Zugangsdaten als geheim, damit sie verschlüsselt gespeichert und nie wieder angezeigt werden.
- Geben Sie an, was das Tool mit Ihren Daten tut: lesen, etwas ändern oder destruktiv.
Der Agent verkettet Schritte selbstständig
Eine Antwort kann mehrere Tools nutzen. Der Agent kann eine Bestellung nachschlagen, dann die Rückgabefrist prüfen und anbieten, den Chat an einen Menschen zu übergeben, alles in einer Antwort. Er kann bis zu 20 Tool-Aufrufe in einer einzigen Antwort ausführen, und ein Agent kann bis zu 100 Tools haben.
Gebaut, damit Ihre API ihm vertrauen kann
Jeder Aufruf wird mit einem Signaturschlüssel pro Agent signiert, nach dem offenen Standard-Webhooks-Verfahren, sodass Ihr Server prüfen kann, dass er wirklich von OneType kommt. Jeder Aufruf trägt außerdem einen Idempotenzschlüssel, der bei einer Wiederholung gleich bleibt, damit Ihre API Duplikate ignorieren kann. OneType ruft nur öffentliche Internetadressen auf und folgt nie Weiterleitungen.
Für personenbezogene Daten aktivieren Sie „Only for signed-in visitors“. Der Aufruf enthält dann den verifizierten Kontakt aus Ihrem eigenen signierten Identitäts-Token, sodass das Modell nie wählen kann, um wessen Konto es bei einer Abfrage geht. Anonyme Besucher werden abgewiesen.
Änderungen brauchen den Klick des Besuchers
Ein Tool, das nur liest, läuft sofort. Ein Tool, das etwas ändert, zeigt dem Besucher eine von Ihnen formulierte Frage, etwa Cancel order #1234?, und läuft erst, nachdem er per Klick zugestimmt hat. Destruktive Tools fragen immer. IDs wie Bestellnummern oder SKUs müssen aus dem stammen, was der Besucher getippt hat, was die Seite zeigt oder aus einem früheren Tool-Ergebnis. Erfindet das Modell eine, wird der Aufruf nicht ausgeführt, und der Agent wird angewiesen, sie nachzuschlagen oder nachzufragen.
So funktioniert die Freigabe durch Besucher
Grenzen, die Sie kennen sollten
Ihr Endpunkt muss innerhalb von 10 Sekunden mit JSON antworten, und der Agent liest davon bis zu 32 KB. Jedes Tool hat sein eigenes Limit für Aufrufe pro Minute, von 1 bis 60, standardmäßig 10. Schlägt ein Aufruf fehl, wird der Agent informiert und macht weiter, zum Beispiel indem er einen Menschen anbietet.