По умолчанию в качестве ответа на запрос генерируется текст. Текст может быть удобен во многих случаях использования. Однако если ответ содержит несколько элементов, которые необходимо идентифицировать индивидуально, параметр текста можно ограничить.
Преимущества использования выходных данных JSON
Выходные данные JSON позволяет вам генерировать структуру JSON вместо текста для быстрого ответа на запрос. JSON упрощает обработку ответов с несколькими элементами в Power Automate или Power Apps.
Ниже приведен пример вариантов использования, которые становятся возможными при выводе результатов в формате JSON:
Отображение структурированного контента, такого как график проекта или информация о продукте.
Извлечение данных из текста, например из счета-фактуры, заказа на покупку, форм доставки и т. д.
Определение атрибутов объекта из текстовых источников, таких как электронные письма или данные Dataverse.
Получение данных о нескольких категориях или настроениях из текста.
Создание запроса с выходными данными JSON
В этом разделе описывается, как выбрать JSON в качестве выходных данных и отредактировать формат JSON.
Выберите JSON в качестве выходных данных
Чтобы изменить способ отображения ответа на запрос, выполните следующие действия:
На панели справа под заголовком Параметры запроса выберите Выходные данные>JSON.
В левом нижнем углу выберите Проверить запрос, чтобы проверить, как ваш ответ на запрос отображается в формате JSON.
Изменение формата JSON
По умолчанию используется формат Автоматическое обнаружение. Этот формат означает, что каждый раз, когда вы тестируете запрос, формат, связанный с запросом, обновляется форматом, обнаруженным во время тестирования. Этот формат удобен, когда вы повторяете инструкции запроса и хотите знать, как меняется формат ответа.
Если вы обновите образец JSON, формат станет Пользовательским и никогда не будет обновляться при повторном тестировании запроса. Этот формат удобен, если вы не хотите, чтобы быстрая корректировка запроса влияла на формат, или если вам нужно следовать определенному формату.
Вы можете вернуться в режим автоматического обнаружения, выбрав Вернуться к автоматическому обнаружению.
Чтобы протестировать и сохранить запрос, выполните следующие действия:
Чтобы подтвердить новый измененный пример, выберите Применить.
Чтобы проверить, как ваш ответ на запрос отображается в новом формате, выберите Проверить запрос.
Закончив внесение изменений, выберите Сохранить пользовательский запрос.
Если вы пропустите этот шаг, ваши изменения будут потеряны.
При сохранении запроса вы блокируете последний формат автоматического обнаружения или пользовательский формат. Это означает, что когда вы используете запрос в Power Automate или Power Apps, используется сохраненный формат — он не меняется.
В любой момент вы можете проверить схему JSON, которая генерируется на основе примеров JSON, выбрав </>. В настоящее время вы не можете изменить эту схему.
Использование запроса с выходными данными JSON в Power Automate
После добавления действия Созданный текст с GPT в поток Power Automate вы можете использовать все поля JSON в качестве динамических значений без добавления сложной логики для анализа ответа.
В следующем примере показано, как можно обработать счет, полученный по электронной почте, с помощью запроса, описанного в разделе Создание запроса с выходными данными JSON в этой статье.
Создайте поток с помощью триггера При поступлении нового сообщения электронной почты.
Поскольку предыдущее действие возвращает таблицу строк внутри таблицы страницы, удобнее объединить все строки в одну уникальную переменную.
Инициализируйте переменную и добавьте динамическое значение Текст из действия Распознавание текста на изображении или в документе PDF в этой переменной.
Завершите поток , выполнив следующие действия:
В своем потоке выберите Создать текст с помощью GPT, используя запрос.
На вкладке Параметры в поле Запрос выберите запрос с JSON для выбора формата выходных данных.
Добавьте переменную накладной, которую вы создали, в строку входных данных запроса.
Следующая процедура позволяет легко и безопасно использовать несколько значений, извлеченных из текста с помощью запроса.
В своем потоке выберите Отправить электронное письмо.
На вкладке Параметры отправьте электронное письмо, содержащее элементы, извлеченные с помощью запроса, с выводом в формате JSON.
Вопросы и ответы
Не удалось сформировать JSON
При тестировании запроса может возникнуть следующая ошибка: Не удалось создать JSON. Отредактируйте инструкцию запроса и повторите попытку.
Эта ошибка может быть связана с тем, что модель заключает выходные данные JSON в сведения о метаданных, что препятствует успешной проверке требуемого формата JSON. Попробуйте добавить следующую инструкцию в запрос, чтобы решить проблему: Показать выходные данные в формате JSON.
В режиме автоматического обнаружения JSON не возвращается.
Возможно, после выбора Тестового запроса с активированным режимом автоматического обнаружения JSON не возвращается. Возможно, это связано с тем, что инструкции запроса противоречат системным инструкциям по возврату JSON. Эту проблему можно решить, изменив инструкцию запроса и повторив проверку.
Формат JSON не обновляется во время выполнения запроса.
Последний формат JSON, обнаруженный в режиме автоматического обнаружения, или последний формат JSON, определенный в пользовательском режиме, записывается во время сохранения запроса. Этот записанный формат JSON применяется во время выполнения запроса, обеспечивая согласованность формата ответа даже при изменении динамических входных данных в запросе.
Ограничения
Вы не можете изменить схему JSON.
Мы не поддерживаем определение формата JSON без ключей полей.
Пример: ["abc", "def"] не поддерживается, но [{"Field1": "abc"}, {"Field1": "def"}] поддерживается.