Del via

Overfør filer til agentflows, forbindelser og værktøjer

Overfør filer fra din Copilot Studio-agent til downstream-systemer ved hjælp af agentflow, connectors og tools. Denne funktionalitet låser op for effektive automatiseringsscenarier, f.eks. oprettelse af billetter med vedhæftede filer, dokumentbehandling og meget mere.

Aktivér filinput

Udviklere kan give brugerne af deres agent mulighed for at uploade filer under chatinteraktioner med deres agent. Opret et nyt emne for at hente brugerens fil.

Der er tre forskellige muligheder for at anmode om filen.

Interaktion mellem spørgsmålsnoder

Den første mulighed gøres ved at bruge en Spørgsmål-node .

  1. Tilføj en node af typen Spørgsmål i et emne.

  2. Under Identificer skal du vælge Fil.

  3. Åbn panelet Egenskaber for spørgsmål , og vælg kategorien Enhedsgenkendelse .

  4. Vælg Inkluder filmetadata.

Indstil en variabel

Den næste mulighed er at bruge variablen First(System.Activity.Attachments) til at bestemme, om en fil allerede var vedhæftet – f.eks. i en Microsoft Teams samtale. For at bruge denne mulighed i dit emne, brug en Sæt variabel værdi-node til at hente en post med keys.Name.ContentType og .Content sendes til handlinger.

Kombiner indstillingerne

Du kan bruge begge muligheder sammen. Start med at bruge variablen First(System.Activity.Attachments) til at tjekke, om en fil allerede er vedhæftet. Brug derefter en Condition-node til at tilføje en Question-node , der beder brugeren om at uploade en fil.

Denne mulighed lader emnet køre automatisk, hvis brugeren starter samtaleflowet og vedhæfter en fil i samme samtale. For eksempel, hvis brugeren siger, "Send en e-mail med denne fil my.file."

Men hvis brugeren siger, "Send en e-mail med denne fil," men ikke vedhæfter filen, beder agenten brugeren om at levere filen, før samtalen fortsætter.

Overfør en brugerfil til et Power Automate flow

Hvis du vil overføre brugerfilen til et Power Automate flow, skal du tilføje et agentflow i dit emne efter Question node, der anmoder om en fil. Variablen i agentflowet modtager filen fra Copilot Studio.

Du kan også tilføje logik i dit flow for at sende denne fil til SharePoint, ServiceNow, Dynamics 365 Customer Service og lignende tjenester. Hvis du vil overføre variablen, skal du bruge denne Power Fx-formel:

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

Overfør en brugerfil til et Power Automate Flow, der er tilføjet som et værktøj

Hvis du vil overføre en brugerfil til en agent eller et Power Automate flow, der er tilføjet som et værktøj, skal du udføre følgende trin:

  1. Åbn siden Værktøjer .

  2. Vælg dit værktøj.

  3. På værktøjets Detaljer-side skal du gå til Inputs.

  4. For hver flow-inputvariabel skal en ContentBytes- og navneinput vises. Hvis der mangler input, vælg Add input for at tilføje dem.

  5. Sæt contentBytes til følgende formel:

    First(System.Activity.Attachments).Content

  6. Sæt navnet til følgende formel:

    First(System.Activity.Attachments).Name

  7. Når de er konfigureret, skal Inputs vises som følger:

    Skærmbillede af dialogen Inputs, der illustrerer Input-navnet, når det konfigureres med contentBytes og navnefelter.

  8. Du kan derefter vælge Fil som typen af brugerinput i flowet.

    Skærmbillede af et flow, der fremhæver filen som en type brugerinput.

Overfør en brugerfil til en connector

Det samme princip, der overfører en brugerfil til et Power Automate flow, gælder også for overførsel af filer til connectors. For at sende brugerfilen til en connector, tilføj et værktøj fra en connector i dit emne efter Question-noden , der anmoder om en fil. Variablen i connectoren modtager filen fra din agent.

Notat

Nogle stik kræver, at du pakker inputs af typefil. For eksempel har Send en e-mail (V2) -forbindelsen et Vedhæftede input, som er en tabel over poster med contentBytes og name nøgler.

Det vedhæftede objekt fungerer sammen med den samme Power Fx-formel:

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

Overfør en brugerfil til et værktøj

På Tools-siden virker filinput kun, når du sætter dem som en Power Fx-formel ved at bruge Brugerdefineret værdi-muligheden . Det virker ikke ved at bruge funktionen Dynamisk fyld med AI . Brug variablen System.Activity.Attachments til at udfylde værdien ved at bruge en Power Fx-formel, der matcher stikinputtet.

Følgende Power Fx-formel er et eksempel:

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