Eingaben für das Agent-Modul

Auf Ihre API-Integrationen kann auch das Agent-Modul zugreifen.

Um API-Integrationen für Ihren Agenten zu aktivieren, müssen Sie zusätzlich zu den in den vorherigen Kapiteln beschriebenen Konfigurationsregisterkarten die Registerkarte Eingaben für Agent ausfüllen.

API-Integrationen für den Agenten definieren

Wesentliche Voraussetzungen:

• 1️⃣ Stellen Sie sicher, dass die Integration eigenständig funktioniert

• Füllen Sie alle erforderlichen Daten aus, um die Integration vollständig zu aktivieren (siehe vorherige Kapitel). Die Integration muss für sich allein funktionieren — ohne den Agenten.

• 2️⃣ Geben Sie eine menschenlesbare Beschreibung an

• Beschreiben Sie im Feld Eingaben für Agent -> Beschreibung die Integration klar und natürlich in „menschlichen Worten“. Wenn die Beschreibung für einen Menschen verständlich ist, sollte sie auch für den Agenten verständlich sein.

• 3️⃣ Definieren Sie die Quelle der erforderlichen Eingabe- $context -Parameter

• 🅰️ Diskussion

  • Beim Aufruf eines API-Endpunkts werden diese $context-Parameter aus der bestehenden Diskussion übernommen (zum Beispiel aus vorherigen Teilen der Konversation oder aus zu Beginn der Sitzung geladenen Daten). Dies sind die $contexts, die Sie bereits unter 4 So finden Sie Diskussionen (Anrufe, Chats, E-Mails) sehen können, und sie sollten vor der Verwendung des Agenten im Dialogfluss existieren.
  • Alternativ können solche Kontexte durch 1️⃣ Integrationen hinzufügen/bearbeiten erstellt werden.
  • Der Agent fragt nicht nach diesen Kontexten, selbst wenn sie für eine Integration erforderlich sind, aber derzeit fehlen. Sie „füttern“ den Agenten mit diesen Kontexten — er wird sie einfach so verwenden, wie sie sind, ohne ihren Inhalt zu lesen oder zu überprüfen.

  • 🅱️ Agent

  • Sie erwarten, dass der Agent selbst die erforderlichen Informationen erhebt, bevor er den API-Endpunkt aufruft.

  • Der Agent prüft das Vorhandensein dieser Kontexte und fordert sie vom Benutzer an, wenn sie für die Fortsetzung des Dialogs erforderlich sind.

  • Wenn die erforderlichen Kontexte bereits in der Diskussion vorhanden sind, kann der Agent sie lesen und verwenden — vergessen Sie aber nicht, im Prompt anzugeben, nach welchen Kontexten der Agent suchen soll.

  • Wenn die erforderlichen Kontexte noch nicht existieren, kann der Agent den Benutzer direkt bitten, sie bereitzustellen.

  • Beispielanwendung: Der Benutzer erwähnt eine Bestellnummer zu Beginn der Konversation, bevor das Agent-Modul verwendet wird. Später, wenn der Agent startet und eine Integration aufrufen muss, um Bestelldetails abzurufen, verhält er sich so:

    • Er verwendet den vorhandenen Kontext $order_number, falls dieser bereits verfügbar ist, oder
    • Er fragt den Benutzer nach der Bestellnummer, falls kein solcher Kontext existiert.

💡

• Der Agent hat standardmäßig keinen Zugriff auf alle Ihre Kontexte. Wenn der Agent einen bestimmten Kontext verwenden soll, müssen Sie ihm dies ausdrücklich mitteilen.
• Der Agent kann die Werte von Kontexten, deren Eingabequelle auf Discussion gesetzt ist, nicht „sehen“ — er verwendet sie nur, ohne die Werte zu lesen.

• Umgekehrt kann der Agent den Wert sehen, wenn Sie ihn einen Kontext erheben und ausfüllen lassen, indem Sie die Eingabequelle Agent auswählen. Diese Kontexte werden als Teil des Prompts vor dem Aufruf der Integration einbezogen und verarbeitet.

• ❗Lassen Sie den Agenten niemals als Quelle für Ihre API-Schlüssel oder Zugriffstokens fungieren, indem Sie deren Quelle auf Agent setzen — stellen Sie diese stattdessen sicher im Vorverarbeitungscode bereit oder generieren Sie sie an anderer Stelle im Dialogfluss getrennt vom Agenten und setzen Sie deren Quelle auf Discussion.

Siehe auch 🤖 Agent-Modul für weitere Informationen zu API-Integrationen für den Agenten.