Passare i file ai flussi, ai connettori e agli strumenti dell'agente

Passare i file dall'agente di Copilot Studio ai sistemi downstream usando flussi agent, connectors e tools. Questa funzionalità consente di sbloccare scenari di automazione avanzati, ad esempio la creazione di ticket con allegati, l'elaborazione di documenti e altro ancora.

Attiva l'input dei file

Gli autori possono consentire agli utenti del proprio agente di caricare i file durante le interazioni di chat con il proprio agente. Creare un nuovo argomento per recuperare il file dell'utente.

Sono disponibili tre opzioni diverse per richiedere il file.

Interazione del nodo della domanda

La prima opzione si ottiene utilizzando un nodo Domanda .

1. Aggiungere un nodo Domanda in un argomento.

2. In Identifica selezionare File.

3. Aprire il pannello Proprietà domanda e selezionare la categoria Riconoscimento entità .

4. Seleziona Include metadati del file.

Impostare una variabile

L'opzione successiva consiste nell'usare la variabile First(System.Activity.Attachments) per determinare se un file è già stato allegato, ad esempio in una conversazione Microsoft Teams. Per utilizzare questa opzione nel tuo argomento, usa un nodo Set variable value per recuperare un record con keys.Name.ContentType e .Content da passare alle azioni.

Combinare le opzioni

Puoi usare entrambe le opzioni insieme. Inizia usando la First(System.Activity.Attachments) variabile per verificare se un file è già allegato. Poi, usa un nodo Condition per aggiungere un nodo Question che chiede all'utente di caricare un file.

Questa opzione permette all'argomento di essere eseguito automaticamente se l'utente avvia il flusso della conversazione e allega un file nella stessa conversazione. Ad esempio, se l'utente dice: "Invia un'email con questo file my.file."

Tuttavia, se l'utente dice "Invia un'email con questo file" ma non allega il file, l'agente chiede all'utente di fornire il file prima di proseguire il flusso della conversazione.

Trasferire un file utente a un flusso di Power Automate

Per passare il file utente a un flusso di Power Automate, aggiungere un flusso agent nell'argomento dopo il nodo Question che richiede un file. La variabile nel flusso dell'agente riceve il file da Copilot Studio.

Facoltativamente, è possibile aggiungere logica nel flusso per inviare questo file a SharePoint, ServiceNow, Dynamics 365 Customer Service e servizi simili. Per passare la variabile, usare questa formula di Power Fx:

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

Passare un file dell'utente a un flusso di Power Automate aggiunto come strumento

Per passare un file dell'utente a un agente o a un flusso di Power Automate aggiunto come strumento, seguire questa procedura:

1. Apri la pagina Strumenti .

2. Seleziona il tuo strumento.

3. Nella pagina Dettagli dello strumento, vai su Input.

4. Per ogni variabile di input di flusso, dovrebbero essere visualizzati un ContentBytes e un input di nome. Se mancano degli input, seleziona Aggiungi input per aggiungerli.

5. Imposta contentBytes alla seguente formula:

   First(System.Activity.Attachments).Content
   

6. Imposta nome con la seguente formula:

   First(System.Activity.Attachments).Name
   

7. Una volta configurati, gli ingressi dovrebbero essere visualizzati come la seguente configurazione:

   

8. Puoi quindi selezionare File come tipo di input utente nel flow.

   

Passare un file utente a un connettore

Lo stesso principio che passa un file utente a un flusso di Power Automate si applica anche al passaggio di file ai connettori. Per passare il file utente a un connettore, aggiungi uno strumento da un connettore nel tuo argomento dopo il nodo Domanda che richiede un file. La variabile nel connettore riceve il file dal tuo agente.

L'oggetto allegato funziona con la stessa formula di Power Fx:

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

Passare un file utente a uno strumento

Nella pagina degli strumenti , gli input dei file funzionano solo quando li imposti come formula Power Fx usando l'opzione Valore Personalizzato . Non funziona usando l'opzione Riempire dinamicamente con l'IA . Usa la System.Activity.Attachments variabile per riempire il valore usando una formula Power Fx che corrisponde all'ingresso del connettore.

La seguente formula Power Fx è un esempio:

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

Informazioni pertinenti

• Consenti input di file dagli utenti