Agentin työnkulun tai muun työnkulun muokkaaminen ja hallinta suunnitteluohjelmassa

Jos haluat näyttä agentin työnkulun tai muun työnkulun suunnittelutyökalussa, avaa Copilot Studio, valitse Työnkulut ja valitse sitten työnkulku. Valitse lopuksi Luo-välilehti.

Jos haluat näyttä agentin työnkulun suunnittelutyökalussa, avaa Copilot Studio, valitse Työnkulut ja valitse sitten työnkulku. Valitse lopuksi Suunnittelutyökalu-välilehti.

Selite:

1. Lähennä: Suurenna kaavion työnkulun kokoa.
2. Loitonna: Pienennä kaavion työnkulun kokoa.
3. Sovita näkymä: Muuta näkymän kokoa niin, että koko työnkulku näkyy kaaviossa.
4. Siivoa: Järjestä työnkulku ja haarat uudelleen, jotta saat selkeän ja kattavan näkymän.
5. Pystysuuntainen asettelu: Vaihda työnkulun pystysuuntaiseen näkymään.

Selite:

1. Laajenna/kutista: Laajenna tai kutista kaikki toimintoryhmät. Jos toiminnolla on esimerkiksi useita ehtoja, valitse tämä kuvake näyttääksesi ehdon tiedot.
2. Lähennä: Suurenna työnkulun kaavion kokoa.
3. Loitonna: Pienennä kaavion työnkulun kokoa.
4. Sovita näkymä: Muuta näkymän kokoa niin, että se sopii kaavion koko työnkulkuun.
5. Minikartta: Siirry suuren työnkulun tiettyyn osaan.
6. Haku: Etsi toiminto työnkulusta.

1. Valitse Lisää vaihe siinä kortissa, johon haluat lisätä toiminnon. Lisää-ruutu avautuu.

2. Aloita kirjoittaa työnkulkuun lisättävän toiminnon tai lisättävän yhdistimen nimeä Lisää-kohdassa ja valitse kohde luettelosta. Valinnasta riippuen toiminnon suorittaminen voi edellyttää lisätietojen antamista.

Jos huomaat, ettei toimintoa tarvita, valitse Poista-kuvake toiminnon oikeassa yläkulmassa.

1. Valitse Lisää uusi toiminto sen kortin alapuolella, johon toiminto lisätään. Lisää toiminto -paneeli avautuu.

2. Aloita kirjoittamalla toiminto, jonka haluat lisätä Lisää toiminto -kohdassa, ja valitse se sitten luettelosta. Valinnasta riippuen toiminnon suorittaminen voi edellyttää lisätietojen antamista.

Jos toimintoa ei tarvitakaan, valitse se työnkulusta ja valitse sitten kolme pistettä (⋮) >Poista. Vahvista poisto valitsemalla OK.

Jos haluat tarkastella käynnistimen tai toiminnon parametreja työnkulussa, valitse työnkulun kortti. Määrityspaneeli avautuu oikealle puolelle. Jos haluat syöttää parametrille arvon, valitse vaihtoehto avattavasta luettelosta tai anna lauseke arvon dynaamista asettamista varten.

Jos haluat tarkastella käynnistimen tai toiminnon parametreja agentin työnkulussa, valitse työnkulun kortti. Konfiguraatiopaneeli avautuu Parametrit-välilehti näkyy oletusarvoisesti. Jos haluat syöttää parametrille arvon, valitse vaihtoehto avattavasta luettelosta tai anna lauseke arvon dynaamista asettamista varten.

Virheet työnkulun toiminnoissa on merkitty punaisella. Jos haluat tarkastella virheen yksityiskohtia yhdessä toiminnossa, valitse virhe. Jos haluat luetteloida koko työnkulun kaikki virheet, avaa kuntokeskuksen banneri. Voit tarkastella yksittäisten virheiden tietoja valitsemalla virheen.

Agentin työnkulun toimintojen virheet osoitetaan punaisella värillä. Jos haluat tarkastella virheen yksityiskohtia yhdessä toiminnossa, valitse virhe. Jos haluat luetella kaikki koko työnkulun virheet, valitse kaavio-merkin yläreunan valikossa Työnkulun tarkistaja. Voit tarkastella yksittäisten virheiden tietoja valitsemalla virheen. Vaihtoehtoisesti voit avata operaation työnkulun tarkistuspaneelissa valitsemalla Avaa operaatio ja korjata virheen.

Testisuoritusten avulla voit tarkistaa vaiheen tai koko työnkulun poistumatta suunnittelutyönkulusta käyttämällä todellisia yläpuolisia tietoja, itse muokkaamiasi arvoja ja edellisen suorituksen tuloksia.

Testi voidaan suorittaa seuraavilla kahdella tavalla:

Molemmat alustat toimivat samalla periaatteella. Niissä annetaan syötteet (todelliset tai muokatut syötteet), suoritetaan testi ja tarkastetaan tulos.

Testaa yhtä solmua työnkulussa

Avaa mikä tahansa toiminto tai solmu työnkulussa ja valitse Toista- tai Testaa-painike. Osia on seuraavat kolme:

1. Suorita/nollaa testi: Suorittaa vaiheen tarvittaessa tai tyhjentää nykyiset syötteet ja nykyisen tuloksen.

   

2. Lataa arvot edellisestä suorituksesta: Tämän työnkulun edellisten suoritusten avattava luettelo. Kun yksi on valittu, yläpuolisen vaiheen tulokset tuodaan tästä suorituksesta alla oleviin syöttökenttiin.

3. Syötteet: Yksi muokattava kenttä yläpuolisen vaiheen tuloksessa, johon solmu viittaa. Jokaisen rivin oikealla puolella oleva infopiste näyttää kentän odotetun tyypin (esimerkiksi merkkijono, sähköposti, päivämäärä ja aika sekä numero).

4. Tulos: Viimeisimmän testin reaaliaikainen tulos solmutyypin mukaisessa muodossa (esimerkiksi JSON, kehotteen tulos tai yhdistimen vastaus).

Muutetut syötteet

Syötekentät ovat oletusarvoisesti tyhjiä. Voit tehdä seuraavia toimintoja:

• Kirjoita suoraan kenttään mikä tahansa arvo. Kenttä hyväksyy oikealla puolella olevan infopisteen osoittaman tyypin.
• Jätä kenttä tyhjäksi, jos vaihe ei riipu siitä.

Lataa arvot edellisestä suorituksesta

Jos työnkulku on suoritettu aiemmin, voit käyttää todellisia tietoja uudelleen sen sijaan, että syöttäisit ne manuaalisesti:

1. Valitse suoritus avattavasta Lataa arvot aiemmasta suorituksesta -valikosta. Jokainen syöttö on merkitty suorituksen päivämäärällä, kellonajalla ja tilalla (esimerkiksi 24. huhtikuuta klo 09.12 – Onnistui).

2. Suunnittelutyökalu hakee kyseisen suorituksen vaiheen tulokset ja esittää ne solmun syöterakenteen kautta. Syötekenttiin kirjoitetaan vastaavat arvot.

3. Voit muokata mitä tahansa kenttää jälkikäteen, jos haluat muokata skenaariota.

Avattavassa valikossa näkyy kymmenen viimeisintä suoritusta, joiden tila voi olla mikä tahansa. Jos suoritus ei tuota tuloksia jostakin yläpuolisesta vaiheesta (koska vaihe ohitettiin tai polkua ei ole seurattu), täytetään vain käytettävissä olevat kentät. Muut kentät pysyvät ennallaan.

Jos työnkulkua ei ole suoritettu aiemmin, näkyvissä on Aiempia suorituksia ei ole saatavilla ja avattava valikko piilotetaan.

Testin suorittaminen

Valitse Suorita testi. Painike näyttää Varattu-tilan, kun kutsu on käynnissä.Tulos-osa näyttää hyrräkuvakkeen ja sn jälkeen tuloksen tai virheen.

• Nollaa testi tyhjentää sekä syötteet että viimeisen tuloksen.
• Testi suorittaa solmun eristyksissä yhdistimen ohjelmointirajapinnan avulla. Testi ei käynnistä työnkulun loppuosaa.

Koko työnkulun testaaminen

Valitse komentopalkin yläosassa Toista-painike (Testi). Testi suorittaa työnkulun alusta loppuun live-suorituspalvelun avulla.

Ennen kuin suoritus alkaa, suunnittelutyökalu tekee seuraavat toiminnot:

1. Tallentaa ja julkaisee työnkulun, jos tallentamattomia muutoksia löytyy (tai jos tämä on ensimmäinen kerta).
2. Asentaa mahdolliset uudet yhteydet ensimmäisen suorituksen aikana.
3. Käynnistää suorituksen. Polku riippuu käynnistimen tyypistä.

Muutetut syötteet (manuaalinen käynnistin)

Manuaalisille käynnistimille Syötä manuaalisen käynnistimen syötteet -valintaikkuna näyttää yhden kentän jokaista käynnistimessä määritellylle syötteelle seuraavasti:

• Teksti/numero/sähköposti/päivämäärä: Soveltuva syötekenttä.
• Totuusarvo: Valintakytkin.
• Yksi valinta (luettelointi): Avattava valikko.
• Monivalinta: Avattava monivalintavalikko.
• Tiedosto: Tiedostovalitsin (sisältö ladataan suorituksen osana).
• Objekti/matriisi: Monirivinen tekstialue, johon voi liittää JSON-tiedot.

Valitse Suorita, jos haluat aloittaa työnkulun näillä syötteillä, tai Peruuta, jos haluat poistua suorittamatta työnkulkua. Pakolliset kentät on merkitty tähdellä. Jos arvot puuttuvat tai ovat virheellisiä, näytetään tekstin sisäisen tarkistuksen viestejä. Suoritus estetään siihen asti, kunnes nämä on korjattu.

Valintaikkuna avautuu aina, kun valitset Testi-kohdan. Arvoja ei tallenneta suoritusten välillä, joten voit nopeasti kokeilla erilaisia skenaarioita.

Suorituksen seuraaminen

Kun suoritus on käynnissä:

• Komentopalkissa näkyy Peruuta-painike suorituksen ollessa käynnissä.
• Aktiviteetti-paneeli (oikealla puolella) sisältää nykyisen suorituksen yläosassa sekä tilan infopisteen: Suoritetaan, Odottaa, Onnistui, Epäonnistui tai Peruutettu. Valitse mikä tahansa suoritus avataksesi sen kaaviossa ja tarkista jokaisen vaiheen syötteet ja tulokset.

Aiempien suoritusten valitseminen

Aktiviteetti-paneeli toimii työnkulun suoritushistoriana seuraavasti:

• Käytä suodatusperusteena Kaikki-, Onnistunut -, Epäonnistunut- tai Käynnissä-tilaa yläreunan avattavan valikon avulla.
• Valitse Päivitä, jotta voit hakea luettelon uudelleen.
• Valitse Lataa lisää alaosassa, jos haluat palata takaisin.
• Suorituksen valitseminen lataa sen kaavioon, jossa jokainen solmu näyttää kyseiselle suoritukselle vastaanotetut syötteet ja tuotetut tulokset. Tiedot ovat samat kuin solmutason Testi-välilehti käyttää, kun suoritus valitaan sen avattavasta valikosta.

Kunkin testityypin käyttö

• Iteroidaanko yksittäinen tekoälyvaihe tai yhdistimen toiminto?: Testaa tämä solmu. Se on nopea, eikä julkaise. Voit muuttaa vain tarvittavat yläpuoliset arvot.
• Tarkistetaanko kattava toiminta tai käynnistimen logiikka?: Suorita työnkulun testi. Se käyttää koko kaaviota reaaliaikaisen suorituspalvelun avulla.
• Toistetaanko tuotantovirhe?: Avaa epäonnistunut suoritus Aktiviteetti-paneelissa ja avaa sitten epäonnistut solmu. Käytä Lataa arvot edellisestä suorituksesta sen Testi-välilehdessä, jotta voit toistaa toiminnossa yläpuoliset tiedot tarkalleen.

Vaikka työnkulussa ei olisi virheitä ja se voidaan julkaista, työnkulku ei välttämättä tee haluttuja asioita. Kun agentin työnkulku on julkaistu, testaa työnkulku varmistaaksesi, että se toimii toivotulla tavalla.

Voit suorittaa testin manuaalisesti tai automaattisesti. Kun testi on suoritettu, voit tarkistaa kunkin toiminnon tuloksen varmistaaksesi, että työnkulku toimii oikein.

1. Tallenna ja julkaise työnkulkusi.

2. Valitse kaavion yläosan valikossa avattava Testi. Testaa työnkulku -paneeli avautuu.

3. Valitse, tulisiko testi suorittaa manuaalisesti vai automaattisesti.

4. Valitse Suorita työnkulku -paneelissa Testaa>Suorita työnkulku. Vihreä valintamerkki osoittaa, että työnkulun suoritus onnistui.

5. Valitse Valmis.

Agentin työnkulun testaaminen suunnittelutyökalussa ei kuluta Copilot Studion kapasiteettia.