Вызов приложений логики Azure в качестве функций с помощью Помощников по Azure OpenAI

Статья
05/22/2024

Примечание.

Сейчас эта функция доступна только в Azure OpenAI Studio.

Azure Logic Apps — это платформа интеграции в Azure, которая позволяет создавать приложения и рабочие процессы автоматизации с низкой производительностью кода и ускорить работу разработчиков на рынке. С помощью визуального конструктора и выбора из сотен предварительно созданных соединителей можно быстро создать рабочий процесс, который интегрирует приложения, данные, службы и системы.

Служба Azure Logic Apps полностью управляется Microsoft Azure, что позволяет избежать дополнительных проблем, связанных с размещением, масштабированием, мониторингом, поддержкой решений, созданных с помощью этой службы, и управлением ими. При использовании этих возможностей для создания бессерверных приложений и решений можно просто сосредоточиться на бизнес-логике и функциональности. Эти службы автоматически масштабируется в соответствии с вашими потребностями, упрощают рабочие процессы автоматизации и помогают создавать надежные облачные приложения, использующие мало кода.

Функция, вызываемая в Azure Logic Apps с помощью игровой площадки Помощников

Чтобы ускорить и упростить создание интеллектуальных приложений, теперь мы можем вызывать рабочие процессы Logic Apps с помощью вызова функций в Помощниках Azure OpenAI.

На игровой площадке Помощников перечисляются и перечисляются все рабочие процессы в подписке, доступные для вызова функций. Ниже приведены требования для этих рабочих процессов:

Приложения логики потребления: в настоящее время мы поддерживаем только рабочие процессы потребления.
Триггер запроса. Для вызова функции требуется REST API. Logic Apps с триггером запроса предоставляет конечную точку REST. Поэтому для вызова функций поддерживаются только рабочие процессы с триггером запроса.
Схема. Рабочие процессы, которые необходимо использовать для вызова функций, должны иметь схему JSON, описывающую входные и ожидаемые выходные данные. С помощью Logic Apps можно упростить и указать схему в триггере, которая будет автоматически импортирована в качестве определения функции.

Если у вас уже есть рабочие процессы с тремя требованиями, вы сможете использовать их в Azure OpenAI Studio и вызывать их с помощью запросов пользователей. Если у вас нет существующих рабочих процессов, выполните действия, описанные в этой статье, чтобы создать их. Существует два основных шага.

Создайте приложение логики в портал Azure.
Импорт рабочих процессов Logic Apps в качестве функции на игровой площадке Помощников.

Создание рабочих процессов Logic Apps для вызова функций

Ниже приведены шаги по созданию нового рабочего процесса Logic Apps для вызова функций.

В поле поиска портал Azure введите приложения логики и выберите приложения логики.
На панели инструментов страницы "Приложения логики" нажмите кнопку "Добавить".
На странице "Создание приложения логики" сначала выберите тип плана для ресурса приложения логики. Таким образом отображаются только параметры этого типа плана.
В разделе "План" для типа "План" выберите "Потребление", чтобы просмотреть только параметры ресурса приложения логики потребления.
Укажите следующие сведения для ресурса приложения логики: подписка, группа ресурсов, имя приложения логики и регион.
Когда все будет готово, выберите Просмотр и создание.
На появиющейся странице проверки подтвердите все предоставленные сведения и нажмите кнопку "Создать".
После успешного развертывания ресурса приложения логики Azure выберите "Перейти к ресурсу". Вы также можете найти и выбрать ресурс приложения логики, введя его имя в поле поиска Azure.
Откройте рабочий процесс Logic Apps в конструкторе. Выберите конструктор приложений разработки и логики. Откроется пустой рабочий процесс в конструкторе. Или выбрать пустое приложение логики из шаблонов
Теперь вы готовы добавить еще один шаг в рабочий процесс. Рабочий процесс всегда начинается с одного триггера, который указывает условие, которое должно соответствовать перед выполнением последующих действий в рабочем процессе.
Рабочий процесс должен иметь триггер запроса для создания конечной точки REST и действия ответа, чтобы вернуть ответ в Azure OpenAI Studio при вызове этого рабочего процесса.
Добавление триггера (запрос)

Выберите " Добавить триггер ", а затем найдите триггер запроса. Выберите операцию получения HTTP-запроса.

Укажите схему JSON для запроса. Если у вас нет схемы, используйте параметр для создания схемы.

Ниже приведен пример схемы запроса. В поле комментариев можно добавить описание рабочего процесса. Это импортируется в Azure OpenAI Studio в качестве описания функции.

Сохраните рабочий процесс. Это создаст конечную точку REST для рабочего процесса.
В зависимости от варианта использования бизнеса теперь можно добавить один или несколько шагов или действий в этом рабочем процессе. Например, с помощью соединителя погоды MSN для получения прогноза погоды для текущего расположения.

В действии для получения прогноза на сегодняшний день мы используем свойство расположения, переданное этому рабочему процессу в качестве входных данных.
Настройте ответ. Рабочий процесс должен вернуть ответ в Azure OpenAI Studio. Это выполняется с помощью действия ответа.

В действии ответа можно выбрать выходные данные из любого из предыдущих шагов. Кроме того, можно указать схему JSON, если вы хотите вернуть выходные данные в определенном формате.
Рабочий процесс теперь готов. В Azure OpenAI Studio эту функцию можно импортировать с помощью функции "Добавить " на игровой площадке Помощников.

Импорт рабочих процессов Logic Apps в качестве функций

Ниже приведены шаги по импорту рабочих процессов Logic Apps в качестве функции на игровой площадке Помощников в Azure OpenAI Studio:

В Azure OpenAI Studio выберите Помощники. Выберите существующего помощника или создайте новую. После настройки помощник с именем и инструкциями можно добавить функцию. Выберите и добавьте функцию.
Параметр "Добавить функцию" открывает экран с двумя вкладками. Перейдите на вкладку Logic Apps, чтобы просмотреть рабочие процессы с помощью триггера запроса. Выберите рабочий процесс из списка и нажмите кнопку "Сохранить".

Примечание.

В этом списке показаны только рабочие процессы SKU потребления и триггер запроса.

Теперь рабочий процесс успешно импортирован и готов к вызову. Спецификация функции создается на основе рабочего процесса приложений логики swagger и включает схему и описание на основе того, что вы настроили в действии триггера запроса.

Рабочий процесс теперь будет вызываться помощниками Azure OpenAI на основе запроса пользователя. Ниже приведен пример, в котором рабочий процесс вызывается автоматически на основе запроса пользователя, чтобы получить погоду.

Вы можете подтвердить вызов, просмотрев журналы, а также журнал выполнения рабочего процесса.

Вопросы и ответы

Что такое соединитель приложений логики?

Azure Logic Apps содержит соединители для сотен бизнес-приложений и баз данных, включая, но не только SAP, Salesforce, Oracle, SQL и многое другое. Вы также можете подключиться к приложениям SaaS или вашим приложениям, размещенным в виртуальных сетях. Эти встроенные соединители предоставляют операции для отправки и получения данных в нескольких форматах. Используя эти возможности с помощью помощник Azure OpenAI, вы сможете быстро перенести данные для интеллектуальной Аналитика с помощью Azure OpenAI.

Что происходит при импорте Logic Apps в Azure OpenAI Studio и вызове

Файл swagger Logic Apps используется для заполнения определений функций. Приложение логики Azure публикует определение OpenAPI 2.0 (swagger) для рабочих процессов с триггером запроса на основе заметок рабочего процесса. Пользователи могут изменить содержимое этого swagger, обновив рабочий процесс. Azure OpenAI Studio использует это для создания определений функций, необходимых помощнику.

Как работает проверка подлинности из Azure OpenAI Studio в Logic Apps?

Logic Apps поддерживает два основных типа проверки подлинности для вызова триггера запроса.

Проверка подлинности на основе подписанного URL-адреса (SAS).

Пользователи могут получить URL-адрес обратного вызова, содержащий SAS, с помощью API ОБРАТНОго вызова списка. Logic Apps также поддерживает использование нескольких ключей и их поворот по мере необходимости. Logic Apps также поддерживает создание URL-адресов SAS с указанным сроком действия. Дополнительные сведения см. в документации по Logic Apps.
Базовая политика проверки подлинности OAuth на основе идентификатора Microsoft Entra.

Logic Apps также поддерживает вызовы триггеров проверки подлинности с помощью OAuth идентификатора Microsoft Entra ID, где можно указать политики проверки подлинности для проверки маркеров OAuth. Дополнительные сведения см. в документации по Logic Apps.

Если помощники Azure OpenAI требуют вызова приложения логики в рамках вызова функции, Azure OpenAI Studio получит URL-адрес обратного вызова с SAS для вызова рабочего процесса.

См. также

Дополнительные сведения о помощниках

Поделиться через