Sdílet prostřednictvím


Výstup JSON

Ve výchozím nastavení výzva vygeneruje text jako odpověď. Text může být vhodný pro mnoho případů použití; Pokud však odpověď obsahuje několik prvků, které je potřeba identifikovat jednotlivě, může být možnost textu omezena.

Výhody použití výstupu JSON

Výstup JSON umožňuje vygenerovat strukturu JSON pro odpověď výzvy místo textu. JSON usnadňuje zpracování odpovědí s několika prvky v agentech, cloudových tocích nebo aplikacích.

Následuje příklad případů použití, které se dají s výstupem JSON:

  • Umožňuje zobrazit strukturovaný obsah, jako je plán projektu nebo informace o produktu.
  • Extrahujte data z textu, jako jsou faktury, nákupní objednávka, formuláře doručení a mnoho dalších.
  • Identifikujte atributy objektu z textových zdrojů, jako jsou e-maily nebo data Dataverse.
  • Získejte z textu více kategorií nebo mínění.

Vytvoření výzvy s výstupem JSON

Tato část popisuje, jak vybrat JSON jako výstup a upravit formát JSON.

Výběr FORMÁTU JSON jako výstupu

Chcete-li změnit způsob vykreslení odpovědi výzvy, vyberte v pravém horním rohu jako výstup JSON.

Snímek obrazovky s výběry na stránce Výzva s JSON

Úprava formátu JSON

Pokud chcete zobrazit nebo upravit formát JSON, vyberte ikonu nastavení vlevo od výstupu: JSON.

Snímek obrazovky s nastavením výstupu

Ve výchozím nastavení je formát automaticky zjištěn. Tento formát znamená, že při každém otestování výzvy se formát přidružený k výzvě aktualizuje s formátem zjištěným při testování. Tento formát je pohodlný, když iterujete pokyny k zobrazení výzvy a chcete vědět, jak se formát odpovědi vyvíjí.

Snímek obrazovky s automaticky rozpoznaným formátem

Pokud aktualizujete příklad JSON, formát se změní na Vlastní a při dalším otestování výzvy se nikdy neaktualizuje. Tento formát je praktický, pokud nechcete, aby úpravy výzvy negativně ovlivňovaly jeho strukturu, nebo pokud potřebujete dodržet konkrétní formát.

Režim automatického zjišťování můžete vrátit tak, že vyberete ikonu Zpět k automatickému rozpoznání .

Snímek obrazovky ikony 'Zpět k automaticky rozpoznanému'

Chcete-li otestovat a uložit výzvu, postupujte takto:

  1. Pokud chcete potvrdit nově upravený příklad, vyberte Použít.
  2. Pokud chcete zkontrolovat, jak se odpověď výzvy vykresluje s novým formátem, vyberte Test.
  3. Po dokončení úprav vyberte Uložit vlastní. Pokud tento krok přeskočíte, změny se ztratí.

Po uložení výzvy uzamknete nejnovější automaticky rozpoznaný formát nebo definovaný vlastní formát. To znamená, že když použijete výzvu v agentovi, v cloudovém toku nebo v aplikaci, použije se uložený formát – nemění se.

Kdykoli můžete zkontrolovat schéma JSON, které generují příklady JSON, a to výběrem </>. Toto schéma nelze v současné době upravovat.

Použití výzvy s výstupem JSON v Power Automate

Tato část vás provede vytvořením následujícího toku cloudu:

Snímek obrazovky s tokem cloudu s výzvou

  1. Vytvořte výzvu ke zpracování faktur pomocí obrázku nebo dokumentu jako vstupu.

    Další informace najdete v tématu Přidání textu, obrázku nebo vstupu dokumentu do výzvy.

    Snímek obrazovky s výzvou ke zpracování faktury

  2. Aktualizujte formát JSON zadáním následujícího příkladu JSON:

    Snímek obrazovky s vlastním formátem JSON

  3. Vytvořte tok v cloudu pomocí spouštěče Při přijetí nového e-mailu. Pokud chcete zpracovat konkrétní e-maily, nezapomeňte nastavit filtry.

    Další informace najdete v článku Začínáme s triggery.

  4. Přidejte akci Spustit výzvu a vyberte výzvu, kterou jste vytvořili v prvním kroku.

  5. Ve vstupu faktury přidejte e-mailovou přílohu ze spouštěcí akce.

    Snímek obrazovky s parametry výzvy v cloudovém toku.

  6. Přidejte akci Odeslat e-mail .

  7. Upravte text e-mailu tak, aby zahrnoval prvky extrahované výzvou s výstupem JSON.

    Snímek obrazovky s textem e-mailu s poli JSON

časté otázky

Json se nepodařilo vygenerovat.

Při testování výzvy se může zobrazit následující chyba: Kód JSON se nedá vygenerovat. Upravte pokyny k zobrazení výzvy a zkuste to znovu.

Příčinou této chyby může být to, že model uzavře výstup JSON s informacemi o metadatech, které brání úspěšnému ověření požadovaného formátu JSON. Pokud chcete tento problém vyřešit, zkuste do výzvy přidat následující instrukce: Do odpovědi nezahrnujte markdown JSON.

V režimu automatického zjišťování se nevrátí žádný JSON.

Po výběru testovací výzvy s aktivovaným režimem automatického zjišťování je možné, že se nevrátí žádný JSON. Důvodem může být to, že pokyny výzvy jsou v rozporu se systémovými instrukcemi pro vrácení kódu JSON. Můžete ho vyřešit tak, že změníte instrukce výzvy a znovu otestujete.

Formát JSON se neaktualizuje během spouštění výzvy

Nejnovější formát JSON zjištěný v režimu automatického zjišťování nebo nejnovější formát JSON definovaný ve vlastním režimu se zaznamená ve chvíli uložení výzvy. Tento zaznamenaný formát JSON se použije za běhu výzvy a zajišťuje konzistenci formátu odpovědi i v případě, že se mění dynamické vstupy výzvy.

Omezení

  • Schéma JSON nelze upravit.
  • Nepodporujeme definování formátu JSON bez klíčů polí.
    Příklad: ["abc", "def"] nepodporuje se, ale [{"Field1": "abc"}, {"Field1": "def"}] podporuje se.

Video: Nástroj pro vytváření výzev: Výstupy JSON v nástroji pro vytváření výzev