Zum Hauptinhalt springen

Intelligence

Mit dem Schritt Intelligence nutzt du AutoFlow Intelligence direkt in deinen Flows. Er hat zwei Modi:

  • Antwort schreiben – Intelligence beantwortet einen Prompt mit Text. Der Prompt kann Werte aus dem Flow (SmartFields) und Dateien enthalten, zum Beispiel eine gescannte Rechnung.
  • Fragen beantworten – Intelligence beantwortet mehrere Fragen zu einem Text in einem einzigen Aufruf: welche Antwort aus Deiner Liste passt, ja oder nein, oder wie hoch etwas eingestuft wird. Jede Antwort ist ein Wert, mit dem spätere Schritte weiterarbeiten.

Typische Einsätze:

  • Einen eingehenden Beleg klassifizieren (Rechnung, Gutschrift, Mahnung) und mit einem Entscheidung-Schritt weiterleiten.
  • Die Dringlichkeit einer Kunden-E-Mail bewerten und bei Dringendem jemanden benachrichtigen.
  • Einen langen Text zusammenfassen oder mit einem Prompt einen Wert aus einem PDF lesen.
Vorher

Ein AutoFlow-Administrator schaltet Intelligence in der AutoFlow Intelligence Einrichtung ein und legt die Anbieterprofile an (siehe Flows mit AutoFlow Intelligence bauen und ändern). Ein Prompt braucht ein Sprachmodell-Profil (Anthropic, OpenAI, Azure OpenAI). Fragen brauchen ein TypeSafe-Jev-Profil. Ohne passendes Profil lässt sich der Schritt nicht veröffentlichen.

Schritt einrichten​

Füg im Flow-Editor Intelligence hinzu (Kategorie Intelligence) und wähl unter Intelligence soll, was der Schritt tut: Antwort schreiben oder Fragen beantworten (klassifizieren).

Profil​

Meist bleibt es leer: Ein Prompt nimmt das Standard-Sprachmodell-Profil, Fragen nehmen das TypeSafe-Profil. Wähl ein Profil nur, wenn Dein Mandant mehrere hat und dieser Schritt ein bestimmtes braucht. Die Liste bietet nur passende Profile an: Sprachmodell-Profile für Antwort schreiben, TypeSafe-Profile für Fragen beantworten (klassifizieren).

Antwort schreiben​

  • Prompt: was Intelligence tun soll, in deinen eigenen Worten. Füg SmartFields für die Werte des Flows ein, zum Beispiel Fass {{trigger_Description}} in zwei Sätzen zusammen. Intelligence antwortet nur mit dem, worum du bittest – bitte um JSON, wenn ein späterer Schritt Felder aus der Antwort lesen soll, und lies es mit einem Parser-Schritt.
  • Anhänge: Dateien, die Intelligence zusammen mit dem Prompt liest – PNG-, JPEG-, GIF- und WebP-Bilder und PDF-Dateien, zusammen bis 20 MB. Eine Zeile ist entweder eine Referenz auf AutoFlow-Dokumente (zum Beispiel die Ausgabe eines Schritts PDF-Dokument erstellen) oder eine Inline-Datei mit Name und Base64-Inhalt – dieselben Zeilen wie bei E-Mail senden.

Die Antwort ist die Ausgabe answer.

Fragen beantworten​

  • Text, um den es geht: worauf sich die Fragen beziehen, mit SmartFields – zum Beispiel der Text eines Belegs oder einer E-Mail. Wenn Du mehrere Werte kombinierst, schreib kurz dazu, was was ist: Kreditor: {{trigger_Buy-from Vendor Name}}, neue Zeile, Text: {{trigger_Description}}.
  • Fragen: eine Karte pro Frage. Intelligence liest den Text einmal für alle Fragen, deshalb kosten zehn Fragen in einem Schritt kaum mehr als eine – stell alle Fragen zum selben Text in einem Schritt.

Jede Karte hat:

  • Frage – die Frage in Deinen Worten, zum Beispiel Was für ein Beleg ist das?
  • Antwort als – wie Intelligence antwortet:
    • Eine aus einer Liste – Intelligence wählt eine Antwort aus Deinen möglichen Antworten. Schreib unter Wann wählen kurz dazu, wann eine Antwort passt, wenn ihr Wortlaut allein nicht eindeutig ist. „none“ antworten, wenn keine Antwort passt (standardmäßig an) macht die Antwort none, statt die am wenigsten falsche Antwort zu nehmen. Die möglichen Antworten können auch aus einer Liste im Flow kommen – siehe unten.
    • Ja oder nein – Intelligence antwortet true (ja) oder false (nein).
    • Eine Einstufung – Intelligence ordnet den Text auf Deinen Stufen, von niedrig nach hoch ein – zu Beginn niedrig, mittel, hoch.
  • Name in späteren Schritten – füllt sich aus der Frage; Du kannst ihn ändern. Nur Buchstaben, Ziffern und _.
  • In späteren Schritten verwenden – zeigt, welche SmartFields die Frage späteren Schritten gibt und was jeweils drinsteht, aktualisiert beim Tippen.

Das bekommen spätere Schritte (für eine Frage namens category in einem Schritt mit dem Slug Classify):

Antwort alsSmartFieldInhalt
Eine aus einer Liste{{Classify_category}}eine Deiner Antworten oder none
Ja oder nein{{Classify_category}}true für ja, false für nein
Eine Einstufung{{Classify_category}}die Stufe, zum Beispiel hoch
Eine Einstufung{{Classify_category_level}}die Stufe als Zahl: 1 = die erste (niedrigste) Stufe
jede Frage{{Classify_category_confidence}}wie sicher Intelligence ist, von 0 bis 100

Antworten aus einer Liste im Flow​

Manchmal stehen die Antworten nicht fest, sondern hängen vom Datensatz ab – zum Beispiel: Zu welchem Projekt des Debitors gehört diese E-Mail? Such die Projekte zuerst mit einem Schritt Datensätze finden, dann in der Fragenkarte:

  1. Wähl unter Mögliche Antworten die Option Aus einer Liste im Flow.
  2. Liste: Klick auf und wähl die Liste, zum Beispiel {{FindProjects_results}}.
  3. Antwort aus jedem Eintrag: das Feld, das die Antwort ist, zum Beispiel {{FindProjects_results.No}}. Leer gelassen nimmt der Schritt den Primärschlüssel des Datensatzes.
  4. Wann wählen (optional): ein Feld, das Intelligence bei der Entscheidung hilft, zum Beispiel {{FindProjects_results.Description}}.

Die Liste wird bei jedem Lauf gelesen, bis zu 255 Einträge. Die Antwort ist der Wert des Eintrags, zum Beispiel die Projektnummer – lad das Projekt in späteren Schritten mit Datensätze finden wieder. Ist die Liste leer, ist die Antwort none (oder der Schritt schlägt fehl, wenn „none“ antworten, wenn keine Antwort passt aus ist).

Beispiel: eingehende Belege weiterleiten​

  1. Intelligence, Fragen beantworten, Text = der Belegtext.
    • Frage Was für ein Beleg ist das?, Eine aus einer Liste: Rechnung, Gutschrift, Mahnung. Name: belegart.
    • Frage Wie dringend ist es?, Eine Einstufung: niedrig, mittel, hoch. Name: dringend.
  2. Fallunterscheidung auf {{Classify_belegart}} mit je einem Pfad für Rechnung, Gutschrift, Mahnung und none – der none-Pfad benachrichtigt die Buchhaltung.
  3. Eine Entscheidung auf {{Classify_dringend_level}} mindestens 3 schickt eine Warnung.

Gut zu wissen​

  • Mit Protokollstufe Debug zeigt das Ausführungsprotokoll für jede Frage aus einer Liste die Einträge und die daraus gelesenen Antworten sowie die Anfrage an TypeSafe Jev und ihre Antworten. Ergibt kein Eintrag eine Antwort, schlägt der Schritt fehl und nennt das Feld – wähl es mit neu.
  • Jeder Lauf wird unter AutoFlow Intelligence Einrichtung → Sitzungen mit Modell, Tokens und geschätzten Kosten protokolliert. Das Ausführungsprotokoll des Flows nennt die Sitzung.
  • Scheitert der Anbieter oder wird die Antwort abgeschnitten, schlägt der Schritt wie jeder andere mit dem Grund fehl.
  • In Triggern, die laufen, während jemand am Datensatz arbeitet (zum Beispiel beim Freigeben eines Belegs), warnt das Veröffentlichen: Der Benutzer wartet, bis die Antwort da ist.
  • Der Text, der Prompt und die Dateien gehen bei jedem Lauf an den Anbieter des Profils.
  • Fragen lesen noch keine Dateien – Bilder folgen in einem späteren Release. Frag nach einer Datei mit einem Prompt.