Använd variabler för in- och utdata för att vidarebefordra information

Använd variabler som indata- och utdataparametrar för att skicka information mellan agentflöden och Copilot Studio-agenter.

Viktigt

En agent kan endast ta emot upp till 1 MB data från ett flöde i en enda åtgärd. Det finns dock ingen gräns för hur många variabler eller mängden data som en agent kan skicka.

I det här exemplet skapar du ett flöde med en indataparameter och returnerar det till en agent som en utdataparameter.

Förutsättningar

Parametertyper som stöds

Copilot Studio-agenter stöder följande typer av indata- och utdataparametrar för agentflöden:

  • Siffra
  • String
  • Booleskt

Följande datatyper stöds inte:

  • Object
  • Date
  • Tidsstämpel
  • Lista [Sträng]
  • Lista [värde]
  • Lista [boolesk]
  • Lista [objekt]
  • Lista [datum]
  • Lista [tidsstämpel]

Skapa ett ämne och ett flöde

  1. Gå till sidan Ämnen för din agent.

  2. Skapa ett ny ämne kallat Upprepa meddelande.

  3. Lägg till utlösarfrasen eko.

  4. Lägg till noden Fråga och ange meddelandet "Säg något till mig, så ska jag upprepa det."

  5. För Identifiera väljer du Hela användarens svar.

  6. För Spara användarsvar byter du namn på variabeln till userResponse.

    Skärmbild av en frågenod som samlar in användarens svar.

  7. Välj ikonen Lägg till nod under noden Fråga och välj Lägg till ett verktyg.

  8. På fliken Grundläggande åtgärder väljer du Nytt agentflöde. Fliken agentflödesdesigner öppnas med en startmall för ett agentflöde som anropas av en agent. Flödet innehåller två åtgärder: När en agent anropar flödet och svarar på agenten.

  9. Välj Spara utkast.

  10. På fliken Översikt i flödet redigerar du informationen för flödet och ersätter namnet med Echo-parametern. Välj Spara.

  11. Gå tillbaka till fliken Designer .

Lägg till en indataparameter i flödet

  1. Välj När en agent anropar flödesutlösaren och välj Lägg till indata.

  2. Markera Text och ange namnet String_Input.

    Skärmbild på indataparametern för flödesutlösaren.

Lägg till en utdataparameter i flödet

  1. Välj åtgärden Svara på agentsvaret och välj Lägg till utdata.

  2. Markera Text och ange namnet String_Output.

    Skärmbild på utdataparametern för svarsåtgärden.

  3. För värdet anger du ett snedstreck (/) i rutan, väljer du Infoga dynamiskt innehåll och väljer sedan variabeln String_Input.

  4. Välj Spara utkast och Publicera. Copilot Studio informerar dig när agentflödet publiceras.

  5. Välj Gå tillbaka till agenten för att återgå till agentämnesredigeraren. Det nya åtgärdsflödet läggs till i ämnet.

Anropa flödet från ämnet

  1. Välj den nya åtgärdsnoden.

  2. Ställ in flödesindataparametern till utdatavariabeln från noden Fråga: String_Input (sträng) hämtar sitt värde från variabeln userResponse.

    Skärmbild av noden Åtgärd som anropar flödet

  3. Lägg till en nod av typen Meddelande.

  4. Välj Infoga variabel och välj sedan String_Output.

    Skärmbild av meddelandenoden som upprepar användarindata.

  5. Välj Spara.

  6. Testa din agent.

    Bild på en agentkonversation.