Rediger og administrer agentflyten eller arbeidsflyten i utformeren

Agentprosesser og arbeidsflyter opprettes og redigeres begge i visuelle designverktøy i Copilot Studio. De nye arbeidsflytene, som nå er i offentlig forhåndsversjon, bruker en ny utforming av visualobjekter, mens agentflyter bruker den opprinnelige visualobjektutformingen. Begge de visuelle designerne tilbyr et lerret der du kan fortsette å bygge eller redigere et automatiseringsprosjekt. Legg til og fjern handlinger, se etter feil og publiser flyten, alt uten å forlate utformingen. Du kan også justere hvordan agentflyten eller arbeidsflyten vises, slik at du kan fokusere på bestemte områder.

Important

Denne artikkelen inneholder dokumentasjon for Microsoft Copilot Studio-forhåndsversjonen og kan bli endret.

Evalueringsfunksjonalitet er ikke ment for produksjonsbruk og kan ha begrensninger. Disse funksjonene er tilgjengelige før en offisielle utgivelsen slik at du kan få tidlig tilgang og gi tilbakemeldinger.

Hvis du skal bygge en produksjonsklar agent, kan du se Oversikt over Microsoft Copilot Studio.

Hvis du vil vise en agentflyt eller arbeidsflyt i utformeren, åpner du Copilot Studio, velger Flyter, velger flyten og velger deretter fanen Bygg.

Skjermbilde av Copilot Studio utformeren som viser en publisert arbeidsflyt med en utløser og flere actions.

Endre hvordan flyten vises på skjermen

Avhengig av størrelsen og kompleksiteten til agentflyten eller arbeidsflyten, kan det være lurt å justere hvordan flyten vises for å gjøre det enklere å arbeide med. Verktøylinjen nederst til venstre i lerret styrer visningen.

Skjermbilde av verktøylinjen for visningsalternativer i Copilot Studio Designer, med bildeforklaringer nummerert fra 1 til 6,

Forklaring:

  1. Zoom inn: Øk størrelsen på arbeidsflyten på lerretet.
  2. Zoom ut: Reduser størrelsen på arbeidsflyten på lerretet.
  3. Tilpass visning: Endre størrelsen på visningen slik at den passer til hele arbeidsflyten på lerretet.
  4. Rydd opp: Omorganiser arbeidsflyten og grenene for en klarere ende-til-ende-visning.
  5. Loddrett oppsett: Bytt til en loddrett oppsettvisning av arbeidsflyten.

Legg til og fjern handlinger

  1. Velg Legg til et trinn på kortet du vil legge til handlingen etter. Legg til-ruten åpnes.

  2. Begynn å skrive inn handlingen du vil at flyten skal utføre, eller kobling du vil legge til, under Legg til, og velg den fra listen. Avhengig av hva du velger, må du kanskje oppgi tilleggsinformasjon for å fullføre handlingen.

Hvis du finner ut at en handling ikke er nødvendig, velger du Slett-ikonet øverst til høyre i handlingen.

Sjekk flytparametere

Hvis du vil vise parameterne for en utløser eller handling i arbeidsflyten, velger du kortet. Konfigurasjonspanelet åpnes på høyre side. Hvis du vil angi en verdi for en parameter, velger du et alternativ i rullegardinlisten eller skriver inn et uttrykk for å angi verdien dynamisk.

Vis versjonslogg for agentflyter

En versjonslogg registreres i Microsoft Dataverse når du bygger eller endrer en agentflyt. Hvis du vil forstå hvordan en agentflyt utviklet seg, kan du se gjennom versjonsloggen. Flytversjoner grupperes etter dato, med indikatorer for nyeste versjon, publisert og tidligere publisert.

Historikken for en flyt er basert på lagrede versjoner, så det er lurt å lagre utkast før flyten er fullført.

Hvis du vil bruke versjonsloggpanelet, må du lagre agentflyten minst én gang.

  1. Velg Versjonslogg på menyen øverst på lerretet.

  2. Hvis du vil vise de innspilte versjonene av flyten, utvider du et element i listen.

  3. Hvis du vil vise versjonen i utformingsverktøyet, velger du den i listen.

Se etter feil

Feil i arbeidsflythandlinger angis i rødt. Hvis du vil vise detaljer om en feil i én handling, velger du feilen. Hvis du vil vise alle feilene i hele flyten, åpner du tilstandssenterbanneret . Velg feilen for å vise detaljer for individuelle feil.

Important

Du kan ikke publisere en flyt hvis den inneholder feil. Du må rette opp alle feil før du kan publisere flyten.

Publiser arbeidsflyten

Hvis arbeidsflyten ikke har noen feil, kan du publisere den. Hvis du vil publisere flyten, velger du Publiser på menyen øverst på lerretet.

Test agentflyten eller arbeidsflyten

Testkjøringer lar deg bekrefte et trinn eller en hel flyt uten å forlate utformeren, ved hjelp av enten ekte oppstrømsdata, verdier du gjør narr av selv, eller utdata fra en tidligere kjøring.

Det finnes to måter å kjøre en test på:

Det du vil bekrefte Slik tester du Hvor du finner dette
Et enkelt handlings- eller AI-trinn isolert Test denne noden Test-fanen i sidepanelet til noden
Hele flyten, ende-til-ende Kjør flyttest Avspilling-knappen på den øverste kommandolinjen

Begge overflatene deler samme idé: Gi innganger (ekte eller spotte), kjør, og undersøk deretter utdataene.

Teste én enkelt node i en arbeidsflyt

Åpne en handling eller node i arbeidsflyten, og velg avspillings- eller testknappen. Det finnes tre inndelinger:

  1. Kjør/tilbakestill test: Kjører trinnet ved behov, eller fjerner gjeldende inndata og utdata.

    Skjermbilde av nodetestpanelet som viser inndelingene Inndata, Konfigurer og Utdata med Test-knappen uthevet.

  2. Last inn verdier fra forrige kjøring: En rullegardinliste over nylige kjøringer av denne flyten. Hvis du velger en, hentes resultatene fra oppstrømstrinnet fra denne kjøringen inn i inndatafeltene nedenfor.

  3. Inndata: Ett redigerbart felt per oppstrøms trinn gir nodereferansene. Merket til høyre for hver rad viser feltets forventede type (streng, e-post, dato/klokkeslett, tall osv.).

  4. Utdata: Det direkte resultatet av den nyeste testen, formatert for nodetypen (JSON, ledetekstresultat, koblingssvar osv.).

Simulerte inndata

Som standard er inndatafeltene tomme. Du kan gjøre følgende:

  • Skriv inn en verdi direkte i et felt. Feltet godtar typen som vises på høyre merke.
  • La et felt stå tomt hvis trinnet ikke avhenger av det.

Skjermbilde av nodetestpanelet som viser tomme inndatafelt med typemerker til høyre.

Tips

Hva vises her? Test-fanen viser automatisk oppstrømstrinnutdataene som denne nodens uttrykk refererer til. Hvis du legger til et nytt token i noden, vises det tilsvarende feltet neste gang du åpner Test.

Laste inn verdier fra en tidligere kjøring

Skjermbilde av Last inn verdier fra forrige rullegardinliste som viser tidligere kjøringer med dato- og klokkeslett- og statusetiketter.

Hvis flyten kjørte før, kan du spille av faktiske data på nytt i stedet for å skrive dem inn:

  1. Velg en kjøring i rullegardinlisten Last inn verdier fra forrige kjøring . Hver oppføring er merket med kjøringens dato/klokkeslett og status (for eksempel apr 24, 09:12 – vellykket).

  2. Utformeren henter trinnutdata for kjøring og projiserer dem gjennom nodens inndataskjema. Samsvarende verdier skrives inn i inndatafeltene.

  3. Rediger et felt etterpå hvis du vil justere scenarioet.

Rullegardinlisten viser de ti siste kjøringene med enhver status. Hvis en kjøring ikke inneholder utdata for ett av trinnene oppstrøms (fordi dette trinnet ble hoppet over eller banen ikke ble tatt), fylles bare de tilgjengelige feltene. Resten av feltene forblir som de var.

Hvis flyten ikke ble kjørt før, vises Ingen tidligere kjøringer og rullegardinlisten er skjult.

Kjør testen

Velg Kjør test. Knappen viser en travel tilstand mens samtalen er under flyging. Utdata-delen viser en spinner, deretter resultatet eller en feil.

  • Tilbakestillingstest fjerner både inndata og siste utdata.
  • Testen kjører noden isolert mot koblingens API. Testen utløser ikke resten av flyten.

Test hele flyten

Velg avspillingsknappen (test) på den øverste kommandolinjen. Test kjører flyten ende-til-ende mot den publiserte kjøretiden.

Før kjøringen starter, utformeren:

  1. Lagrer og publiserer flyten hvis du har endringer som ikke er lagret (eller hvis det er første gang).
  2. Installerer eventuelle nye tilkoblinger ved første kjøring.
  3. Utløser kjøringen. Banen avhenger av utløsertypen.
Utløsertype Hva skjer når du velger Test
Manuell / HTTP-forespørsel Det åpnes en dialogboks der du kan angi utløserinndata, og flyten kjøres umiddelbart.
Gjentagelse/glidevindu/avspørring Enten starter tidsplanen, og den første kjøringen starter automatisk, eller, hvis flyten allerede er installert, kjøres den én gang.
Koblingshendelse (for eksempel når det kommer en e-postmelding) Flyten publiseres og venter. Du kan se Venter på utløser.... Utfør handlingen i kildesystemet for å starte kjøringen.
HTTP webhook Flyten publiseres. Utløs den fra det eksterne systemet som du vanligvis ville gjort.

Simulerte inndata (manuell utløser)

For manuelle utløsere gjengir dialogboksen Angi manuelle utløserinndata ett felt per inndata du definerte på utløseren:

  • Tekst/nummer/e-post/dato: Riktig inndatakontroll.
  • Boolsk: Vekslebryter.
  • Enkeltvalg (opplisting): Rullegardinliste.
  • Flervalg: Rullegardinliste med flere valg.
  • Fil: Filvelger (innholdet lastes opp som en del av kjøringen).
  • Objekt/matrise: Flerlinjet tekstområde der du kan lime inn JSON.

Velg Kjør for å starte flyten med disse inndataene, eller Avbryt for å lukke uten å kjøre. Obligatoriske felt er merket med en stjerne. Hvis verdier mangler eller er ugyldige, vises innebygde valideringsmeldinger og kjøringen blokkeres til de er løst.

Dialogboksen vises hver gang du velger Test. Verdier lagres ikke mellom kjøringer, så du kan raskt prøve ulike scenarioer.

Se løpet

Når en kjøring er underveis:

  • Kommandolinjen viser en Avbryt-knapp mens kjøringen er aktiv.
  • Aktivitetspanelet (høyre side) viser gjeldende kjøring øverst med et statusmerke: Kjøring, venting, vellykket,mislykket eller avbrutt. Velg en kjøring for å åpne den på lerretet, og undersøk hvert trinns inndata og utdata.

Velg tidligere kjøringer

Aktivitetspanelet fungerer også som flytens kjørelogg:

  • Filtrer etter Alle / Vellykket / Mislykket / Kjører ved hjelp av rullegardinlisten øverst.
  • Velg Oppdater for å refetch listen.
  • Velg Last inn mer nederst til siden lenger tilbake.
  • Hvis du velger en kjøring, lastes den inn på lerretet, der hver node viser inndataene den mottok, og utdataene den produserte for denne kjøringen. Dataene er de samme som det testfanen på nodenivå bruker når du velger en kjøring fra rullegardinlisten.

Når du skal bruke hver testtype

  • Iterere over et enkelt AI-trinn eller en enkelt koblingshandling?: Test denne noden. Det er raskere, publiserer ikke, og lar deg mocke kun de oppstrømsverdiene som betyr noe.
  • Vil du validerer ende-til-ende-virkemåte eller utløserlogikk?: Kjør flyttest. Den utøver hele grafen mot den virkelige kjøretiden.
  • Gjenskape et produksjonsproblem?: Åpne den mislykkede kjøringen fra Aktivitet-panelet, åpne deretter den mislykkede noden og bruke Last inn verdier fra forrige kjøring i testfanen for å spille av de nøyaktige oppstrømsdataene til handlingen.