Dateien an Agentenflüsse, Konnektoren und Werkzeuge übergeben

Übergeben Sie Dateien von Ihrem Copilot Studio-Agent mithilfe von Agent-Flows, Konnektoren und Tools. Diese Funktionalität schaltet leistungsstarke Automatisierungsszenarien wie die Erstellung von Tickets mit Anhängen, Dokumentenverarbeitung und mehr frei.

Dateieingabe aktivieren

Maker können es Nutzern ihres Agenten erlauben, während der Chat-Interaktionen mit ihrem Agenten Dateien hochzuladen. Erstelle ein neues Thema, um die Datei des Benutzers abzurufen.

Es gibt drei verschiedene Möglichkeiten, die Akte anzufordern.

Frageknoten-Interaktion

Die erste Option erfolgt über einen Frage-Knoten .

1. Füge einen Frage-Knoten in einem Thema hinzu.

2. Unter Identifizieren wählen Sie Datei.

3. Öffnen Sie das Panel "Frageeigenschaften " und wählen Sie die Kategorie Entitätenerkennung aus.

4. Wählen Sie Dateimetadaten einbeziehen.

Variable setzen

Die nächste Option besteht darin, die Variable First(System.Activity.Attachments) zu verwenden, um festzustellen, ob eine Datei bereits angefügt wurde , z. B. in einer Microsoft Teams Unterhaltung. Um diese Option in Ihrem Thema zu verwenden, verwenden Sie einen Set-Variablen-Wert-Knoten , um einen Datensatz mit keys.Name.ContentType und .Content abzurufen, der an Aktionen weitergegeben wird.

Kombinieren Sie die Optionen

Du kannst beide Optionen zusammen verwenden. Beginnen Sie damit, die Variable First(System.Activity.Attachments) zu verwenden, um zu prüfen, ob eine Datei bereits angehängt ist. Dann verwende einen Condition-Node , um einen Question-Knoten hinzuzufügen, der den Nutzer bittet, eine Datei hochzuladen.

Diese Option lässt das Thema automatisch laufen, wenn der Nutzer den Gesprächsfluss startet und eine Datei im selben Gespräch anhängt. Zum Beispiel, wenn der Nutzer sagt: "Sende eine E-Mail mit dieser Datei my.file."

Wenn der Nutzer jedoch sagt: "Sende eine E-Mail mit dieser Datei", aber die Datei nicht anhängt, bittet der Agent den Nutzer, die Datei bereitzustellen, bevor der Gesprächsfluss fortgesetzt wird.

Übergeben einer Benutzerdatei an einen Power Automate Flow

Um die Benutzerdatei an einen Power Automate Fluss zu übergeben, fügen Sie einen agent-Fluss in Ihrem Thema nach dem Questionknoten hinzu, der eine Datei anfordert. Die Variable im Agentfluss empfängt die Datei von Copilot Studio.

Optional können Sie Ihrem Fluss Logik hinzufügen, um diese Datei an SharePoint, ServiceNow, Dynamics 365 Customer Service und ähnliche Dienste zu senden. Um die Variable weiterzugeben, verwenden Sie diese Power-Fx-Formel:

{ contentBytes: Topic.userReceipt.Content, name: Topic.userReceipt.Name }

Benutzerdatei an einen Power Automate Flow übergeben, der als Tool hinzugefügt wurde.

Führen Sie die folgenden Schritte aus, um eine Benutzerdatei an einen als Tool hinzugefügten Agenten oder Power Automate-Flow zu übergeben:

1. Öffnen Sie die Tools-Seite .

2. Wählen Sie Ihr Werkzeug aus.

3. Auf der Details-Seite des Tools gehe zu Eingaben.

4. Für jede Flow-Eingabevariable sollten ContentBytes und name-Eingaben angezeigt werden. Wenn Eingaben fehlen, wähle Hinzufügen Eingabe, um sie hinzuzufügen.

5. Setze contentBytes auf folgende Formel:

   First(System.Activity.Attachments).Content
   

6. Setze den Namen auf folgende Formel:

   First(System.Activity.Attachments).Name
   

7. Nach der Konfiguration sollten die Eingänge wie folgt angezeigt werden:

   

8. Du kannst dann File als Typ der Benutzereingabe im Flow auswählen.

   

Übergebe eine Benutzerdatei an einen Connector

Dasselbe Prinzip, das eine Benutzerdatei an einen Power Automate Fluss übergibt, gilt auch für das Übergeben von Dateien an Connectors. Um die Benutzerdatei an einen Connector zu übergeben, füge ein Tool von einem Connector in deinem Thema nach dem Frage-Knoten hinzu, der eine Datei anfordert. Die Variable im Connector erhält die Datei von deinem Agenten.

Das Attachment-Objekt funktioniert mit derselben Power Fx-Formel:

{ contentBytes: Topic.userReceipt.Content, name: Topic.userReceipt.Name }

Übergeben Sie eine Benutzerdatei an ein Tool

Auf der Tools-Seite funktionieren Dateieingaben nur, wenn du sie als Power Fx-Formel mit der Option Benutzerdefinierten Wert einstellst. Es funktioniert nicht, wenn man die Option "Dynamisch mit KI füllen " verwendet. Verwenden Sie die Variable, System.Activity.Attachments um den Wert mit einer Power Fx-Formel zu füllen, die dem Steckereingang entspricht.

Die folgende Power-Fx-Formel ist ein Beispiel:

If(
    IsEmpty(System.Activity.Attachments), 
    [], 
    [{ contentBytes: First(System.Activity.Attachments).Content, name: First(System.Activity.Attachments).Name }])

Verwandte Informationen

• Dateieingabe von Benutzern erlauben