JSON-tulos

Kehote luo vastauksen oletusarvoisesti tekstinä. Teksti voi olla kätevä moniin käyttötarkoituksiin. Jos vastauksessa on kuitenkin useita elementtejä, jotka täytyy tunnistaa erikseen, tekstimuoto voi olla rajoittava.

JSON-tuloksen käytön edut

JSON-tulos mahdollistaa JSON-muotoisen rakenteen tuottamisen kehotevastaukselle tekstin sijaan. JSON helpottaa useita elementtejä sisältävien vastausten käsittelyä agenteissa, pilvityönkuluissa tai sovelluksissa.

Seuraava on esimerkki käyttötapauksista, jotka JSON-tulos mahdollistaa:

  • Jäsennetyn sisällön, kuten projektiaikataulun tai tuotetietojen, näyttäminen.
  • Tietojen poimiminen tekstistä, kuten laskuista, ostotilauksesta ja toimituslomakkeista.
  • Tunnista objektimääritteet tekstilähteistä, kuten sähköposteista tai Dataverse-tiedoista.
  • Useiden luokkien tai asenteiden saaminen tekstistä.

Kehotteen luominen JSON-tuloksen avulla

Tässä osassa käsitellään JSON-muodon valitsemista tulokseksi ja JSON-muodon muokkaamista.

JSON-muodon valitseminen tulokseksi

Jos haluat muuttaa kehotevastauksen hahmontamista, valitse JSON tulokseksi oikeassa yläkulmassa.

Näyttökuvassa Kehote ja JSON -sivun valinnat

Muokkaa JSON-muotoa

Voit tarkastella ja muokata JSON-muotoa valitsemalla Tulos: JSON-kohdan vasemmalla puolella olevan Asetukset-kuvakkeen.

Näyttökuva tuloksen asetuksista.

Muodon oletusasetus on Määritetty automaattisesti. Tämä muoto tarkoittaa, että aina kun kehotetta testataan, kehotteeseen liitetty muoto päivitetään testauksen aikana tunnistettuun muotoon. Tämä muoto on kätevä, kun kehotteen ohjeita iteroidaan ja halutaan tietää, miten vastausmuoto kehittyy.

Näyttökuvassa Automaattisesti määritetty muoto

Jos JSON-esimerkki päivitetään, muodoksi tulee Mukautettu eikä sitä päivitetä koskaan, jos kehotetta testataan uudelleen. Tämä muoto on kätevä, jos kehotteen säätämisen ei haluta vaikuttavan muotoon tai jos tiettyä muotoa on käytettävä.

Voit palata automaattisen tunnistuksen tilaan valitsemalla Takaisin automaattiseen tunnistamiseen -kuvakkeen.

Näyttökuvassa Palaa automaattiseen määritykseen -kuvake

Kehotetta testataan ja se tallennetaan seuraavasti:

  1. Vahvista juuri muokattu esimerkki valitsemalla Käytä.
  2. Jos haluat tarkistaa, miten kehotevastaus hahmontuu uudessa muodossa, valitse Testaa.
  3. Kun olet tehnyt muutokset, valitse Tallenna mukautus. Jos tämä vaihe ohitetaan, muutokset menetetään.

Lomakkeen tallennus lukitsee uusimman automaattisesti määritetyn muodon tai määritetyn mukautetun muodon. Tämä tarkoittaa sitä, että kun käytät kehotetta agentissa, pilvityönkulussa tai sovelluksessa, käytetään tallennettua muotoa – se ei vaihtele.

JSON-esimerkeistä luotava JSON-rakenne voidaan tarkistaa koska tahansa valitsemalla </>. Tätä rakennetta ei voi muokata tällä hetkellä.

Käytä kehotetta JSON-muotoisen tulosteen kanssa Power Automatessa

Tämä osio ohjaa sinua luomaan seuraavan pilvityönkulun:

Kuvakaappaus pilvityönkulusta, jossa on kehote

  1. Luo kehote laskujen käsittelemiseksi käyttämällä Kuva tai asiakirja -kohtaa syötteenä.

    Lisätietoja: Lisää teksti-, kuva- tai asiakirjasyötteitä kehotteeseen.

    Kuvakaappaus laskujen käsittelykehotteesta.

  2. Päivitä JSON-muoto antamalla seuraava JSON-esimerkki:

    Kuvakaappaus mukautetusta JSON-muodosta.

  3. Luo pilvityönkulku, jossa on Kun uusi sähköpostiviesti saapuu -käynnistin. Käsitelläksesi tiettyjä sähköposteja, varmista että suodattimet on asetettu.

    Lisätietoja on kohdassa Käynnistimien käytön aloittaminen.

  4. Lisää Suorita kehote -toiminto ja valitse ensimmäisessä vaiheessa luotu kehote.

  5. Lisää laskun syötteeseen sähköpostin liitetiedosto käynnistintoiminnosta.

    Kuvakaappaus pilvityönkulun kehotteen parametreista.

  6. Lisää Lähetä sähköpostiviesti -toiminto.

  7. Muokkaa sähköpostin tekstiosaa siten, että se sisältää kaikki kehotteen poimimat elementit JSON-tulosteen kanssa.

    Kuvakaappaus sähköpostin rungosta, jossa näkyvät JSON-kentät.

Usein kysytyt kysymykset

JSON-objektia ei voitu luoda

Kehotetta testattaessa saattaa ilmetä seuraava virhe: JSON-objektia ei voitu luoda. Muokkaa kehoteohjetta ja yritä uudelleen.

Tämä virhe voi johtua siitä, että malli ympäröi JSON-tuloksen metatiedoilla, jotka estävät vaaditun JSON-muodon onnistuneen tarkistamisen. Yritä ratkaista ongelma lisäämällä kehotteeseen seuraava ohje: Älä sisällytä vastaukseesi JSON-merkintää.

Yhtään JSON-muotoa ei palauteta automaattisessa määritystilassa

On mahdollista, että JSON-muotoa ei palauteta sen jälkeen, kun Testaa kehote on valittu automaattinen määritystila aktivoituna. Syynä voi olla se, että kehotteen ohjeet ovat ristiriidassa JSON-muodon palauttamisen järjestelmän ohjeiden kanssa. Ristiriita voidaan ratkaista muuttamalla kehotteen ohjetta ja testaamalla uudelleen.

JSON-muotoa ei ole päivitetty kehotteen suorituspalvelussa

Uusin automaattisessa määritystilassa havaittu JSON-muoto tai uusin mukautetussa tilassa määritetty JSON-muoto on kirjattu kehotteen tallennusajankohtana. Tätä tallennettua JSON-muotoa käytetään kehotteen suorituspalvelussa. Se varmistaa vastausmuodon yhdenmukaisuuden myös silloin, kun dynaamiset syötteet kehotteeseen muuttuvat.

Rajoitukset

  • JSON-rakennetta ei voi muokata.
  • JSON-muodon määrittämistä ilman kentän avaimia ei tueta.
    Esimerkki: muotoa ["abc", "def"] ei tueta, mutta muotoa [{"Field1": "abc"}, {"Field1": "def"}] tuetaan.

Video: kehotteen muodostin: JSON-tulosteet kehotteen muodostimessa

  • Last updated on