Uruchamianie przepływów pracy automatyzacji z akcji w agentach za pomocą rozwiązania Azure AI Foundry i usługi Azure Logic Apps (wersja zapoznawcza)

Dotyczy: Azure Logic Apps (Zużycie)

Uwaga / Notatka

Ta możliwość jest dostępna w wersji zapoznawczej, może powodować naliczanie opłat i podlega dodatkowym warunkom użytkowania wersji zapoznawczej platformy Microsoft Azure.

Jeśli masz aplikację sztucznej inteligencji w usłudze Azure AI Foundry, która musi automatyzować procesy wieloetapowe lub integrować się z różnymi usługami, systemami, aplikacjami i źródłami danych, możesz dodać akcje w agentach , aby uruchamiać przepływy pracy automatyzacji w usłudze Azure Logic Apps.

W usłudze Azure AI Foundry agent używa akcji i modelu sztucznej inteligencji do autonomicznego lub interakcyjnego wykonywania zadania. Na przykład agenci używają akcji do odpowiadania na pytania, uzyskiwania informacji i wykonywania innych zadań przy użyciu modeli sztucznej inteligencji.

W usłudze Azure Logic Apps przepływ pracy aplikacji logiki automatyzuje procesy i może integrować platformę Azure, firmę Microsoft i usługi, systemy, aplikacje i źródła danych w innych ekosystemach — zwykle bez dodatkowego kodu. Przepływ pracy używa wstępnie utworzonego wyzwalacza i akcji z galerii z 1400 łącznikami wraz z operacjami natywnymi dla środowiska uruchomieniowego lub "wbudowanymi".

Na poniższym diagramie pokazano, jak akcja agenta w rozwiązaniu Azure AI Foundry jest powiązana z przepływem pracy aplikacji logiki w usłudze Azure Logic Apps:

W tym przewodniku pokazano, jak dodać akcję do agenta w narzędziu Azure AI Foundry, aby agent utworzył przepływ pracy aplikacji logiki Zużycie, który jest uruchamiany w wielodostępnej usłudze Azure Logic Apps. Kreator przeprowadzi Cię przez kroki konfigurowania tej akcji przy użyciu wstępnie zdefiniowanego logicznego przepływu pracy aplikacji. Po zakończeniu dodawania akcji możesz rozszerzyć ten przepływ pracy na podstawie potrzeb scenariusza, korzystając z projektanta graficznego w usłudze Azure Logic Apps.

Więcej informacji można znaleźć w następującej dokumentacji:

• Co to jest usługa Azure AI Foundry?
• Co to jest Azure Logic Apps?
• Przepływ pracy aplikacji logiki konsumpcji — opcje hostingu

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.

• Projekt usługi Azure AI Foundry, który jest tworzony przy użyciu domyślnego centrum.

  Ten projekt organizuje pracę i zapisuje stan podczas tworzenia aplikacji sztucznej inteligencji. Centrum hostuje projekt i zapewnia środowisko współpracy zespołowej.

  Aby utworzyć projekt z centrum, potrzebujesz jednej z następujących ról dla kontroli dostępu opartej na rolach (RBAC) firmy Microsoft w oparciu o zasadę najniższych uprawnień:

  • Współautor (najmniej uprzywilejowany)

  • Właściciel

  Jeśli masz inną rolę, musisz utworzyć centrum. Więcej informacji można znaleźć w następującej dokumentacji:

  • Role domyślne dla projektów

  • Role domyślne dla centrów

• Wdrożony model usługi Azure OpenAI Service dla projektu.

  Jeśli nie masz wdrożonego modelu, zobacz Wdrażanie modelu.

• Agent w projekcie.

  To wymaganie obejmuje wdrażanie modelu w usłudze Azure OpenAI Service, który ma być używany przez agenta podczas uruchamiania przepływu pracy.

Czy mogę tworzyć własne przepływy pracy i używać ich jako akcji?

Tak, aby udostępnić własne przepływy pracy aplikacji logiki za pośrednictwem galerii akcji w portalu usługi Azure AI Foundry, przepływy pracy muszą spełniać następujące wymagania:

• Zasób aplikacji logicznej, który zawiera przepływ pracy, używa opcji Zużycie hostingu.

• Zasób aplikacji logiki używa tej samej subskrypcji platformy Azure, której używasz z usługą Azure AI Foundry.

• Przepływ pracy rozpoczyna się od wyzwalacza o nazwie Po odebraniu żądania HTTP.

• Wyzwalacz zawiera opis, który podajesz w okienku informacji o wyzwalaczu w projektancie przepływu pracy.

• Przepływ pracy kończy się akcją Odpowiedź.

Twoja aplikacja sztucznej inteligencji ma prawie nieograniczone opcje uruchamiania przepływów pracy, które współdziałają z platformą Azure, firmą Microsoft i innymi usługami lub produktami oraz operacjami, które ułatwiają zarządzanie, kształtowanie, konwertowanie i przekształcanie danych. Jeśli nie istnieje wstępnie utworzony łącznik dla tego, co chcesz zrobić, możesz również utworzyć własny.

Więcej informacji można znaleźć w następującej dokumentacji:

• Rozpoczęcie pracy: tworzenie przykładowego przepływu pracy aplikacji logiki konsumpcji przy użyciu portalu Azure
• Co to są łączniki w usłudze Azure Logic Apps
• Zarządzane łączniki uruchamiane na globalnej, wielodostępnej platformie Azure
• Dokumentacja techniczna łączników zarządzanych dla usługi Azure Logic Apps
• Wbudowane operacje uruchamiane za pomocą środowiska uruchomieniowego usługi Azure Logic Apps
• Łączniki niestandardowe w usłudze Azure Logic Apps

Ograniczenia i znane problemy

Ta wersja ma następujące ograniczenia lub znane problemy:

Ograniczenie

Opis

Obsługa przepływu pracy aplikacji logiki

Obecnie akcje agenta obsługują tylko przepływy pracy aplikacji Logic Apps w modelu zużycia w wielodostępnych środowiskach Azure. Zasób aplikacji logiki Zużycie może mieć tylko jeden przepływ pracy. Aby uzyskać więcej informacji, zobacz Opcje hostingu dla wdrożeń. Akcje agenta nie obsługują obecnie standardowych przepływów pracy aplikacji logiki w scenariuszach jednolokatorskich Azure Logic Apps, środowiskach App Service Environment lub wdrożeniach hybrydowych. Aplikacja logiki Standard może mieć wiele przepływów pracy. Aby uzyskać więcej informacji, zobacz Opcje hostingu dla wdrożeń.

Dodaj akcję do agenta

Wykonaj następujące kroki, aby skonfigurować akcję swojego agenta w celu utworzenia i uruchomienia przepływu pracy aplikacji Logic Apps.

1. Zaloguj się do portalu usługi Azure AI Foundry i otwórz projekt.

2. W przeglądzie projektu, w menu nawigacji portalu, w sekcji Kompiluj i dostosuj, wybierz Agentów. Na stronie Agenci w obszarze Moi agenci wybierz agenta.

   

3. W sekcji Konfiguracja obok listy agentów przewiń w dół do sekcji Akcje i wybierz pozycję Dodaj.

   

4. W oknie Dodawanie akcji wybierz pozycję Azure Logic Apps.

   

5. W obszarze Wybierz akcję wybierz wstępnie zdefiniowaną akcję z jedną z następujących etykiet:

   Etykieta akcji	Opis
   Opublikowane przez Microsoft	Ta akcja używa szablonu utworzonego przez firmę Microsoft do utworzenia przepływu pracy dla akcji.
   Przepływ pracy	Ta akcja używa kwalifikującego się przepływu pracy aplikacji logiki w ramach subskrypcji platformy Azure jako szablonu, aby utworzyć przepływ pracy dla akcji. Uwaga: jeśli wybierzesz tę opcję, przejdź do sekcji o nazwie Potwierdź szczegóły akcji. Jeśli przepływy pracy nie są wyświetlane zgodnie z oczekiwaniami w galerii działań, sprawdź wymagania.

   W poniższym przykładzie użyto akcji utworzonej przez firmę Microsoft o nazwie Pobierz prognozę pogody dla dzisiaj za pośrednictwem witryny MSN Weather:

   

6. W oknie akcji Dodaj aplikację Logic Apps w obszarze Wprowadź kilka podstawowych informacji podaj następujące informacje:

   Parametr	Wymagane	Wartość	Opis
   Nazwa akcji	Tak	< nazwa akcji>	Przyjazna, ale skupiona na zadaniu, zwięzła nazwa akcji zaczynająca się od czasownika. Ta nazwa jest również używana dla zasobu aplikacji logiki i przepływu pracy w usłudze Azure Logic Apps. Uwaga: - Nazwa akcji może używać tylko liter, cyfr i następujących znaków specjalnych: -, (, ), _lub ' . — Nie można używać białych znaków ani innych znaków specjalnych. — Zasób aplikacji logicznej w trybie zużycia oraz jej przepływ pracy są połączone i mają relację jeden do jednego, co oznacza, że używają tej samej nazwy. Dla porównania, zasób aplikacji logicznych w warstwie Standard może mieć wiele przepływów pracy, które używają różnych nazw. W tym przykładzie użyto polecenia Get-weather-forecast-today.
   Opis akcji	Tak	< action-description>	Opis, który wyraźnie opisuje przeznaczenie akcji. W tym przykładzie użyto tego działania, które tworzy wywoływalny przepływ pracy aplikacji Logic Apps, który pobiera prognozę pogody na dzisiaj i działa w globalnej, wielodostępnej usłudze Azure Logic Apps.
   Subskrypcja	Tak	< Subskrypcja platformy Azure>	Subskrypcja platformy Azure, której należy użyć, prawdopodobnie taka sama jak w przypadku Twojego projektu i modelu.
   Grupa zasobów	Tak	< Azure-resource-group (grupa-zasobów) platformy Azure>	Grupa zasobów platformy Azure do użycia.
   Lokalizacja	Tak	< Region świadczenia usługi Azure>	Region świadczenia usługi Azure, w którym należy hostować zasób i przepływ pracy aplikacji logiki.

   Poniższy zrzut ekranu przedstawia przykładowe szczegóły przykładowej akcji Get-weather-forecast-today:

   

7. Po zakończeniu wybierz pozycję Dalej.

Tworzenie i uwierzytelnianie połączeń

Wykonaj następujące kroki, aby utworzyć wszystkie połączenia wymagane przez akcję i uwierzytelnić dostęp do odpowiednich usług, systemów, aplikacji lub źródeł danych. Podstawowy szablon określa, które łączniki użyć dla tej akcji i przepływu pracy w aplikacji logicznej.

1. W oknie akcji Dodaj Logic App, pod Uwierzytelnianie, przejrzyj wszystkie połączenia, które należy utworzyć i uwierzytelnić.

2. W kolumnie Połączenie wybierz pozycję Połącz dla powiązanej usługi lub źródła danych.

   Poniższy zrzut ekranu przedstawia przykładowe połączenie służące do tworzenia i uwierzytelniania dla usługi MSN Weather:

   

   Niektóre połączenia wymagają dodatkowych szczegółów, dlatego postępuj zgodnie z monitami, aby podać żądane informacje.

3. Dla każdego wymaganego połączenia powtórz te kroki.

4. Po zakończeniu wybierz pozycję Dalej.

Potwierdzanie szczegółów akcji

Przejrzyj i sprawdź, czy wszystkie informacje o akcji są poprawne. Jeśli wybrano akcję zaprojektowaną przez firmę Microsoft, przejrzyj oświadczenie potwierdzenia i wyraź zgodę na nie.

1. W oknie Dodaj aplikację Logic jako akcję, w sekcji Zasób, sprawdź wszystkie podane informacje o akcji.

2. W przypadku wybranej akcji utworzonej przez firmę Microsoft wykonaj następujące czynności:

   1. Przejrzyj oświadczenie, które potwierdza, że akceptujesz i rozumiesz następujące wydarzenia, które mają miejsce po opuszczeniu strony Zasób, wybierając pozycję Dalej:

      • Nie można powrócić do poprzednich kroków.

      • Akcja tworzy zasób aplikacji logiki typu Consumption.

      • Nawiązywanie połączenia z usługą Azure Logic Apps powoduje naliczanie opłat na koncie platformy Azure.

        Aby uzyskać więcej informacji na temat modelu rozliczeń dla przepływów pracy aplikacji logiki dotyczącej Zużycia, zobacz następującą dokumentację:

        • Pomiar użycia, rozliczenia i cennik

        • Cennik usługi Azure Logic Apps (plan zużycia — wielodostępny)

   2. Aby wyrazić zgodę, zaznacz pole potwierdzenia, na przykład:

      

3. Gdy wszystko będzie gotowe, wybierz pozycję Dalej

Zakończ tworzenie akcji

Aby zapoznać się z ostatnim krokiem, przejrzyj informacje generowane przez portal dotyczące narzędzia używanego przez agenta do uruchamiania akcji i uwierzytelniania dostępu do wszelkich odpowiednich usług lub zasobów platformy Azure, firmy Microsoft i innych niż Microsoft.

1. W oknie akcji Dodaj aplikację Logic na stronie Schemat przejrzyj następujące informacje i upewnij się, że podajesz opis okoliczności wywoływania narzędzia:

   Parametr	Opis
   Nazwa narzędzia	Edytowalna nazwa narzędzia używanego przez agenta do uruchamiania akcji i uzyskiwania dostępu do platformy Azure, usług zewnętrznych, źródeł danych lub wyspecjalizowanych modeli sztucznej inteligencji, dzięki czemu agent może pobierać dane, uruchamiać zadania i korzystać z innych platform. Uwaga: — Nazwa akcji może używać tylko liter, cyfr i znaku podkreślenia (_). — Nie można używać białych znaków ani innych znaków specjalnych.
   Połączenie na potrzeby uwierzytelniania	Nazwa w trybie tylko do odczytu dla połączenia używanego przez agenta do uzyskiwania dostępu do zasobów platformy Azure, Microsoftu i zasobów zewnętrznych bez konieczności prosząc o poświadczenia za każdym razem. Aby uzyskać więcej informacji, zobacz Połączenia w portalu usługi Azure AI Foundry.
   Opis sposobu wywoływania narzędzia	Opis określający okoliczności, gdy agent wywołuje narzędzie.
   schemat	Schemat przepływu pracy aplikacji logiki w formacie JavaScript Object Notation (JSON).

   

2. Gdy wszystko będzie gotowe, wybierz pozycję Utwórz.

   Portal zwraca Cię do strony Agenci dla wybranego agenta. W sekcji Konfiguracja sekcja Akcje zawiera teraz nazwę narzędzia, które uruchamia akcję, i wyświetla ikonę usługi Azure Logic Apps obok nazwy narzędzia, na przykład:

   

Testowanie akcji agenta

Aby wypróbować nową akcję agenta przy użyciu placu zabaw agentów, wykonaj następujące kroki:

1. Na stronie Agenci w górnej części sekcji Konfiguracja wybierz pozycję Wypróbuj na placu zabaw.

2. Na stronie Plac zabaw Agentów w polu czatu zapytań użytkownika zadaj pytanie o pogodę, na przykład:

   Jaka jest pogoda w Londynie? Pokaż wyniki w formacie listy punktowanej.

   Agent zwraca odpowiedź podobną do następującego przykładu:

   

Przegląd logiki aplikacji i przepływu pracy

Po uruchomieniu akcji możesz wyświetlić bazowy zasób aplikacji logiki i przepływ pracy w witrynie Azure Portal. Możesz przejrzeć historię uruchamiania przepływu pracy, której można użyć do debugowania lub rozwiązywania problemów, które mogą wystąpić w przepływie pracy.

1. Zaloguj się do witryny Azure Portal. W polu wyszukiwania paska tytułu portalu wprowadź nazwę utworzonej akcji.

2. Na liście wyników w obszarze Zasoby wybierz zasób aplikacji logiki.

   

3. Aby wyświetlić historię uruchamiania, dane wejściowe, dane wyjściowe i inne informacje przepływu pracy, w menu aplikacji logiki w obszarze Narzędzia programistyczne wybierz pozycję Historia uruchamiania.

4. Na liście Historia uruchamiania wybierz najnowszy przebieg przepływu pracy, na przykład:

   

5. Po otwarciu widoku monitorowania i wyświetleniu stanu każdej operacji w przepływie pracy wybierz operację, aby otworzyć okienko informacji i przejrzeć dane wejściowe i wyjściowe operacji.

   W tym przykładzie wybrano akcję o nazwie Pobierz prognozę dla dzisiaj, na przykład:

   

   Aby uzyskać więcej informacji na temat historii uruchamiania przepływu pracy, zobacz Wyświetlanie stanu przepływu pracy i historii uruchamiania.

Otwieranie przepływu pracy w projektancie

Wykonaj następujące kroki, aby przejrzeć definicję i operacje przepływu pracy lub edytować przepływ pracy, otwierając projektanta przepływu pracy.

1. W menu aplikacji logiki w obszarze Narzędzia programistyczne wybierz projektanta.

   Przepływ pracy otwiera się w projektancie. Teraz możesz przejrzeć operacje przepływu pracy, które odwołują się do wyzwalacza i akcji, na przykład:

   

2. Aby wyświetlić parametry i ustawienia operacji, w projektancie wybierz operację, na przykład:

   

3. Aby rozwinąć zachowanie przepływu pracy, możesz dodać więcej akcji, wykonując kroki opisane w temacie Tworzenie przepływu pracy z wyzwalaczem lub akcją.

   Aby ten przepływ pracy lub dowolny inny przepływ pracy był wyświetlany w galerii akcji i uruchamiany jako akcja w agencie, przepływ pracy musi zawsze spełniać następujące wymagania:

   • Zasób aplikacji logicznej, który zawiera przepływ pracy, musi korzystać z opcji hostingu Zużycie.

   • Zasób aplikacji logiki musi używać tej samej subskrypcji platformy Azure, której używasz z usługą Azure AI Foundry.

   • Przepływ pracy musi rozpoczynać się od wyzwalacza Po odebraniu żądania HTTP.

   • Wyzwalacz wymaga opisu, który można znaleźć w okienku informacji o wyzwalaczu w projektancie.

   • Przepływ pracy musi kończyć się akcją Odpowiedź.

   Ostrzeżenie

   Chociaż można dodawać akcje i zmieniać przepływ pracy, nie edytuj oryginalnego wyzwalacza i akcji, aby uniknąć zerwania relacji między przepływem pracy, agentem i akcją. Ich parametry są skonfigurowane do współpracy, więc zmiany w tych operacjach niosą ryzyko zakłócenia działania agenta. Zamiast tego rozważ utworzenie wersji spersonalizowanej lub innego przepływu pracy, który można dodać jako czynność do agenta.

   Na przykład wyzwalacz używa następujących parametrów, które są niezbędne do wywołania wyzwalacza:

   Parametr	Opis
   Nazwa	Ta nazwa jest częścią adresu URL HTTPS wyzwalacza. Zewnętrzne osoby wywołujące, takie jak inne usługi, poza przepływem pracy wysyłają żądanie HTTPS do tego adresu URL, które uruchamia wyzwalacz i uruchamia przepływ pracy. Wyzwalacz jest zawsze pierwszym krokiem w przepływie pracy i określa warunek, który ma spełniać wyzwalacz do uruchomienia.
   HTTPS URL	Po pierwszym zapisaniu przepływu pracy ten adres URL jest generowany i używany do wywoływania punktu końcowego tworzonego przez wyzwalacz dla przepływu pracy.
   Metoda	To ustawienie określa, czy wyzwalacz akceptuje wszystkie lub tylko określone metody HTTPS.
   Schemat JSON treści żądania	Jeśli chcesz zweryfikować dane wejściowe oczekiwane przez wyzwalacz w żądaniu HTTPS wysłanym z zewnętrznych obiektów wywołujących, ten schemat określa schemat JSON do użycia do sprawdzania poprawności tych danych wejściowych.

4. Aby zapisać wszelkie wprowadzone zmiany, na pasku narzędzi projektanta wybierz pozycję Zapisz.

Testowanie przepływu pracy w projektancie

Jeśli wprowadzono zmiany w przepływie pracy pogody lub w celu przetestowania innego przepływu pracy, wykonaj następujące kroki:

1. Na pasku narzędzi projektanta wybierz pozycję Uruchom>Uruchom z ładunkiem.

2. Po otworzeniu okienka Uruchom z ładunkiem w polu Treść podaj oczekiwane dane wejściowe wyzwalacza w formacie JSON, na przykład:

   {
       "location": {
           "type": "London",
           "description": "Location for the weather"
       }
   }
   

3. Gdy wszystko będzie gotowe, wybierz pozycję Uruchom.

   Na karcie Dane wyjścioweTreść odpowiedzi zawiera wyniki i odpowiedź z przepływu pracy.

4. Jeśli przebieg przepływu pracy generuje błędy lub wymaga rozwiązywania problemów, otwórz historię uruchamiania przepływu pracy, aby umożliwić sprawdzenie danych wejściowych i wyjściowych poszczególnych operacji przy użyciu odpowiednich kroków opisanych w temacie Przeglądanie podstawowej aplikacji logiki i przepływu pracy.

Rozliczenia i ceny

Przepływy pracy aplikacji logiki zużycia generują opłaty na podstawie modelu rozliczeniowego "płatność za użycie". Aby uzyskać więcej informacji na temat tego modelu, zobacz następujące zasoby:

• Pomiar użycia, rozliczenia i cennik
• Cennik usługi Azure Logic Apps (plan zużycia — wielodostępny)

W przypadku usługi Azure AI Foundry zobacz następujące zasoby:

• Planowanie kosztów usługi Azure AI Foundry i zarządzanie nimi
• Cennik rozwiązania Azure AI Foundry

Uprzątnij zasoby

Jeśli nie potrzebujesz zasobów utworzonych w tym przewodniku, usuń zasoby, aby nie kontynuować naliczania opłat. Możesz wykonać te kroki, aby usunąć grupę zasobów zawierającą te zasoby lub usunąć każdy zasób osobno.

1. W portalu Azure AI Foundry, aby usunąć akcję z agenta, obok nazwy akcji wybierz przycisk wielokropka (...), a następnie wybierz pozycję Usuń.

2. W polu wyszukiwania paska tytułu witryny Azure Portal wprowadź grupy zasobów i wybierz pozycję Grupy zasobów.

3. Znajdź grupę zasobów zawierającą wdrożone zasoby centrum.

4. Na pasku narzędzi strony Przegląd wybierz pozycję Usuń grupę zasobów.

5. Po wyświetleniu okienka potwierdzenia wprowadź nazwę grupy zasobów i wybierz pozycję Usuń.

Treści powiązane

• Co to są łączniki w usłudze Azure Logic Apps?
• Co to jest usługa Azure AI Foundry?
• Co to jest Azure Logic Apps?