PowerLeap Logo

Copilot Studio Friction

Bei Änderungen an diesem Eintrag benachrichtigt werden

Eine E-Mail, wenn sich Status oder Lösung ändert — Double-Opt-in, kein Tracking, Abmeldelink in jeder E-Mail.

Dateien werden nicht vom Agent an einen Flow übergeben

Abgemildert(teilweise)seit 8. Juli 2026

Funktioniert erst ab Version 2025.7.2 und nur mit der exakten Power Fx-Syntax für benutzerdefinierte Werte.

Zuletzt verifiziert

Details & Verwandtes

Einschätzung

Vertrauensstufe
Offiziell bestätigtDurch Microsoft-Dokumentation oder eine offizielle Aussage bestätigt.
Schweregrad
Blockierend
Typischer Zeitverlust
Stunden

Identifikation

Agent-FlowsAlle Kanäle

Verifikation & Änderungen

  1. Verifiziert

    Doku-Check durch Mensch: Official file-passing guidance and CAT blog post re-read during seed migration; version gate and Power Fx recipe still documented.

  2. Änderung

    Vorläufig durch den Product Owner freigegeben; externe LLM-Qualitätsprüfung ausstehend.

  3. Änderung

    Erster Eintrag aus dem Seed-Dossier erstellt (Migrationswelle 1).

Verwandt

Automatisch übersetzte Fassung — massgeblich ist das englische Original.

Sind Sie hier richtig?

  • Ein Benutzer lädt eine Datei hoch, und ein Agent-Flow oder Connector soll sie empfangen.
  • Der Tool-Aufruf schlägt fehl, oder die Dateieingabe kommt im Flow leer an.
  • Sie haben die Dateieingabe mit „Dynamically fill with AI" zugeordnet.
  • Oder Ihr Setup wirft einen Fehler, obwohl die Konfiguration korrekt aussieht.

Falls stattdessen ein Flow ein Bild zurücksenden soll → Bildrückgabe aus einem Flow (Eintrag geplant). Falls stattdessen Uploads in Microsoft 365 Copilot Chat nie beim Agent ankommen → siehe Hochgeladene Dateien kommen nie an. Falls stattdessen der Aufruf bei gewöhnlichen Texteingaben mit FlowActionBadRequest fehlschlägt → siehe Flow fails with "FlowActionBadRequest".

Was passiert

Die Übergabe von Dateien von einem Agent an Flows und Connectors funktioniert erst ab Version 2025.7.2, dokumentiert per 2026-07-08. Ältere Versionen werfen bei genau derselben Konfiguration einen Fehler. Selbst auf aktuellen Versionen gelangt die Datei nur über eine einzige exakte Route. Die Dateieingabe akzeptiert nur eine Power Fx-Formel über die Option „Custom value". „Dynamically fill with AI" kann keine Datei zuordnen. Die Formel muss die Datei als Record mit den Schlüsseln contentBytes und name formen. Und für die File-Entität des Fragenknotens muss das Kontrollkästchen „Include file metadata" gesetzt sein. Fehlt ein Teil, kommt die Datei nie an. Es ist wie beim Zollpapier: Das Paket überquert die Grenze nur mit dem exakten Formular, ausgefüllt in den exakten Feldern.

Für Techniker

Einige Connectors verlangen verpackte Dateieingaben, dokumentiert per 2026-07-08. „Send an email (V2)" erwartet eine Tabelle von Records mit den Schlüsseln contentBytes und name. Innerhalb des Flows benötigen Aktionen, die Binärinhalte erwarten, möglicherweise base64ToBinary() um den eingehenden Inhalt. Die Quelle im Thema ist die gespeicherte Variable der File-Entität (mit Metadaten) oder System.Activity.Attachments.

So beheben Sie es

Lösung 1

Offizieller Workaround

Die Datei mit dem dokumentierten Power Fx-Rezept übergeben

  1. Bestätigen Sie, dass Ihr Agent auf Copilot Studio Version 2025.7.2 oder höher läuft.
  2. Öffnen Sie in Ihrem Thema den Fragenknoten, der die Datei mit der Entität „File" erfasst.
  3. Setzen Sie das Kontrollkästchen „Include file metadata" bei dieser Entität.

✅ Sie sollten jetzt sehen: Die gespeicherte Variable trägt Inhalt plus Dateiname, nicht nur den blossen Inhalt.

  1. Öffnen Sie die Dateieingabe des Flow-Tools in Copilot Studio.
  2. Wechseln Sie die Eingabe von „Dynamically fill with AI" zu „Custom value".
  3. Geben Sie die Datei als Power Fx-Record ein, genau wie dokumentiert:
{ contentBytes: Topic.userReceipt.Content, name: Topic.userReceipt.Name }

✅ Sie sollten jetzt sehen: Die Eingabe zeigt Ihre Formel als benutzerdefinierten Wert.

  1. Umschliessen Sie im Flow den eingehenden Inhalt mit base64ToBinary(), wo eine Aktion Binärdaten erwartet.
  2. Speichern Sie den Flow.
  3. Speichern Sie das Thema.

Prüfen, ob es funktioniert hat

Laden Sie im Testbereich (Testen Sie Ihren Agenten) eine kleine Testdatei hoch, wenn der Fragenknoten danach fragt. Erwartet: Der Ausführungsverlauf des Flows zeigt eine erfolgreiche Ausführung, und die Zielaktion hat den echten Dateiinhalt erhalten.

Falls es nicht funktioniert hat

  • Ihre Umgebung ist älter als 2025.7.2. Die identische Konfiguration erzeugt auf älteren Versionen einen Fehler. Prüfen Sie die Version, bevor Sie die Formel anfassen.
  • Die Eingabe ist auf „Dynamically fill with AI" zurückgefallen. Öffnen Sie die Tool-Eingabe erneut und setzen Sie wieder „Custom value".
  • Die Record-Form stimmt nicht. Die Schlüssel müssen contentBytes und name lauten, genau so geschrieben.
  • Die Flow-Aktion erwartet Binärdaten. Fügen Sie base64ToBinary() um den Inhalt innerhalb des Flows hinzu.

So verhindern Sie es künftig

  • Bewahren Sie das dokumentierte Datei-Rezept (Metadaten-Kontrollkästchen, benutzerdefinierter Wert, Record-Form) als gespeichertes Snippet für Ihr Team auf.
  • Legen Sie die vollständige Dateiroute — in den Flow hinein und wieder heraus — fest, bevor Sie das Thema erstellen.
  • Testen Sie nach jedem Plattform-Update den Dateipfad einmal erneut; versionsabhängige Funktionen sind driftanfällig.

Belege

  • Offizielle Dokumentationlearn.microsoft.com

    Die offizielle Anleitung übergibt Dateien als benutzerdefinierten Power Fx-Wert in Form eines Records mit den Schlüsseln contentBytes und name, verpackt dort, wo ein Connector dies verlangt.

  • Microsoft-Aussagemicrosoft.github.io

    Das CAT-Team von Microsoft gibt an, dass die Dateiübergabe an Flows und Connectors ab Version 2025.7.2 funktioniert und innerhalb des Flows base64ToBinary() erfordern kann.