API-Requests mit Fonio – So funktioniert’s Schritt für Schritt!

‍

1. Assistenten auswählen

Zu Beginn benötigt ihr einen Assistenten, der die API-Requests durchführen soll. In meinem Beispiel habe ich bereits einen Standard-Assistenten eingerichtet. Damit sind wir bereit, ein API-Tool hinzuzufügen.

2. API-Tool hinzufügen

• Geht zu eurem Assistenten und klickt auf „Tool hinzufügen“.
• Wählt die Option „API-Request“ aus.

Nun könnt ihr die API-Einstellungen vornehmen:

a) Name des Tools:

• Vergebt einen aussagekräftigen Namen wie „Terminabfrage“.
• Verwendet dabei keine Leerzeichen, sondern nur Buchstaben, Bindestriche oder Unterstriche.

b) Beschreibung:

• Gebt eine kurze interne Erklärung ein, z. B.: „Die verfügbaren Termine von XY abrufen.“ Die Erklärung dient hier nur eurer Übersicht.

c) URL einfügen:

• Kopiert die benötigte API-URL aus der Dokumentation (in unserem Fall Cal.com) und fügt sie ein.
• Wählt die richtige HTTP-Methode, z. B. GET. Wir wollen in unserem Fall ja alle verfügbaren Slots abfragen.

💡 Wichtig: Bei GET-Methoden werden die Parameter als Query-Parameter übergeben, nicht wie bei POST im Body.

d) Ausführungstext:

• Formuliert, was der Assistent während der API-Anfrage im Gespräch sagen soll, z. B.: „Ich checke jetzt die verfügbaren Termine von XY.“

e) Timeout:

• Die Standardzeit von 5 Sekunden ist in der Regel ausreichend. Ihr müsst hier keine Veränderungen vornehmen.

3. Dynamische Parameter definieren

Hier wird es spannend: Die dynamischen Parameter steuern, welche Werte die KI automatisch ausfüllen soll.

Für unser Beispiel (alle verfügbaren Termine im Kalender abfragen) haben wir euch einen Custom-GPT erstellt, der euch hier den Code schreiben wird.

So geht’s (siehe Video):

1. Kopiert die Beispiel-Query-Parameter aus der API-Dokumentation.
2. Nutzt unseren Custom-GPT-Generator, um die korrekte Parameterstruktur zu erstellen.
3. Entfernt sensible Daten wie API-Schlüssel und die Eventtype ID, die nicht von der KI ausgefüllt werden sollen.
4. Kopiert den angepassten Code und fügt ihn in das Feld „Dynamische Parameter“ ein.

💡 Wichtig: Passt in der Beschreibung oben noch die Zeitzone an, damit die zurückgegebenen Daten korrekt sind und mit der definierten Zeitzone zurückgegeben werden können. Beispiel: „Achtung, die Termine sind in der Zeitzone +0 und müssen angepasst werden.“ (Einfach in der Beschreibung hinzufügen).

4. To Finish Up: Event-ID & API-Schlüssel einfügen

• Geht nun in die Einstellungen eures Kalender-Tools (in unserem Fall Cal.com) und kopiert die Eventtype ID in das Feld „Default / Fixe Parameter“.
• Geht ebenfalls in die Einstellungen in unserer Webapp, erstellt einen neuen API-Schlüssel und fügt ihn ebenfalls als apiKey in das Feld „Default / Fixe Parameter“ ein.
• Jetzt das Ganze einfach noch abspeichern – schon ist es erledigt!

5. Tool testen

Jetzt wird getestet!

Ihr könnt eure Interaktion jetzt einfach rechts oben auf „Audio testen“ selbst ausprobieren und euren KI-Telefonassistenten nach den verfügbaren Terminen fragen.

Nach dem Test könnt ihr auch noch zusätzlich die Logs prüfen:

Im Log-Bereich in unserer Webapp könnt ihr sehen:

• Wann das Tool gestartet wurde.
• Welche Parameter übergeben wurden.
• Was die API zurückgegeben hat.

Das war’s! Mit diesen einfachen Schritten könnt ihr API-Requests in eure Assistenten integrieren. Falls Fragen auftauchen, meldet euch gerne – wir sind hier, um euch zu unterstützen. 😊
Viel Spaß beim Einrichten!

‍