Agenten-Abläufe

Ein Ablauf ist eine im Voraus festgelegte Folge von Schritten, visuell aufgebaut und immer in derselben Reihenfolge ausgeführt. Wo ein Agent entscheidet, was er tut, tut ein Ablauf, was vorgesehen ist.


Wann ein Ablauf einem Agenten vorzuziehen ist

Agent Ablauf
Entscheidet über die Schritte Das Modell Sie
Reproduzierbarkeit Variabel Dieselben Schritte bei jeder Ausführung; der von einem Anweisungsblock erzeugte Text kann variieren
Anpassung an Unvorhergesehenes Gut Keine
Anzahl Modellaufrufe Hoch Auf die Schritte beschränkt, die sie brauchen
Fehlersuche Schwierig Schritt für Schritt

Wählen Sie einen Ablauf, wenn das Verfahren stabil ist und das Ergebnis gleichbleibend sein muss: eine tägliche Extraktion, eine standardisierte Verarbeitung, ein API-Aufruf mit anschliessender Aufbereitung.

Wählen Sie einen Agenten, wenn das Vorgehen davon abhängt, was man unterwegs findet.


Der Editor

Einstellungen → Agent → Agentenfähigkeiten, Abschnitt Agenten-Abläufe, dann «Ablauf erstellen». Administratoren vorbehalten.

Die verfügbaren Blöcke

Start. Deklariert die Eingabevariablen des Ablaufs, also was ihm beim Start übergeben wird. Eine Variable ist obligatorisch, optional oder fest; eine feste Variable bleibt für das Modell unsichtbar.

API-Aufruf. Sendet eine HTTP-Anfrage: URL, Methode, Header, Anfragekörper. Die Antwort wird in einer Variablen abgelegt. Eine Option erlaubt, die Antwort direkt an den Benutzer zurückzugeben, ohne sie über das Modell zu leiten, nützlich, wenn das Ergebnis bereits unverändert verwendbar ist. Dieser Block unterliegt keiner Bestätigung: Die Anfrage geht ohne menschliche Freigabe hinaus, unabhängig von der Methode.

Anweisung an das Modell. Übergibt dem Modell eine Anweisung, angewendet auf die verfügbaren Variablen: zusammenfassen, extrahieren, umformatieren, einordnen. Das Ergebnis wird in einer Variablen abgelegt.

Web-Extraktion. Ruft den Inhalt einer URL ab und legt ihn in einer Variablen ab. Dieselbe Option zur direkten Rückgabe ist verfügbar.

Die Blöcke lassen sich beliebig oft aneinanderreihen. Sobald ein Block fehlschlägt, stoppt der Ablauf und gibt den Fehler zurück.


Ein Beispiel

Ziel: jeden Morgen die neuen Veröffentlichungen einer regulatorischen Quelle erfassen und daraus eine interne Notiz erstellen.

  • Start: Variable quelle_url.
  • Web-Extraktion: Inhalt abrufen von quelle_url → rohinhalt.
  • Anweisung: «Extrahiere nur die Veröffentlichungen mit Datum von gestern oder heute. Falls keine, antworte genau: KEINE.» → neuheiten.
  • Anweisung: «Verfasse eine interne Notiz von höchstens zehn Zeilen auf Grundlage von neuheiten, mit Angabe der Referenzen.» → notiz.
  • API-Aufruf: veröffentlicht die notiz im internen Verteiltool.

Dieser Ablauf läuft, mit einer geplanten Aufgabe verknüpft, jeden Morgen ohne Zutun (im Einzelbenutzermodus, dem einzigen Modus mit geplanten Aufgaben). Er geht dann ab, ohne dass ein Mensch die Notiz gegenliest: Ein Ablauf hat keine Bedingungen, und der API-Aufruf wird ausgeführt, auch wenn die Anweisung KEINE geantwortet hat.


Einen Ablauf nutzen

Ein gespeicherter und aktiver Ablauf wird zu einer Fähigkeit, die die Agenten der ganzen Instanz nutzen können. Er ist ab seiner Erstellung aktiv und wird im Abschnitt Agenten-Abläufe deaktiviert. Ein Ablauf lässt sich also aufrufen:

  • aus einem Gespräch, indem Sie die Aufgabe dem Agenten übergeben, der entscheidet, ihn zu starten, und ihm die Variablen liefert;
  • aus einer geplanten Aufgabe.

Ein Ablauf kann keinen anderen aufrufen.


Bewährte Vorgehensweisen

Testen Sie Block für Block. Der Editor hat keine Ausführen-Schaltfläche: Fügen Sie einen Schritt hinzu, speichern Sie, starten Sie den Ablauf aus einem Gespräch mit @agent und prüfen Sie seine Ausgabe im Ablaufprotokoll, statt das Ganze vor dem ersten Versuch zu schreiben.

Benennen Sie Ihre Variablen aussagekräftig. liste_offene_rechnungen ist besser als ergebnis2 – die Lesbarkeit des Ablaufs hängt davon ab, und Sie werden in sechs Monaten darauf zurückkommen.

Sehen Sie den leeren Fall vor. Was soll geschehen, wenn die API nichts zurückgibt, die Seite nicht erreichbar ist oder es keine Neuigkeiten gibt? Eine ausdrückliche Anweisung für diesen Fall verhindert unsinnige Ausgaben.

Geben Sie das Format der Modellausgaben vor. «Antworte nur mit einer Aufzählung, ohne Einleitung» ergibt ein Ergebnis, das der nächste Schritt verwenden kann; eine vage Anweisung ergibt einen Text, der nachbearbeitet werden muss.

Vorsicht mit Geheimnissen. Ein API-Aufruf kann einen Schlüssel erfordern. Er ist für Administratoren in der Definition des Ablaufs sichtbar, und der Anfragekörper wird im Ablauf des Gesprächs angezeigt: Verwenden Sie einen eigenen Schlüssel mit eingeschränkten Rechten. Behandeln Sie diese Abläufe mit derselben Vorsicht wie ein Produktivskript.