Überblick

KI-Agenten in SurveyAnalytica sind autonome, bereitstellbare Dienste, die individuelle Logik ausführen, sich mit externen APIs verbinden, Daten verarbeiten und in Workflows integriert werden können. Sie können Agenten mithilfe natürlichsprachlicher Anweisungen von Grund auf erstellen, sie als Live-API-Endpunkte bereitstellen und mit Ihren Kampagnen, Umfragen und Automatisierungsworkflows verbinden. Agenten werden über den Agentenkatalog verwaltet und können mit dem KI-gestützten Agent Builder erstellt werden.

Zu den Agenten navigieren

Klicken Sie in der Hauptnavigationsleiste auf Agenten, um den Agentenkatalog zu öffnen. Der Katalog verfügt über zwei Tabs:

• Meine Agenten: Agenten, die Sie erstellt haben oder auf die Sie in Ihrem Workspace Zugriff haben.
• Vorlagen: Vorgefertigte Agentenvorlagen, die Sie als Ausgangspunkt verwenden können.

Agentenkatalog

Der Agentenkatalog zeigt alle Ihre Agenten mit Status, Beschreibung und Bereitstellungsinformationen an. Sie können:

• Suchen: Agenten nach Name oder Beschreibung filtern.
• Nach Status filtern: Alle Agenten, nur bereitgestellte Agenten oder nur Entwürfe anzeigen.
• Neuen Agenten erstellen: Öffnet den Agent Builder.
• Bearbeiten: Code, Konfiguration oder Einstellungen eines bestehenden Agenten ändern.
• Löschen: Einen Agenten entfernen. Das System prüft vor dem Löschen auf abhängige Workflows und warnt Sie vor aktiven Abhängigkeiten.

Einen Agenten erstellen

Der Agent Builder bietet eine KI-unterstützte Entwicklungsumgebung zum Erstellen von Agenten.

Agentenkonfiguration

Beim Erstellen eines Agenten konfigurieren Sie:

• Name: Ein aussagekräftiger Name für den Agenten.
• Beschreibung: Was der Agent tut, verwendet für Auffindbarkeit und Dokumentation.
• Code: Der Anwendungscode des Agenten. Der KI-Assistent kann diesen aus natürlichsprachlichen Beschreibungen generieren.
• Umgebungsvariablen: Schlüssel-Wert-Paare für Geheimnisse und Konfiguration (API-Schlüssel, Endpunkte usw.). Namen werden automatisch in Großbuchstaben umgewandelt und bereinigt.
• Eingabe-/Ausgabeschema: JSON-Schema-Definitionen für die API-Anfrage- und Antwortformate des Agenten, zur Laufzeit validiert.

KI-gestützte Codegenerierung

Beschreiben Sie in natürlicher Sprache, was Ihr Agent tun soll, und der KI-Assistent generiert den vollständigen Anwendungscode. Der generierte Code umfasst:

• Server-Setup und Routing
• API-Endpunkt-Handler
• Eingabevalidierung
• Externe API-Integrationen
• Fehlerbehandlung

Wissensdatenbank (RAG)

Agenten können mit einer Wissensdatenbank für Retrieval-Augmented Generation (RAG) erweitert werden:

• URL-Scraping: Geben Sie URLs an, und das System extrahiert Textinhalte und segmentiert sie anschließend in optimierte Blöcke für den Abruf.
• PDF-Upload: Laden Sie PDF-Dokumente (bis zu 10 MB) hoch, die für den Wissensabruf geparst und in Blöcke unterteilt werden.
• Textsegmentierung: Inhalte werden automatisch in Segmente unterteilt, die für die Abrufleistung optimiert sind.

Erkennung fehlender Umgebungsvariablen

Das System durchsucht den Agentencode automatisch nach Verweisen auf Umgebungsvariablen und warnt Sie vor Variablen, die im Code referenziert, aber nicht in der Konfiguration definiert sind. Vom System bereitgestellte Variablen sind von dieser Prüfung ausgenommen.

Einen Agenten bereitstellen

Die Bereitstellung erstellt einen live erreichbaren API-Endpunkt für Ihren Agenten:

1. Das System verpackt Ihren Agentencode und Ihre Konfiguration.
2. Ein containerisierter Dienst wird erstellt und in der Cloud bereitgestellt.
3. Umgebungsvariablen werden sicher in die Laufzeitumgebung eingebunden.
4. Der Agent erhält eine eindeutige URL-Endpunkt für API-Aufrufe.

Einen Agenten testen

Vor oder nach der Bereitstellung können Sie Agenten testen, indem Sie API-Aufrufe über die Agentenkatalog-Oberfläche tätigen. Senden Sie Beispielanfragen, die dem Eingabeschema entsprechen, und überprüfen Sie, ob die Antworten dem erwarteten Ausgabeschema entsprechen.

Agentenvorlagen

Die Plattform bietet vorgefertigte Agentenvorlagen für gängige Anwendungsfälle. Vorlagen dienen als Ausgangspunkte, die Sie anpassen können:

• Durchsuchen Sie verfügbare Vorlagen im Tab „Vorlagen“.
• Klicken Sie auf eine Vorlage, um deren Konfiguration und Code zu vorab anzuzeigen.
• Verwenden Sie eine Vorlage als Ausgangspunkt für einen neuen Agenten, wodurch die Vorlagenkonfiguration zur Anpassung in den Agent Builder kopiert wird.

Modellgestützte Agenten

Trainierte ML-Modelle können automatisch als Agenten bereitgestellt werden. Wenn Sie ein Modell als Agenten bereitstellen (über die ML-Modelle-Oberfläche), führt das System Folgendes aus:

1. Überprüft, ob das Modell über eine gültige Live-Version verfügt.
2. Erstellt einen Agenten-Wrapper um das trainierte Modell für Echtzeit-Inferenz.
3. Stellt den Agenten als Live-API-Endpunkt bereit.
4. Verknüpft den Agenten zur einfachen Verwaltung mit dem Modelldatensatz.

Agenten in Workflows

Agenten integrieren sich über die Workflow-Automatisierungs-Engine in SurveyAnalytica-Workflows. Sie können:

• Einen Agenten als Schritt in einem Kampagnen-Workflow hinzufügen
• Agenten basierend auf Umfrageantworten oder Datenereignissen auslösen
• Mehrere Agenten nacheinander verketten
• Agentenausgaben als Eingaben für nachfolgende Workflow-Schritte verwenden

Agenten-Lebenszyklus verwalten

• Aktualisieren: Agentencode ändern und erneut bereitstellen.
• Bereitstellung aufheben: Den Agenten offline nehmen, während die Konfiguration erhalten bleibt.
• Löschen: Den Agenten dauerhaft entfernen. Das System warnt vor dem Löschen vor eventuell abhängigen Workflows.
• Überwachen: Agenten-Aufrufprotokolle und Leistungskennzahlen anzeigen.