Dane wyjściowe w formacie JSON

Domyślnie monit generuje tekst jako odpowiedź. Tekst może być wygodny w wielu przypadkach użycia, lecz jeśli odpowiedź zawiera kilka elementów wymagających osobnej identyfikacji, opcja tekstowa może być ograniczona.

Korzyści z używania danych wyjściowych JSON

Dane wyjściowe JSON umożliwiają generowanie struktury JSON dla odpowiedzi na polecenie zamiast tekstu. JSON ułatwia przetwarzanie odpowiedzi zawierających wiele elementów w agentach, przepływach w chmurze lub aplikacjach.

Poniżej podano przykład użycia spraw, które staną się możliwe w przypadku danych wyjściowych JSON:

  • Wyświetlanie ustrukturalizowanej zawartości, np. harmonogramu projektu lub informacji o produkcie.
  • Wyodrębnianie danych z tekstu, takiego jak faktury, zamówienie zakupu, formularze dostawy i wiele innych.
  • Identyfikowanie atrybutów obiektów ze źródeł tekstowych, takich jak wiadomości e-mail lub dane Dataverse.
  • Pobieranie wielu kategorii lub opinii z tekstu.

Tworzenie monitu z danych wyjściowych JSON

W tej sekcji opisano sposób wybierania JSON jako danych wyjściowych i edytowania formatu JSON.

Wybierz JSON jako dane wyjściowe

Aby zmienić sposób renderowania odpowiedzi na polecenie, wybierz pozycję JSON jako dane wyjściowe w prawym górnym rogu.

Zrzut ekranu przedstawiający wybór na stronie „Monit z JSON”.

Edytuj format JSON

Aby wyświetlić lub edytować format JSON, wybierz ikonę ustawień po lewej stronie pozycji Dane wyjściowe: JSON.

Zrzut ekranu ustawień wyjściowych.

Domyślnie format jest wykrywany automatycznie. Ten format oznacza, że podczas każdego testowania monitu format skojarzony z monitem jest odświeżany wraz z formatem wykrytym podczas testowania. Ten format jest wygodne w przypadku, gdy instrukcje monitu są szczegółowe i użytkownik chce dowiedzieć się, jak rozwija się format odpowiedzi.

Zrzut ekranu przedstawiający opcję „Format wykryty automatycznie”.

Po zaktualizowaniu przykładu JSON format staje się niestandardowy i nie jest aktualizowany, jeśli monit zostanie przetestowany ponownie. Ten format jest wygodny, jeśli nie chcesz zmienić polecenia, wpływając na format, lub jeśli chcesz postępować zgodnie z określonym formatem.

Możesz powrócić do trybu automatycznego wykrywania, wybierając ikonę Wróć do automatycznego wykrywania.

Zrzut ekranu przedstawiający ikonę „Powrót do wykrywania automatycznego”.

Aby przetestować i zapisać monit, wykonaj następujące czynności:

  1. Aby potwierdzić nowo zmodyfikowany przykład, wybierz opcję Zastosuj.
  2. Aby sprawdzić, jak odpowiedź na polecenie jest renderowana w nowym formacie, wybierz pozycję Testuj.
  3. Po zakończeniu modyfikacji wybierz pozycję Zapisz niestandardowe. Po pominięciu tego kroku zmiany zostaną utracone.

Po zapisaniu monitu blokujesz najnowszy format wykrywany automatycznie lub zdefiniowany format niestandardowy. Oznacza to, że gdy używasz swojego polecenia w agencie, przepływie w chmurze lub aplikacji, wykorzystywany jest zapisany format — nie ulega zmianie.

W dowolnym momencie można sprawdzić schemat JSON, który generuje przykłady JSON, wybierając opcję </>. Obecnie nie można zmodyfikować tego schematu.

Używanie polecenia z danymi wyjściowymi JSON w Power Automate

Ten obszar przeprowadzi Cię przez tworzenie następującego przepływu w chmurze:

Zrzut ekranu przedstawiający parametry polecenia w przepływie w chmurze

  1. Utwórz polecenie przetworzenia faktur przy użyciu obrazu lub dokumentu jako danych wejściowych.

    Dowiedz się jak dodać dane wejściowe tekstu, obrazu lub dokumentu do promptu.

    Zrzut ekranu z poleceniem Przetwarzanie faktur.

  2. Zaktualizuj format JSON, podając następujący przykład JSON:

    Zrzut ekranu niestandardowego formatu JSON.

  3. Utwórz przepływ w chmurze za pomocą wyzwalacza, gdy pojawia się nowa wiadomość e-mail. Aby przetworzyć określone wiadomości e-mail, pamiętaj o ustawieniu filtrów.

    Więcej informacji znajdziesz w sekcji Pierwsze kroki z wyzwalaczami.

  4. Dodaj akcję Uruchom polecenie i wybierz polecenie utworzone w pierwszym kroku.

  5. W danych wejściowych faktury dodaj załącznik wiadomości e-mail z akcji wyzwalacza.

    Zrzut ekranu przedstawiający parametry polecenia w przepływie w chmurze.

  6. Dodaj akcję Wyślij wiadomość e-mail.

  7. Edytuj treść wiadomości e-mail, aby uwzględnić elementy wyodrębnione przez polecenie z danymi wyjściowymi w formacie JSON.

    Zrzut ekranu treści e-mail z polami JSON.

Często zadawane pytania

Nie można wygenerować raportu JSON

Podczas testowania monitu może wystąpić następujący błąd: Nie można wygenerować pliku JSON. Edytuj instrukcję monitu i spróbuj ponownie.

Ten błąd może być spowodowany tym, że model otacza dane wyjściowe JSON informacjami o metadanych, które uniemożliwiają pomyślną weryfikację wymaganego formatu JSON. Aby rozwiązać problem, spróbuj dodać następującą instrukcję do monitu: Nie dołączaj znacznika JSON do odpowiedzi.

W trybie automatycznego wykrywania nie jest zwracany żaden kod JSON

Po wybraniu Test polecenia z aktywowanym trybem automatycznego wykrywania nie jest zwracany żaden kod JSON. Może tak być, jeśli instrukcje monitu będą wymagały instrukcji systemowych dotyczących zwrotu danych JSON. Można to rozwiązać, zmieniając instrukcji obsługi monitu i testując go ponownie.

Format JSON nie jest aktualizowany w czasie wykonywania monitów

Najnowszy format JSON wykryty w trybie automatycznego wykrywania lub najnowszy format JSON zdefiniowany w trybie niestandardowym jest rejestrowany jako oszczędność czasu polecenia. Ten zarejestrowany format JSON jest stosowany w czasie wykonywania monitu, co zapewnia spójność formatu odpowiedzi nawet w przypadku zmiany dynamicznych danych wejściowych monitu.

Ograniczenia

  • Nie można modyfikować schematu JSON.
  • Nie obsługujemy definiowania formatu JSON bez kluczy pól.
    Przykład: ["abc", "def"] nie jest obsługiwany, ale [{"Field1": "abc"}, {"Field1": "def"}] jest obsługiwany.

Wideo: konstruktor poleceń: dane wyjściowe JSON w konstruktorze poleceń

  • Last updated on