- Mit der Execute Code Card in Botpress können Sie benutzerdefiniertes JavaScript in Bot-Workflows ausführen und so dynamische API-Aufrufe, Datenverarbeitung und personalisierte Logik über die standardmäßig integrierten Aktionen hinaus ermöglichen.
- Zu den wichtigsten Anwendungsfällen gehören dynamische API-Anfragen, Nachbearbeitung von LLM , Ratenbegrenzung, Berechtigungsprüfungen und die Verkettung mehrstufiger API-Aufrufe, so dass KI-Agenten komplexe Arbeitsabläufe mit Präzision abwickeln können.
- Zu den bewährten Praktiken gehören die Sicherung von API-Schlüsseln in Umgebungsvariablen, die ordnungsgemäße Behandlung von Fehlern und Timeouts sowie die Erstellung bedingter Logik für robuste, sichere Bot-Vorgänge, die reibungslose, skalierbare API-Integrationen gewährleisten.
KI-Agenten sind nur so leistungsfähig wie die Daten, auf die sie zugreifen können. Große SprachmodelleLLMs) generieren zwar Antworten aus Trainingsdaten, können aber keine Echtzeit-Aktienkurse abrufen, Zahlungen verarbeiten oder auf CRM-Details zugreifen - es sei denn, sie sind mit APIs integriert.
APIs ermöglichen es KI-Agenten, auf Echtzeitdaten zuzugreifen, Logik auszuführen und Aktionen auszulösen. Um sie in vollem Umfang nutzen zu können, benötigen Agenten eigenen Code.
Die Karte "Code ausführen" in Botpress Studio ermöglicht das Schreiben und Ausführen von JavaScript innerhalb des Arbeitsablaufs eines Bots - für nahtlose API-Aufrufe, Datenverarbeitung und die Anpassung des Bot-Verhaltens.
Was ist die "Execute Code Card"?
Die Execute Code Card in Botpress ermöglicht es Entwicklern, benutzerdefiniertes JavaScript im Ablauf des Bots auszuführen. Sie ermöglicht die folgenden Funktionen:
- Implementierung benutzerdefinierter Logik: Sie können komplexe Berechnungen durchführen oder Daten auf eine Art und Weise umwandeln, die von Standardaktionen nicht abgedeckt wird.
- Dynamische Interaktionen: Passen Sie Reaktionen auf der Grundlage von Benutzerdaten oder Echtzeitberechnungen an.
- Datenintegration: Stellen Sie eine nahtlose Verbindung zu Diensten von Drittanbietern her, um Daten abzurufen oder zu senden.
- Statusverwaltung: Greifen Sie auf den Status des Bots zu und ändern Sie ihn, um den Kontext zu erhalten und Interaktionen zu personalisieren.
- Fehlerbehandlung: Implementieren Sie ein benutzerdefiniertes Fehlermanagement, um einen stabilen Betrieb zu gewährleisten.
DieExecute Code Card bietet KI-generierte Code-Vorschläge. Geben Sie eine Eingabeaufforderung ein, z. B. das Abrufen von API-Daten, und das System generiert sofort JavaScript. Sie können es dann überprüfen, bearbeiten und bei Bedarf verfeinern, um die Entwicklung zu beschleunigen.
Warum brauchen KI-Agenten externe APIs?
KI-Agenten sind nur so nützlich wie die Daten und Dienste, auf die sie zugreifen. Sie können zwar Eingaben verarbeiten und Antworten generieren, aber es fehlt ihnen an Echtzeitwissen, Transaktionsfähigkeiten und tiefen Integrationen ohne externe APIs.
Ganz gleich, ob Sie Echtzeitdaten integrieren, Arbeitsabläufe automatisieren oder die Sicherheit verbessern möchten - APIs machen Ihren Bot intelligenter, reaktionsschneller und integrierter.
5 Möglichkeiten zur Verwendung der Execute Code Card
Die Execute Code Card in Botpress Studio vereinfacht die Arbeit von KI-Agenten. Es ist ganz einfach, sie in Ihren Arbeitsablauf einzubinden - folgen Sie diesem kurzen Lernprogramm:
Nachdemsie hinzugefügt wurde, finden Sie hier die wichtigsten Möglichkeiten, sie in Ihrem agenturischen Arbeitsablauf zu nutzen.
1. Dynamische API-Aufrufe
Anstatt statische API-Aufrufe zu verwenden, können Sie mit der Execute Card Anfragen dynamisch auf der Grundlage der Benutzerabsicht, des Bot-Kontexts oder früherer Konversationen ändern.
Beispiel: Abruf von benutzerdefinierten Daten auf der Grundlage von Benutzerpräferenzen.
Aufforderung: Ein Reise-Chatbot muss die Hotelpreise auf der Grundlage des Reiseziels, der Reisedaten und des Budgets des Nutzers ermitteln.
.webp)
Anmerkung: Die Execute Code Card kann Code aus natürlicher Sprache erzeugen. Überprüfen Sie jedoch immer die Variablen die in Ihrem generierten Code verwendet werden, bevor Sie den Workflow in der Produktion einsetzen.
2. Nachbearbeitung von LLM
Botpress bietet zwar integrierte KI-Aktionen, aber manchmal müssen Sie die Antworten noch feiner abstimmen, bevor Sie sie den Nutzern zeigen - sei es, um Ausgaben zu formatieren, bestimmte Wörter zu filtern oder Daten klarer zu strukturieren.
Beispiel: Umschreiben von unstrukturierten LLM in eine definierte Tabelle/ein definiertes Format.
Aufforderung: AI holt Restaurantempfehlungen von einer API, und ich möchte, dass Sie sie in eine saubere Tabelle formatieren, bevor Sie sie anzeigen.
.webp)
3. Ratenbegrenzung und bedingte Ausführung
Einige APIs, einschließlich digitaler Geldbörsen, haben Nutzungsbeschränkungen. Mit der Execute Code Card können Sie Benutzerinteraktionen steuern, indem Sie Tarifgrenzen durchsetzen, Fallbacks festlegen und bedingte Logik basierend auf der API-Verfügbarkeit hinzufügen.
Beispiel: Prüfen der API-Verwendung vor dem Aufrufen
Prompt: Check API quota from https://api.monitoring.com/usage?apikey=${workflow.userApiKey} before making a request. If fewer than 5 requests remain, return an error; otherwise, proceed. Ensure proper error handling in case of failures.
.webp)
4. Umgang mit Berechtigungen
Wenn Ihr Bot Benutzer verifizieren muss, bevor er Zugang zu bestimmten Funktionen gewährt, ermöglicht die Karte benutzerdefinierte Authentifizierungsabläufe, die über die Standardoptionen von Botpresshinausgehen.
Beispiel: Überprüfung des Benutzerabonnementstatus vor der Bereitstellung von AI-Antworten
Prompt: Check a user's subscription via https://billing.example.com/user/{userId}. If on a free plan, prompt an upgrade; otherwise, allow access. Handle errors.
.webp)
5. Mehrstufige API-Verkettung
Manchmal muss ein Bot Daten aus mehreren APIs kombinieren, bevor er eine endgültige Antwort senden kann. Die Karte ermöglicht komplexe mehrstufige Workflows, indem sie Daten dynamisch abruft, umwandelt und weiterleitet.
Beispiel: Abfrage des Wetters und der Restaurantreservierung, um den besten Zeitpunkt für die Abreise zu ermitteln
Aufforderung: Abrufen von Wetter- und Verkehrsdaten für workflow.city mit workflow.userApiKey. Basierend auf den Bedingungen, gib die beste Reisezeit zurück. Behandlung von Fehlern.
.webp)
Nahtlose API-Integration für KI-Agenten
KI-Agenten funktionieren am besten, wenn sie auf Echtzeitdaten zugreifen, Arbeitsabläufe automatisieren und sich mit externen Diensten verbinden können.
Botpress Hub macht dies mit vorgefertigten API-Integrationen, Automatisierungstools und gebrauchsfertigen Konnektoren nahtlos möglich, sodass Sie sich auf die Erstellung und nicht auf die Konfiguration konzentrieren können.
Beginnen Sie noch heute damit, leistungsstarke APIs in die Arbeitsabläufe Ihres Botszu integrieren - es ist kostenlos.
FAQs
1. Brauche ich JavaScript-Kenntnisse, um die Execute Code Card effektiv zu nutzen?
Nicht unbedingt. Es ist hilfreich, die Grundlagen zu kennen, aber die Karte enthält KI-generierte Code-Vorschläge. Du kannst einfach beschreiben, was du willst, und die KI schreibt dir einen Anfangscode, den du anpassen kannst.
2. Gibt es Vorlagen oder Code-Schnipsel für gängige API-Integrationen?
Ja, Botpress bietet Beispiele und von der Community geteilte Snippets für beliebte Anwendungsfälle wie den Aufruf von Wetter-APIs, CRMs oder Zahlungsdiensten.
3. Kann ich die Execute Code Card auch ohne Erfahrung mit API-Integration verwenden?
Auf jeden Fall. Wenn Sie noch keine Erfahrung mit APIs haben, kann die integrierte KI der Karte Sie mit Hinweisen anleiten, und der visuelle Workflow-Builder macht den gesamten Prozess intuitiver.
4. Wie geht die Karte mit lang andauernden API-Anfragen oder Timeouts um?
Es unterstützt asynchrone JavaScript mit await, aber Sie wollen in Timeout-Handling manuell mit Try / Catch und Fallback-Logik, um die Dinge reibungslos zu bauen.
5. Was sind die besten Praktiken für die Umsetzung der Authentifizierung und Autorisierung mit der Karte?
Speichern Sie sensible Schlüssel sicher in Umgebungsvariablen, verwenden Sie Token oder Header für die API-Authentifizierung und fügen Sie bedingte Logik in Ihren Code ein, um Benutzerrollen oder Zugriffsebenen zu überprüfen, bevor Sie fortfahren.