Rediger og administrer agentflyten eller arbeidsflyten i utformingen

Agentflyter og arbeidsflyter blir både laget og redigert i visuelle designere i Copilot Studio. De nye arbeidsflytene, nå i offentlig forhåndsversjon, bruker en redesignet visuell designer, mens agentflyter bruker den opprinnelige visuelle designeren. Begge visuelle designerne gir et lerret hvor du kan fortsette å bygge eller editere en automatisering. Legg til og fjern handlinger, sjekk for feil, og publiser flyten din – alt uten å forlate designeren. Du kan også justere hvordan agentflyten eller arbeidsflyten din vises, slik at du kan fokusere på spesifikke områder.

Viktig!

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.

For å vise en agentflyt eller arbeidsflyt i designeren, åpne Copilot Studio, velg Flyter, velg flyten, og deretter velg fanen Bygg.

Skjermbilde av Copilot Studio-designeren som viser en publisert arbeidsflyt med en trigger og flere handlinger.

Endre hvordan flyten vises

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

Skjermbilde av verktøylinjen for visningsalternativer i Copilot Studio-designeren, med forklaringer nummerert fra 1 til 6.

Forklaring:

  1. Zoom inn: Forstørr arbeidsflyten på lerretet.
  2. Zoom ut: Reduser størrelsen på arbeidsflyten på lerretet.
  3. Tilpass visning: Endre visningen slik at hele arbeidsflyten vises på lerretet.
  4. Rydd opp: Omorganiser arbeidsflyten og grenene for en mer oversiktlig visning.
  5. Vertikal visning: Bytt til en vertikal visning av arbeidsflyten.

Legg til og fjern handlinger

  1. På kortet du vil legge til handlingen etter, velg Legg til et steg. Ruten Legg til åpnes.

  2. Under Legg til, begynn å skrive handlingen du vil at flyten din skal utføre eller connectoren du vil legge til, og velg den deretter fra listen. Avhengig av valget ditt, kan det hende du må oppgi tilleggsinformasjon for å fullføre handlingen.

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

Sjekk flytparametere

For å se parameterne for en trigger eller handling i arbeidsflyten din, velg kortet deres. Konfigurasjonsruten åpnes på høyre side. For å angi en verdi for en parameter, velg et alternativ i nedtrekkslisten eller skriv inn et uttrykk for å angi verdien dynamisk.

Se versjonshistorikk for agentflyter

En versjonshistorikk registreres i Microsoft Dataverse når du bygger eller endrer en agentflyt. For å forstå hvordan en agentflyt har utviklet seg, gjennomgå versjonshistorikken. Flytversjoner grupperes etter dato, med indikatorer for nyeste versjon, publiserte versjoner og tidligere publiserte versjoner.

En flyts historikk er basert på lagrede versjoner, så det er lurt å lagre utkast før flyten er ferdig.

For å bruke versjonshistorikkpanelet må du lagre agentflyten minst én gang.

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

  2. For å se de lagrede versjonene av flyten, utvid et element i listen.

  3. For å vise versjonen i designeren, velg den i listen.

Se etter feil

Feil i arbeidsflythandlinger markeres med rødt. For å se detaljer om en feil i én handling, velg feilen. For å vise en liste over alle feil i hele flyten, åpne helsesenter-banneret. Velg feilen for å vise detaljer for individuelle feil.

Viktig!

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

Publiser arbeidsflyt

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

Test agentflyten eller arbeidsflyten din

Testkjøringer lar deg verifisere et trinn eller en hel flyt uten å forlate designeren, ved å bruke enten ekte upstream-data, simulerte verdier, eller resultater fra en tidligere kjøring.

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

Hva vil du bekrefte? Slik tester du Hvor du finner dette
En enkelt handling eller AI-trinn i isolasjon Test denne noden Testfanen inne i nodens sidepanel
Hele flyten, ende-til-ende Kjør flyt-testen Play-knappen i den øverste kommandolinjen

Begge grensesnitt deler samme idé: gi inndata (ekte eller simulerte), kjør, og inspiser deretter utdata.

Test en enkelt node i en arbeidsflyt

Åpne en hvilken som helst handling eller node i arbeidsflyten din og velg Play- eller Test-knappen. Det er tre seksjoner:

  1. Kjør / Tilbakestill test: Kjører trinnet ved behov, eller nullstiller de nåværende inngangene og utgangene.

    Skjermbilde av nodetestpanelet som viser Innganger, Konfigurer og Utdata-seksjonene med Test-knappen fremhevet.

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

  3. Innganger: Ett redigerbart felt per utdata fra et oppstrøms trinn som noden refererer til. Merket til høyre i hver rad viser feltets forventede type (streng, e-post, dato-tid, nummer osv.).

  4. Utdata: Det siste resultatet av den nyeste testen, formatert for nodetypen (JSON, spørsmålresultat, koblingsrespons, osv.).

Testinndata

Som standard er inndatafeltene tomme. Du kan:

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

Skjermbilde av nodetestpanelet som viser tomme inndatafelter og typeetiketter til høyre.

Tips

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

Lastverdier fra en tidligere kjøring

Skjermbilde av

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

  1. I nedtrekksmenyen for lastverdier fra forrige gjennomspilling, velg en runde. Hver oppføring viser kjøringens dato/klokkeslett og status (f.eks. 24. april, 09:12 — Vellykket).

  2. Designeren henter trinnutdataene fra den kjøringen og projiserer dem gjennom nodens inndataskjema. Tilsvarende verdier skrives inn i inndatafeltene.

  3. Du kan redigere hvilket som helst felt etterpå hvis du vil justere scenarioet.

Rullegardinlisten viser de ti siste kjøringene med enhver status. Hvis en kjøring ikke inkluderer utdata for ett av dine oppstrømtrinn (fordi det trinn ble hoppet over eller stien ikke ble tatt), fylles kun 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 at den er opptatt mens anropet pågår; utdata-seksjonen viser en spinner, deretter resultatet eller en feil.

  • Tilbakestill test nullstiller både inngangene og siste utdata.
  • Testen kjører noden isolert mot connectorens API. Testen utløser ikke resten av flyten.

Test hele flyten

I den øverste kommandolinjen velger du play-knappen (Test). Test kjører flyten ende-til-ende mot den publiserte kjøretiden.

Før kjøringen starter, gjør designeren:

  1. Lagrer og publiserer flyten hvis du har ulagrede endringer (eller hvis det er første gang).
  2. Installerer eventuelle nye tilkoblinger ved første kjøring.
  3. Utløser kjøringen. Veien avhenger av hvilken type trigger du har.
Utløsertype Hva skjer når du velger Test
Manuell / HTTP-forespørsel En dialogboks åpnes slik at du kan angi triggerverdiene, deretter kjøres flyten umiddelbart.
Gjentakelse/glidende vindu/polling 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 en e-post ankommer) 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.

Prøveinnganger (manuell utløser)

For manuell trigger, dialogen Skriv inn manuelle triggerinnganger viser ett felt for hver input du har definert i utløseren:

  • Tekst/nummer/e-post/dato: Passende inputkontroll.
  • Boolsk: Vekslebryter.
  • Enkeltvalg (opplisting): Rullegardinliste.
  • Flervalg: Flervalg nedtrekksmeny.
  • Fil: Filvelger (innholdet lastes opp som en del av kjøringen).
  • Objekt/array: Flerlinjes tekstområde hvor du kan lime inn JSON.

Velg Kjør for å starte flyten med de angitte dataene, eller Avbryt for å lukke dialogen uten å kjøre. Nødvendige felt er merket med et stjernetegn. Hvis verdier mangler eller er ugyldige, vises valideringsmeldinger direkte i skjemaet, og kjøringen blokkeres til de er korrigert.

Dialogen vises hver gang du velger Test. Verdier lagres ikke mellom kjøringer, slik at du raskt kan teste ulike scenarioer.

Følg kjøringen

Når en kjøring er underveis:

  • Kommandolinjen viser en Avbryt-knapp mens kjøringen er aktiv.
  • Aktivitetspanelet (på høyre side) viser den aktive kjøringen øverst med et statusmerke: Kjører, Venter, Vellykket, Mislykket, eller Avbrutt. Velg en hvilken som helst kjøring for å åpne den på lerretet og inspiser hvert trinns innganger og utganger.

Velg tidligere kjøringer

Aktivitetspanelet fungerer også som kjøringshistorikk for flyten din:

  • Filtrer etter Alle / Vellykket / Mislykket / Kjører ved å bruke nedtrekksmenyen øverst.
  • Velg Oppdater for å hente listen på nytt.
  • Velg Last inn mer nederst for å bla lenger tilbake.
  • Når du velger en kjøring, lastes den inn på lerretet, hvor hver node viser hvilke innganger den mottok og hvilke utganger den produserte for den kjøringen. Dataene er de samme som Test-fanen på nodenivå bruker når du velger en kjøring fra rullegardinmenyen.

Når bør du bruke de ulike testtypene

  • Jobber du med et enkelt AI-trinn eller koblingshandling?: Test denne noden. Det går raskere, publiserer ikke, og lar deg simulere bare de oppstrømsverdiene som har betydning.
  • Vil du validerer ende-til-ende-virkemåte eller utløserlogikk?: Kjør flyttest. Den utøver hele grafen mot den virkelige kjøretiden.
  • Forsøker du å gjenskape et produksjonsproblem?: Åpne den mislykkede kjøringen fra Aktivitets-panelet, åpne deretter den mislykkede noden og bruk Last inn verdier fra forrige kjøring i Test-fanen for å gjenskape nøyaktig de oppstrømsdataene i handlingen.