Power Automate

Ein Agent Flow wird vom Copilot Studio Agent aufgerufen, um eine Aufgabe auszuführen und strukturierte Output Werte an den Agent zurückzugeben.

Dem Agent antworten gibt Output Parameter als Rückgabewerte zurück, eine Chat Nachricht wird im Agent Topic formuliert und angezeigt.

Agent Flow Outputs unterstützen bestimmte einfache Typen und große Strukturen werden oft als JSON String zurückgegeben, außerdem gilt ein Größenlimit pro Flow Aufruf.

Ein Agent kann pro Flow Action bis zu 1 MB Daten als Rückgabe erhalten.

Compose speichert einen Zwischenwert und ist ideal zum Debuggen, zum Beispiel um Ausdrücke aufzuteilen und Outputs in der Run History zu prüfen.

Klare und konsistente Namen verbessern Wartbarkeit, Debugging und Zusammenarbeit, weil man Zweck und Reihenfolge schneller erkennt.

Naming Conventions sind Regeln für Flow Namen, Action Namen, Trigger Namen, Variablen Namen und Connection Reference Namen.

Sie decken Naming, Variablen, Compose, Environment Variables, Comments, Connection References, Error Handling und Performance ab.

Eine Array Variable speichert eine Liste von Elementen, zum Beispiel eine Liste von Datei Objekten mit Name und Link.

Weil die SharePoint REST Antwort eine Liste liefert und du jedes Element iterieren musst, um daraus dein eigenes Ausgabeformat zu bauen.

item ist das aktuelle Element der Schleife, also eine einzelne Datei aus der Liste.

Weil die HTTP Antwort kein Array an der erwarteten Stelle geliefert hat, häufig wenn nicht die Files Collection abgefragt wurde.

Nur mit Files wird die Files Collection eines Ordners zurückgegeben, ohne Files erhältst du nur Metadaten des Ordners.

Er greift auf einen Ordner über seinen serverrelativen Pfad zu, und mit Files dahinter kannst du dessen Dateien abrufen.

Ein Pfad der mit einem Slash beginnt und relativ zur SharePoint Domain ist, zum Beispiel sites und Bibliothek und Ordner.

Weil Leerzeichen in URIs kodiert werden müssen, sonst kann der REST Request fehlschlagen.

Apostrophe können den REST Ausdruck ungültig machen und ein Workaround ist die doppelte Prozent 27 Kodierung.

replace ersetzt alle Vorkommen eines Teilstrings in einem Text durch einen anderen Teilstring.

split teilt einen Text an einem Trennzeichen in ein Array von Segmenten auf.

join setzt ein Array von Segmenten mit einem Trennzeichen wieder zu einem Text zusammen.

first gibt das erste Element eines Arrays zurück, last gibt das letzte Element zurück.

concat setzt mehrere Textteile zu einem String zusammen, zum Beispiel um eine REST URI zu bauen.

uriComponentToString decodiert URL kodierte Zeichenfolgen, zum Beispiel Prozent 2F zurück zu Slash.

decodeUriComponent decodiert eine URL kodierte Komponente, zum Beispiel Prozent 27 zu einem Apostroph Zeichen.

Manche Links sind HTML escaped und enthalten amp, daher normalisiert man häufig amp zu einem echten Und Zeichen per replace.

dataset ist die Basis Site Adresse, uri ist der REST Pfad relativ zur Site.

Bei Agent Flows ist es eine Skills Response, die Output Parameter an den Agent zurückgibt, nicht primär eine UI Anzeige.

Unterstützt sind einfache Typen wie Number, String und Boolean, komplexere Typen werden oft als String serialisiert.

Das kann beim Speichern zu InvalidOpenApiFlow führen, weil Response Actions nicht unter foreach verschachtelt werden dürfen.

Er bedeutet dass der Flow beim Speichern oder Validieren eine ungültige Struktur oder ungültige Inputs für eine Action enthält.

In manchen Fällen führt HTTP in Condition zu InvalidOpenApiFlow beim Speichern und ein Workaround ist die HTTP Action in einen Scope zu legen.

Ein Scope gruppiert mehrere Actions logisch, erleichtert Strukturierung und unterstützt Muster wie Try Catch Finally.

Ein Muster für Error Handling, bei dem man den Hauptteil in Try ausführt, Fehlerbehandlung in Catch macht und Aufräumen oder Response in Finally.

Empfohlen werden Scope Gruppierung, Try Catch Finally, sauberes Beenden, Benach