Wywoływanie aplikacji logiki platformy Azure jako funkcji przy użyciu asystentów usługi Azure OpenAI
Uwaga
Ta funkcja jest obecnie dostępna tylko w programie Azure OpenAI Studio.
Azure Logic Apps to platforma integracji na platformie Azure, która umożliwia tworzenie aplikacji i przepływów pracy automatyzacji z niskimi narzędziami kodu umożliwiającymi produktywność deweloperów i krótszy czas obrotu. Korzystając z projektanta wizualnego i wybierając spośród setek wstępnie utworzonych łączników, możesz szybko utworzyć przepływ pracy integrujący aplikacje, dane, usługi i systemy oraz zarządzać nimi.
Usługa Azure Logic Apps jest w pełni zarządzana przez platformę Microsoft Azure, co pozwala martwić się o hosting, skalowanie, zarządzanie, monitorowanie i konserwowanie rozwiązań utworzonych za pomocą tych usług. Korzystając z tych funkcji do tworzenia aplikacji i rozwiązań bezserwerowych , możesz po prostu skupić się na logice biznesowej i funkcjach. Te usługi są automatycznie skalowane zgodnie z potrzebami, przyspieszają przepływy pracy automatyzacji i ułatwiają tworzenie niezawodnych aplikacji w chmurze przy użyciu niewielkiej ilości kodu.
Wywoływanie funkcji w usłudze Azure Logic Apps za pośrednictwem placu zabaw dla asystentów
Aby przyspieszyć i uprościć tworzenie inteligentnych aplikacji, teraz umożliwiamy wywoływanie przepływów pracy usługi Logic Apps za pomocą wywołania funkcji w asystentach usługi Azure OpenAI.
Asystentzy wyliczają i wyświetla listę wszystkich przepływów pracy w subskrypcji, które kwalifikują się do wywoływania funkcji. Poniżej przedstawiono wymagania dotyczące tych przepływów pracy:
- Zużycie usługi Logic Apps: obecnie obsługujemy tylko przepływy pracy zużycia.
- Wyzwalacz żądania: wywołanie funkcji wymaga interfejsu API opartego na protokole REST. Usługa Logic Apps z wyzwalaczem żądania udostępnia punkt końcowy REST. W związku z tym tylko przepływy pracy z wyzwalaczem żądania są obsługiwane w zakresie wywoływania funkcji.
- Schemat: przepływy pracy, które mają być używane do wywoływania funkcji, powinny mieć schemat JSON opisujący dane wejściowe i oczekiwane dane wyjściowe. Za pomocą usługi Logic Apps można usprawnić i udostępnić schemat w wyzwalaczu, który zostanie automatycznie zaimportowany jako definicja funkcji.
Jeśli masz już przepływy pracy z powyższymi trzema wymaganiami, powinno być możliwe ich użycie w usłudze Azure OpenAI Studio i wywoływanie ich za pomocą poleceń użytkownika. Jeśli nie masz istniejących przepływów pracy, możesz wykonać kroki opisane w tym artykule, aby je utworzyć. Istnieją dwa podstawowe kroki:
- Tworzenie aplikacji logiki w witrynie Azure Portal.
- Zaimportuj przepływy pracy usługi Logic Apps jako funkcję na placu zabaw Asystentów.
Tworzenie przepływów pracy usługi Logic Apps na potrzeby wywoływania funkcji
Poniżej przedstawiono kroki tworzenia nowego przepływu pracy usługi Logic Apps na potrzeby wywoływania funkcji.
W polu wyszukiwania w witrynie Azure Portal wprowadź aplikacje logiki i wybierz pozycję Aplikacje logiki.
Na pasku narzędzi strony Aplikacje logiki wybierz pozycję Dodaj.
Na stronie Tworzenie aplikacji logiki najpierw wybierz typ planu dla zasobu aplikacji logiki. W ten sposób są wyświetlane tylko opcje dla tego typu planu.
W sekcji Plan w polu Typ planu wybierz pozycję Zużycie , aby wyświetlić tylko ustawienia zasobów aplikacji logiki zużycie.
Podaj następujące informacje dotyczące zasobu aplikacji logiki: Subskrypcja, Grupa zasobów, Nazwa aplikacji logiki i Region.
Gdy wszystko będzie gotowe, wybierz pozycję Przejrzyj i utwórz.
Na wyświetlonej stronie weryfikacji potwierdź wszystkie podane informacje i wybierz pozycję Utwórz.
Po pomyślnym wdrożeniu zasobu aplikacji logiki na platformie Azure wybierz pozycję Przejdź do zasobu. Możesz też znaleźć i wybrać zasób aplikacji logiki, wpisując nazwę w polu wyszukiwania platformy Azure.
Otwórz przepływ pracy usługi Logic Apps w projektancie. Wybierz pozycję Narzędzia programistyczne i projektant aplikacji logiki. Spowoduje to otwarcie pustego przepływu pracy w projektancie. Możesz też wybrać pozycję Pusta aplikacja logiki z szablonów
Teraz możesz dodać jeszcze jeden krok w przepływie pracy. Przepływ pracy zawsze rozpoczyna się od jednego wyzwalacza, który określa warunek, który ma być spełniony przed uruchomieniem wszelkich kolejnych akcji w przepływie pracy.
Przepływ pracy musi mieć wyzwalacz Żądania w celu wygenerowania punktu końcowego REST oraz akcję odpowiedzi, aby zwrócić odpowiedź do programu Azure OpenAI Studio po wywołaniu tego przepływu pracy.
Dodawanie wyzwalacza (żądanie)
Wybierz pozycję Dodaj wyzwalacz , a następnie wyszukaj wyzwalacz żądania. Wybierz operację Po odebraniu żądania HTTP.
Podaj schemat JSON dla żądania. Jeśli nie masz schematu, użyj opcji do wygenerowania schematu.
Oto przykład schematu żądania. Możesz dodać opis przepływu pracy w polu komentarza. Jest to importowane przez program Azure OpenAI Studio jako opis funkcji.
Zapisz przepływ pracy. Spowoduje to wygenerowanie punktu końcowego REST dla przepływu pracy.
W zależności od przypadku użycia biznesowego można teraz dodać co najmniej jeden krok/akcje w tym przepływie pracy. Na przykład użyj łącznika pogody MSN, aby uzyskać prognozę pogody dla bieżącej lokalizacji.
W akcji , aby uzyskać prognozę dla dzisiaj, używamy właściwości lokalizacji , która została przekazana do tego przepływu pracy jako dane wejściowe.
Skonfiguruj odpowiedź. Przepływ pracy musi zwrócić odpowiedź z powrotem do programu Azure OpenAI Studio. Odbywa się to przy użyciu akcji Odpowiedź.
W akcji odpowiedzi możesz wybrać dane wyjściowe z dowolnego z poprzednich kroków. Opcjonalnie możesz również podać schemat JSON, jeśli chcesz zwrócić dane wyjściowe w określonym formacie.
Przepływ pracy jest teraz gotowy. W programie Azure OpenAI Studio możesz zaimportować tę funkcję przy użyciu funkcji Dodaj funkcję na placu zabaw Asystentów.
Importowanie przepływów pracy usługi Logic Apps jako funkcji
Poniżej przedstawiono kroki importowania przepływów pracy usługi Logic Apps jako funkcji na placu zabaw Asystentów w programie Azure OpenAI Studio:
W usłudze Azure OpenAI Studio wybierz pozycję Asystenci. Wybierz istniejącego Asystenta lub utwórz nowy. Po skonfigurowaniu asystenta z nazwą i instrukcjami możesz przystąpić do dodawania funkcji. Wybierz pozycję + Dodaj funkcję.
Opcja Dodaj funkcję otwiera ekran z dwiema kartami. Przejdź do karty usługi Logic Apps, aby przeglądać przepływy pracy za pomocą wyzwalacza żądania. Wybierz przepływ pracy z listy i wybierz pozycję Zapisz.
Uwaga
Ta lista zawiera tylko przepływy pracy jednostek SKU użycia i wyzwalacz żądania.
Przepływ pracy został pomyślnie zaimportowany i jest gotowy do wywołania. Specyfikacja funkcji jest generowana na podstawie struktury swagger przepływu pracy aplikacji logiki i zawiera schemat i opis na podstawie tego, co zostało skonfigurowane w akcji wyzwalacza żądania.
Przepływ pracy będzie teraz wywoływany przez asystentów usługi Azure OpenAI na podstawie monitu użytkownika. Poniżej przedstawiono przykład, w którym przepływ pracy jest wywoływany automatycznie na podstawie monitu użytkownika o uzyskanie pogody.
Wywołanie można potwierdzić, przeglądając dzienniki, a także historię uruchamiania przepływu pracy.
Często zadawane pytania
Co to są Łącznik aplikacji logiki?
Usługa Azure Logic Apps ma łączniki do setek aplikacji biznesowych i baz danych, w tym między innymi systemów SAP, Salesforce, Oracle, SQL i innych. Możesz również nawiązać połączenie z aplikacjami SaaS lub własnymi aplikacjami hostowanymi w sieciach wirtualnych. Te gotowe łączniki zapewniają operacje wysyłania i odbierania danych w wielu formatach. Korzystając z tych funkcji za pomocą asystentów usługi Azure OpenAI, powinno być możliwe szybkie przenoszenie danych do usługi Intelligent Insights obsługiwanej przez usługę Azure OpenAI.
Co się stanie po zaimportowaniu usługi Logic Apps w programie Azure OpenAI Studio i wywołaniu
Plik swagger usługi Logic Apps służy do wypełniania definicji funkcji. Aplikacja logiki platformy Azure publikuje definicję interfejsu OpenAPI 2.0 (swagger) dla przepływów pracy z wyzwalaczem żądania na podstawie adnotacji w przepływie pracy. Użytkownicy mogą modyfikować zawartość tego programu Swagger, aktualizując przepływ pracy. Program Azure OpenAI Studio używa tej funkcji do generowania definicji funkcji, których wymaga Asystent.
Jak działa uwierzytelnianie z usługi Azure OpenAI Studio do usługi Logic Apps?
Usługa Logic Apps obsługuje dwa podstawowe typy uwierzytelniania w celu wywołania wyzwalacza żądania.
Uwierzytelnianie oparte na sygnaturze dostępu współdzielonego (SAS).
Użytkownicy mogą uzyskać adres URL wywołania zwrotnego zawierającego sygnaturę dostępu współdzielonego przy użyciu interfejsu API adresu URL wywołania zwrotnego listy. Usługa Logic Apps obsługuje również używanie wielu kluczy i obracanie ich zgodnie z potrzebami. Usługa Logic Apps obsługuje również tworzenie adresów URL sygnatur dostępu współdzielonego z określonym okresem ważności. Aby uzyskać więcej informacji, zobacz dokumentację usługi Logic Apps.
Zasady uwierzytelniania podstawowego opartego na identyfikatorze OAuth firmy Microsoft.
Usługa Logic Apps obsługuje również wywołania wyzwalacza uwierzytelniania za pomocą protokołu OAuth identyfikatora entra firmy Microsoft, w którym można określić zasady uwierzytelniania, które mają być używane podczas walidacji tokenów OAuth. Aby uzyskać więcej informacji, zobacz dokumentację usługi Logic Apps.
Gdy asystenci usługi Azure OpenAI wymagają wywołania aplikacji logiki w ramach wywoływania funkcji, program Azure OpenAI Studio pobierze adres URL wywołania zwrotnego z sygnaturą dostępu współdzielonego w celu wywołania przepływu pracy.