Data Actions: Ihre eigene API als Werkzeug
Einen vorhandenen API-Endpunkt in etwas verwandeln, das der Assistent aufrufen kann.
Data Actions sind für die Fragen Ihrer Kunden gedacht, die kein Dokument beantworten kann: „Wo ist meine Bestellung?“, „Wie viele sind noch im Lager?“, „Ist meine Mitgliedschaft noch aktiv?“. Die Antwort liegt in Ihrem eigenen System, hinter einer API. Eine Data Action ist dieser Endpunkt, einmal beschrieben, damit der Assistent ihn mitten im Gespräch aufrufen und mit der echten Zahl antworten kann.
Tipp: Keine eigene API? Überspringen Sie diese Seite. Der Assistent ist auch ohne sie vollständig – das hier ist für Teams, deren Systeme bereits HTTP sprechen.
Der Unterschied zu API Connections#
Beide geben dem Assistenten Werkzeuge; sie unterscheiden sich darin, wer den Server betreibt. API Connections verbindet einen bereits vorhandenen MCP-Server, der seine eigenen Werkzeuge anbietet. Data Actions sind für den Fall, dass es keinen solchen Server gibt: Sie beschreiben Ihre Endpunkte hier, und Pommy stellt sie dem Assistenten als Werkzeuge bereit. Hat Ihre API ein OpenAPI-Dokument, müssen Sie nichts von Hand beschreiben – importieren Sie es, und die Endpunkte kommen als Gruppe an.
Gruppen und Aktionen#
Aktionen liegen in Gruppen. Eine Gruppe ist ein System – „Bestell-API“, „Lager“ – mit eigener Basisadresse und, falls nötig, eigener Authentifizierung. Darin ist jede Aktion ein einzelner Endpunkt: ein Name, den der Assistent sieht, eine Beschreibung, wann er ihn nutzen soll, Methode und Pfad sowie die Parameter. Schreiben Sie die Beschreibung für den Assistenten, nicht für einen Entwickler: Sie ist das Einzige, was ihm sagt, *wann* diese Aktion die richtige ist.
Eine Aktion hinzufügen#
- Gruppe anlegen
Öffnen Sie im linken Menü Data Actions und legen Sie eine Gruppe für das System an, das Sie verbinden. Geben Sie die Basisadresse an und hinterlegen Sie hier die Zugangsdaten, falls die API welche braucht – sie werden bei der Gruppe gespeichert, nicht bei jeder Aktion erneut.
- Aktionen hinzufügen oder importieren
Fügen Sie Endpunkte einzeln hinzu oder nutzen Sie Import from OpenAPI und lassen Sie Pommy das Dokument einlesen. Importierte Aktionen kommen ausgeschaltet an, damit Sie sie prüfen können, bevor etwas live geht.
- Einschalten, was der Assistent nutzen darf
Jede Aktion hat ihren eigenen Schalter, die Gruppe ebenso. Aktivieren Sie nur, was dieser Assistent wirklich braucht – eine ausgeschaltete Aktion ist für ihn unsichtbar.
Aktionen, die wissen müssen, wer fragt#
Manche Antworten sind persönlich – eine Bestellung gehört einem bestimmten Kunden. Eine Gruppe lässt sich als identitätspflichtig markieren; ihre Aktionen laufen dann nur, wenn das Gespräch einen verifizierten Besucher hat. Genau das verhindert, dass ein Fremder nach der Bestellung eines anderen fragt.
Warnung: Eine Data Action läuft gegen Ihr Live-System – mit den Zugangsdaten, die Sie der Gruppe gegeben haben. Beginnen Sie mit reinen Lese-Endpunkten; fügen Sie schreibende erst hinzu, wenn Sie gesehen haben, dass sich die lesenden richtig verhalten.
Testen#
Stellen Sie nach dem Aktivieren einer Aktion die Frage, die ein Kunde stellen würde – im Widget, mit seinen Worten, nicht mit dem Namen des Endpunkts. Antwortet der Assistent aus Ihrem System, macht die Beschreibung ihren Job. Ignoriert er die Aktion, liegt es meist an der Beschreibung: Sagen Sie klar, welche Frage die Aktion beantwortet und wann sie gebraucht wird.