Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Dotyczy: Azure Logic Apps (Consumption + Standard)
Aby zintegrować usługi, systemy i dane przedsiębiorstwa z technologiami sztucznej inteligencji, przepływy pracy aplikacji logiki mogą łączyć się z zasobami azure OpenAI i Azure AI Search używanymi w tych scenariuszach integracji.
Ten przewodnik zawiera omówienie i przykłady pokazujące, jak używać operacji łącznika Azure OpenAI i Azure AI Search w przepływie pracy.
Dlaczego warto używać usługi Azure Logic Apps z usługami sztucznej inteligencji?
Zazwyczaj tworzenie rozwiązań sztucznej inteligencji obejmuje kilka kluczowych kroków i wymaga kilku bloków konstrukcyjnych. Przede wszystkim musisz mieć dynamiczny potok przetwarzania danych i interfejs czatu, który może komunikować się z dużymi modelami językowymi (LLMs) i bazami danych wektorowymi.
Napiwek
Aby dowiedzieć się więcej, możesz zadać następujące pytania dotyczące platformy Azure Copilot:
- Co to jest dynamiczny potok pozyskiwania danych w sztucznej inteligencji?
- Co to jest wektorowa baza danych w sztucznej inteligencji?
Aby znaleźć narzędzie Azure Copilot, na pasku narzędzi witryny Azure Portal wybierz pozycję Copilot.
Można tworzyć różne składniki, nie tylko do wykonywania pozyskiwania danych, ale także w celu zapewnienia niezawodnego zaplecza dla interfejsu czatu. To zaplecze ułatwia wprowadzanie monitów i generowanie zależnych odpowiedzi podczas interakcji. Jednak utworzenie kodu do zarządzania wszystkimi tymi elementami i kontrolowania ich może stanowić wyzwanie, co jest możliwe w przypadku większości rozwiązań.
Usługa Azure Logic Apps oferuje niskie podejście do kodu i upraszcza zarządzanie zapleczem, udostępniając wstępnie utworzone łączniki, których używasz jako bloków konstrukcyjnych w celu usprawnienia procesu zaplecza. Takie podejście pozwala skupić się na określaniu źródła danych i upewnieniu się, że wyniki wyszukiwania zawierają bieżące i istotne informacje. Dzięki tym łącznikom sztucznej inteligencji przepływ pracy działa jako aparat aranżacji, który przesyła dane między usługami sztucznej inteligencji a innymi składnikami, które chcesz zintegrować.
Aby uzyskać więcej informacji, zobacz następujące zasoby:
Wymagania wstępne
Konto i subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, zarejestruj się w celu założenia bezpłatnego konta platformy Azure.
Zasoby usługi Azure AI Search i Azure OpenAI, do których można uzyskać dostęp i używać w swoim przepływie pracy, w tym informacje o połączeniu:
Przepływ pracy aplikacji logiki, w którym chcesz uzyskać dostęp do zasobów Azure OpenAI i Azure AI Search.
Łączniki dla tych usług obecnie udostępniają tylko akcje, a nie wyzwalacze. Przed dodaniem akcji łącznika Azure AI upewnij się, że przepływ pracy rozpoczyna się od odpowiedniego wyzwalacza dla scenariusza.
Dokumentacja techniczna łącznika
W poniższych sekcjach opisano artykuły referencyjne łącznika opisujące parametry połączenia i parametry operacji dla każdego łącznika. Jeśli jakiekolwiek operacje w tych łącznikach zawierają etykietę "Wersja zapoznawcza", są one obecnie dostępne w wersji zapoznawczej i podlegają dodatkowym warunkom użytkowania dla wersji zapoznawczych platformy Microsoft Azure.
Azure OpenAI
Usługa Azure OpenAI Service zapewnia dostęp do modeli językowych OpenAI, na przykład GPT-5, GPT-4, GPT-4 Turbo z Vision, GPT-3.5-Turbo i serii modeli Embeddings. Za pomocą łącznika Azure OpenAI przepływ pracy może łączyć się z usługą Azure OpenAI Service i pobierać OpenAI osadzenia dla danych lub generować uzupełnienia czatów.
Łącznik Azure OpenAI ma różne wersje, oparte na typie aplikacji logicznej i modelu hostingu.
| Aplikacja logiki | Środowisko | Wersja łącznika |
|---|---|---|
| Zużycie | Wielodostępna usługa Azure Logic Apps | Zarządzany łącznik hostowany na platformie Azure, który jest wyświetlany w galerii łączników pod filtrem Udostępnione. Aby uzyskać więcej informacji, zobacz odniesienie do zarządzanego łącznika Azure OpenAI. |
| Norma | Usługa Azure Logic Apps z pojedynczym dzierżawcą, środowisko App Service Environment w wersji 3 (tylko plany Windows) lub wdrożenie hybrydowe, stanowiące własną infrastrukturę. | Wbudowany łącznik, który jest wyświetlany w galerii łączników pod filtrem Wbudowane i jest bazujący na dostawcy usług. Wbudowany łącznik ma między innymi następujące możliwości: - Obsługa wielu typów uwierzytelniania — Bezpośredni dostęp do zasobów w sieciach wirtualnych i punktach końcowych platformy Azure dla usługi Azure OpenAI za zaporami. Aby uzyskać więcej informacji, zobacz Dokumentacja wbudowanego łącznika usługi Azure OpenAI. |
Napiwek
Aby dowiedzieć się więcej, możesz zadać następujące pytania dotyczące platformy Azure Copilot:
- Co to jest osadzanie w sztucznej inteligencji?
- Co to jest ukończenie czatu w sztucznej inteligencji?
Aby znaleźć narzędzie Azure Copilot, na pasku narzędzi witryny Azure Portal wybierz pozycję Copilot.
Wyszukiwanie AI platformy Azure
Azure AI Search to platforma do pobierania informacji opartych na sztucznej inteligencji, która ułatwia deweloperom tworzenie zaawansowanych środowisk wyszukiwania i generowanie aplikacji sztucznej inteligencji dzięki połączeniu dużych modeli językowych z danymi przedsiębiorstwa. Za pomocą łącznika usługi Azure AI Search przepływ pracy może łączyć się z usługą Azure AI Search w celu indeksowania dokumentów i przeszukiwania wektorów danych.
Łącznik Azure AI Search ma różne wersje, oparte na typie aplikacji Logic Apps i modelu hostingowym.
| Aplikacja logiki | Środowisko | Wersja łącznika |
|---|---|---|
| Zużycie | Wielodostępna usługa Azure Logic Apps | Zarządzany łącznik hostowany na platformie Azure, który jest wyświetlany w galerii łączników pod filtrem Udostępnione. Aby uzyskać więcej informacji, zobacz Referencje łącznika zarządzanego usługi Azure AI Search. |
| Norma | Usługa Azure Logic Apps z pojedynczym dzierżawcą, środowisko App Service Environment w wersji 3 (tylko plany Windows) lub wdrożenie hybrydowe, stanowiące własną infrastrukturę. | Wbudowany łącznik, który jest wyświetlany w galerii łączników pod filtrem Wbudowane i jest bazujący na dostawcy usług. Wbudowany łącznik ma między innymi następujące możliwości: - Obsługa wielu typów uwierzytelniania — Bezpośredni dostęp do zasobów w sieciach wirtualnych i punktach końcowych platformy Azure dla usługi Azure OpenAI za zaporami. Aby uzyskać więcej informacji, zobacz Referencja wbudowanego łącznika usługi Azure AI Search. |
Uwierzytelnianie
Łączniki zarządzane przez sztuczną inteligencję wymagają klucza interfejsu API do uwierzytelniania. Jednak wbudowane łączniki sztucznej inteligencji obsługują wiele typów uwierzytelniania dla punktu końcowego usługi sztucznej inteligencji. Te opcje zapewniają niezawodne uwierzytelnianie spełniające większość potrzeb klientów. Oba wbudowane łączniki mogą również łączyć się bezpośrednio z zasobami usługi Azure OpenAI i Azure AI Search w sieciach wirtualnych lub za zaporami.
W poniższej tabeli opisano wbudowane opcje uwierzytelniania łącznika, które wymagają podania adresu URL punktu końcowego usługi sztucznej inteligencji:
| Typ uwierzytelniania | opis |
|---|---|
| Uwierzytelnianie oparte na adresach URL i kluczach | Podaj klucz API lub klucz wygenerowany przez administratora usługi sztucznej inteligencji. |
| Active Directory OAuth (Microsoft Entra ID) | Podaj informacje, takie jak dzierżawa Entra, identyfikator klienta i hasło, aby się uwierzytelnić jako użytkownik Entra. |
| Tożsamość zarządzana | Po skonfigurowaniu uwierzytelniania tożsamości zarządzanej w zasobie usługi sztucznej inteligencji i zasobie aplikacji logicznej, można użyć tej tożsamości do uwierzytelniania dostępu dla tego łącznika. |
Ostrzeżenie
Zawsze zabezpieczaj i chronij poufne i osobiste dane, takie jak poświadczenia, wpisy tajne, klucze dostępu, parametry połączenia, certyfikaty, odciski palca i podobne informacje o najwyższym dostępnym lub obsługiwanym poziomie zabezpieczeń.
W przypadku uwierzytelniania i autoryzacji skonfiguruj lub użyj identyfikatora Entra firmy Microsoft z tożsamością zarządzaną. To rozwiązanie zapewnia optymalne i doskonałe zabezpieczenia bez konieczności ręcznego udostępniania poświadczeń, wpisów tajnych, kluczy dostępu itd., ponieważ platforma Azure obsługuje tożsamość zarządzaną. Aby skonfigurować tożsamość zarządzaną dla usługi Azure Logic Apps, zobacz Uwierzytelnianie dostępu i połączeń z zasobami platformy Azure przy użyciu tożsamości zarządzanych w usłudze Azure Logic Apps.
Jeśli nie możesz użyć tożsamości zarządzanej, wybierz dostępne następne rozwiązanie zabezpieczeń najwyższego poziomu. Jeśli na przykład musisz użyć parametrów połączenia, które zawierają informacje wymagane do uzyskania dostępu do zasobu, usługi lub systemu, pamiętaj, że te parametry zawierają klucz dostępu podobny do hasła głównego.
Upewnij się, że te informacje są bezpiecznie przechowywane przy użyciu identyfikatora Entra firmy Microsoft i usługi Azure Key Vault. Nie koduj tych informacji na stałe, udostępniaj innym użytkownikom ani nie zapisuj ich w zwykły tekst w dowolnym miejscu, do którego inni mogą uzyskiwać dostęp. Skonfiguruj plan rotacji lub unieważniania tajemnic w przypadku ich kompromitacji. Aby uzyskać więcej informacji, zobacz następujące zasoby:
Aby uzyskać więcej informacji, zobacz następujące zasoby:
- Uwierzytelnianie żądań w usługach Azure AI
- Co to jest Microsoft Entra ID
- Co to są tożsamości zarządzane dla zasobów platformy Azure
- Uwierzytelnianie dostępu i połączeń z zasobami platformy Azure przy użyciu tożsamości zarządzanych w usłudze Azure Logic Apps
Dodawanie akcji azure OpenAI lub Azure AI Search do przepływu pracy
Obecnie łączniki dla usług Azure OpenAI i Azure AI Search udostępniają tylko akcje, a nie wyzwalacze. Możesz uruchomić przepływ pracy przy użyciu dowolnego wyzwalacza, który odpowiada Twojemu scenariuszowi lub potrzebom. W zależności od tego, czy masz przepływ pracy Zużycie, czy Standardowy, możesz wykonać następujące ogólne kroki, aby dodać akcje dla usług Azure OpenAI, Azure AI Search i innych operacji.
Scenariusze
W następujących scenariuszach opisano tylko dwa z wielu sposobów używania operacji łącznika sztucznej inteligencji w przepływach pracy:
Utwórz bazę wiedzy dla danych przedsiębiorstwa
Usługa Azure Logic Apps udostępnia ponad 1400 łączników zarządzanych przez firmę Microsoft i natywnie uruchomionych wbudowanych łączników dla przepływu pracy w celu bezpiecznego łączenia się z niemal dowolnym źródłem danych, takim jak SharePoint, Oracle DB, Salesforce, OneDrive, Dropbox, SAP, IBM itd. Każdy łącznik udostępnia operacje, które obejmują wyzwalacze, akcje lub oba te elementy, których można używać w przepływie pracy.
Można na przykład wybrać spośród wielu typów wyzwalaczy, aby zautomatyzowany przepływ pracy był uruchamiany zgodnie z harmonogramem lub na podstawie określonych zdarzeń, takich jak przekazywanie nowych dokumentów do witryny programu SharePoint. Dzięki wielu operacjom, które możesz wybrać, możesz utworzyć bazę wiedzy i łatwo stworzyć potok pozyskiwania dokumentów przy użyciu osadzania wektorowego dla tych dokumentów w Azure AI Search.
Aby uzyskać więcej informacji, zobacz następujące zasoby:
Generuj uzupełnienia
Przepływ pracy usługi Azure Logic Apps może akceptować dane wejściowe, a usługa Azure OpenAI może wykonywać operacje uzupełniania. Te możliwości oznaczają, że przepływ pracy może pozyskiwać pytania w czasie rzeczywistym, generować odpowiedzi dotyczące danych lub wysyłać automatyczne odpowiedzi przy użyciu usługi Azure OpenAI. Możesz natychmiast wysłać odpowiedzi z powrotem do klienta lub do procesu zatwierdzania w celu weryfikacji.
Aby uzyskać więcej informacji, zobacz następujące zasoby:
Przykładowy scenariusz z przykładowym kodem: pozyskiwanie danych i tworzenie interakcji z czatem
W tym przykładowym standardowym przepływie pracy pokazano, jak używać wbudowanych łączników usług Azure OpenAI i Azure AI Search, aby podzielić logikę zaplecza na pozyskiwanie danych i prowadzenie prostych konwersacji na czacie w dwóch kluczowych przepływach pracy. Aby osiągnąć większą wydajność, utwórz bezstanowe przepływy pracy, które domyślnie nie zapisują i nie przechowują historii dla każdego uruchomienia.
Przykładowy kod
Tworzenie czatu przy użyciu pozyskanych danych
Inne wymagania wstępne
Przepływ pracy standardowej aplikacji logiki
Zobacz przykładowe wymagania dotyczące kodu.
Następujące wartości parametrów środowiska krzyżowego są również używane przez operacje przepływu pracy w tym przykładzie:
Nazwa parametru opis aisearch_admin_key Klucz administracyjny usługi Azure AI Search aisearch_endpoint Adres URL punktu końcowego dla przykładu usługi Azure AI Search aisearch_index_name Indeks do użycia dla przykładu usługi Azure AI Search openapi_api_key Klucz interfejsu API dla usługi Azure OpenAI openai_deployment_id Identyfikator wdrożenia dla przykładu usługi Azure OpenAI openai_endpoint Adres URL punktu końcowego dla przykładu usługi Azure OpenAI tokenize_function_url Adres URL niestandardowej funkcji platformy Azure, która wsaduje i tokenizuje dane, co jest wymagane, aby usługa Azure OpenAI prawidłowo utworzyła osadzanie w tym przykładzie.
Aby uzyskać więcej informacji na temat tej funkcji, zobacz przykładowy kod "Tworzenie czatu przy użyciu pozyskanych danych".
Wideo: Dowiedz się, jak tworzyć aplikacje sztucznej inteligencji przy użyciu aplikacji logiki
Dowiedz się, jak tworzyć aplikacje sztucznej inteligencji przy użyciu aplikacji logiki
Pozyskiwanie przepływu pracy danych
Aby zaoszczędzić dużo czasu i nakładu pracy podczas tworzenia potoku pozyskiwania, zaimplementuj następujący wzorzec z dowolnym źródłem danych. Ten wzorzec zawiera wszystkie zalety i korzyści oferowane obecnie przez przepływy pracy Standard w pojedynczej dzierżawie usługi Azure Logic Apps.
Każdy krok w tym wzorcu zapewnia, że sztuczna inteligencja bezproblemowo wyodrębnia wszystkie kluczowe informacje z plików danych. Jeśli jest uruchamiany jako bezstanowy przepływ pracy, ten wzorzec zapewnia również szybszą wydajność. Takie podejście upraszcza nie tylko aspekt kodowania, ale także gwarantuje, że przepływy pracy mają skuteczne procesy uwierzytelniania, monitorowania i wdrażania.
| Krok | Zadanie | Operacja bazowa | opis |
|---|---|---|---|
| 1 | Sprawdź, czy nie ma nowych danych. | Po odebraniu żądania HTTP | Wyzwalacz, który sprawdza lub czeka na nadejście nowych danych w oparciu o zaplanowany harmonogram lub w odpowiedzi na określone zdarzenia. Takie zdarzenie może być nowym plikiem załadowanym do określonego systemu przechowywania, takiego jak SharePoint, OneDrive lub Azure Blob Storage. W tym przykładzie operacja wyzwalacza żądania czeka na żądanie HTTP lub HTTPS wysłane z innego punktu końcowego. Żądanie zawiera adres URL nowego przekazanego dokumentu. |
| 2 | Pobierz dane. | Protokół HTTP | Akcja HTTP , która pobiera przekazany dokument przy użyciu adresu URL pliku z danych wyjściowych wyzwalacza. |
| 3 | Utwórz szczegóły dokumentu. | Redaguj | Akcja Operacja danych, która łączy różne elementy. Ten przykład łącze informacje w formacie klucz-wartość dotyczące dokumentu. |
| 4 | Utwórz ciąg tokenu. | Analizowanie dokumentu | Akcja Operacje na danych, która tworzy ciąg znaków tokenu przy użyciu danych wyjściowych z akcji Skomponuj. |
| 5 | Tworzenie fragmentów zawartości. | Tekst fragmentu | Akcja operacji na danych dzieląca ciąg tokenu na fragmenty na podstawie liczby znaków lub tokenów na fragment. |
| 6 | Konwertowanie tokenizowanych danych na format JSON. | Przeanalizuj dane JSON | Akcja 'Operacje na danych', która konwertuje fragmenty ciągu tokenu na tablicę JSON. |
| 7 | Wybierz elementy tablicy JSON. | Wybierz | Akcja Operacje na danych, która wybiera wiele elementów z tablicy JSON. |
| 8 | Wygeneruj embedingi. | Pobierz wiele wektorów | Akcja usługi Azure OpenAI , która tworzy osadzanie dla każdego elementu tablicy JSON. |
| 9 | Wybierz osadzenia i inne informacje. | Wybierz | Akcja Data Operations, która wybiera embeddingi i inne informacje o dokumencie. |
| 10 | Indeksowanie danych. | Indeksowanie dokumentów | Akcja usługi Azure AI Search , która indeksuje dane na podstawie każdego wybranego osadzania. |
Przepływ pracy czatu
Ponieważ wektorowe bazy danych nadal pozyskują dane, upewnij się, że dane można łatwo przeszukiwać, aby gdy użytkownik zada pytanie, przepływ pracy aplikacji logiki zaplecza Standard mógł przetworzyć monit i wygenerować niezawodną odpowiedź.
Poniższy wzorzec to tylko jeden przykład pokazujący, jak może wyglądać przepływ pracy czatu:
| Krok | Zadanie | Operacja bazowa | opis |
|---|---|---|---|
| 1 | Zaczekaj na monit wejściowy. | Po odebraniu żądania HTTP | Wyzwalacz, który sprawdza lub czeka na nadejście nowych danych w oparciu o zaplanowany harmonogram lub w odpowiedzi na określone zdarzenia. W tym przykładzie wyzwalacz Żądania czeka i przechwytuje pytanie klienta. |
| 2 | Komunikat systemu wejściowego dla modelu. | Redaguj | Akcja Operacje na danych, która dostarcza dane wejściowe do trenowania modelu. |
| 3 | Przykładowe pytania i odpowiedzi dotyczące danych wejściowych. | Redaguj | Akcja Operacje na danych, która udostępnia przykładowe pytania klienta i skojarzone role, w celu wytrenowania modelu. |
| 4 | Komunikat systemu wejściowego dla zapytania wyszukiwania. | Redaguj | Akcja Operacje na danych, która udostępnia dane wejściowe zapytania wyszukiwania w celu wytrenowania modelu. |
| 5 | Generowanie zapytania wyszukiwania. | Wykonywanie kodu JavaScript | Akcja kodu wbudowanego, która używa języka JavaScript do utworzenia zapytania wyszukiwania dla magazynu wektorów na podstawie danych wyjściowych z poprzednich działań Compose. |
| 6 | Konwertuj zapytanie na osadzanie. | Uzyskiwanie wyników rozmowy | Akcja usługi Azure OpenAI, która łączy się z API uzupełniania czatu, gwarantując niezawodne odpowiedzi w konwersacjach czatowych. W tym przykładzie akcja akceptuje zapytania wyszukiwania i role jako dane wejściowe do modelu i zwraca wektorowe osadzanie jako dane wyjściowe. |
| 7 | Pobierz osadzenie. | Pobierz osadzanie | Akcja usługi Azure OpenAI, która otrzymuje pojedynczą reprezentację wektora. |
| 8 | Przeszukaj bazę danych wektorów. | Wektory wyszukiwania | Akcja usługi Azure AI Search, która wykonuje wyszukiwania w bazie wektorów. |
| 9 | Utwórz polecenie. | Wykonywanie kodu JavaScript | Akcja kodu wbudowanego, która używa języka JavaScript do kompilowania monitów. |
| 10 | Przeprowadź zakończenie czatu. | Uzyskiwanie wyników rozmowy | Akcja usługi Azure OpenAI, która łączy się z API uzupełniania czatu, gwarantując niezawodne odpowiedzi w konwersacjach czatowych. W tym przykładzie akcja akceptuje wskazówki i role jako dane wejściowe do modelu i zwraca wygenerowane przez model odpowiedzi jako dane wyjściowe. |
| 11 | Zwróć odpowiedź. | Odpowiedź | Akcja Żądanie zwracająca wyniki do elementu wywołującego podczas korzystania z wyzwalacza Żądanie. |