Uruchamianie kodu w języku Python, który przetwarza pliki w przepływach pracy agenta za pomocą usługi Azure Logic Apps (wersja zapoznawcza)

Dotyczy: Azure Logic Apps (Standard)

Uwaga / Notatka

Ta funkcja jest dostępna w wersji zapoznawczej i podlega dodatkowym warunkom użytkowania wersji zapoznawczej platformy Microsoft Azure.

W standardowych aplikacjach logicznych przepływy pracy agentów mogą nie tylko obsługiwać żądania języka naturalnego za pośrednictwem interfejsów czatu przy użyciu agentów, ale także przetwarzać pliki podczas tworzenia narzędzia agenta używając operacji wbudowanego konektora interpretera kodu (sesja Python Container Apps). Te operacje umożliwiają przepływowi pracy agenta generowanie i uruchamianie kodu języka Python, przekazywania, pobierania i usuwania plików. Z perspektywy scenariusza agent może otrzymywać instrukcje, akceptować pliki, generować i uruchamiać kod w izolowanym środowisku oraz zwracać użyteczne wyniki, takie jak podsumowania, prognozy lub inne żądane przekształcenia danych — wszystkie w ramach tego samego przepływu pracy.

Uwaga / Notatka

W tym artykule przyjęto założenie, że pracujesz z przepływem pracy agenta i używasz operacji interpretera kodu wewnątrz narzędzi agenta, aby umożliwić agentowi wygenerowanie niezbędnego kodu w języku Python.

W poniższym przykładzie przedstawiono przepływ pracy z akcją agenta o nazwie Agent raportów sprzedaży. Agent może użyć narzędzia o nazwie Upload sales data (Przekazywanie danych sprzedaży ) do uruchamiania operacji interpretera kodu o nazwie Upload file (Przekazywanie pliku ) i Execute Python code (Wykonywanie kodu w języku Python).

Gdy przepływ pracy odbiera żądanie HTTPS dla określonego pliku za pośrednictwem wyzwalacza Żądanie , akcja HTTP pobiera żądany plik. Agent ma instrukcje przekazywania pliku do puli sesji usługi Container Apps, generowania kodu języka Python w celu przetworzenia pliku i zwracania wyników na podstawie odebranych instrukcji:

Uwaga / Notatka

Operacje interpretera kodu (sesja usługi Python Container Apps) można używać poza akcją agenta lub w przepływach pracy innych niż agent w standardowej aplikacji logiki. Należy jednak podać własny kod w języku Python dla akcji Wykonaj kod w języku Python . W takich przypadkach operacje interpretera kodu nie mają dostępu do możliwości agenta udostępnianych przez model sztucznej inteligencji połączonego z agentem, który obejmuje interakcje języka naturalnego i kod wygenerowany przez model.

Przepływ pracy agenta może przetwarzać pliki zawierające zróżnicowane lub pofragmentowane dane i mieć formaty, takie jak CSV, Excel lub JSON, które mogą zawierać tysiące do milionów wierszy. Jednak nieprzetworzone dane często wymagają dodatkowej pracy, zanim będzie można wyodrębnić przydatne informacje i szczegółowe informacje, na przykład:

Czyszczenie i przekształcanie
Logika niestandardowa do wyodrębniania szczegółowych informacji
Wizualizacje lub podsumowania, które umożliwiają podejmowanie działań dotyczących danych

Te zadania często wymagają ręcznego wykonywania kroków podatnych na błędy i czasochłonne, zwłaszcza dla osób, które nie mają wiedzy z zakresu nauki o danych ani wiedzy inżynieryjnej. Przepływ pracy może używać operacji interpretera kodu (sesji usługi Container Apps w języku Python), aby zautomatyzować te zadania i zapewnić natywne i bezpośrednie możliwości interpretera kodu w środowisku uruchomieniowym usługi Azure Logic Apps. Operacja wykonująca kod w języku Python jest obsługiwana przez pulę sesji usługi Azure Container Apps. Sesje dynamiczne w usłudze Azure Container Apps zapewniają szybki i skalowalny dostęp do interpretera kodu. Każda sesja interpretera kodu jest w pełni odizolowana przez granicę Hyper-V i jest przeznaczona do uruchamiania niezaufanego kodu. Po włączeniu izolacji sieciowej w kontenerze aplikacji dane nigdy nie opuszczają zdefiniowanych granic sieci.

Te możliwości umożliwiają takie scenariusze jak następujące przykłady:

Scenario	Przypadek użycia
Eksploracja danych	Użytkownicy biznesowi mogą zadawać pytania dotyczące danych przy użyciu języka naturalnego i bez konieczności pisania jednego wiersza kodu lub ręcznego manipulowania arkuszami kalkulacyjnymi i używania języka naturalnego, na przykład: - "Znajdź 5 najlepszych produktów według przychodów"." - "Prognozowanie popytu na następny kwartał według regionu". - "Wyróżnij segmenty klientów na podstawie wzorców zakupów".
Operations	Czyszczenie dużych plików dziennika, wyjątków powierzchni i generowanie szczegółowych informacji w celu zwiększenia niezawodności.
Finance	Analizowanie raportów wydatków, wykrywanie anomalii lub generowanie kwartalnych podziałów z eksportów programu Excel.
Sprzedaż i marketing	Przekaż nieprzetworzone dane sprzedaży i uzyskaj podsumowania na żądanie, prognozy lub porównania regionalne.

W tym artykule pokazano, jak skonfigurować i używać różnych operacji interpretera kodu (sesja usługi Python Container Apps) w przepływie pracy agenta.

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.
Aplikacja kontenera i pula sesji interpretera kodu w usłudze Azure Container Apps.
- Aby utworzyć aplikację, zobacz Szybki start: wdrażanie pierwszej aplikacji kontenera przy użyciu witryny Azure Portal. Aby upewnić się, że dane nigdy nie opuszczają sieci, włącz izolację sieci w aplikacji kontenera.
  
  Aby uzyskać więcej informacji, zobacz następujące artykuły:
  - Środowiska usługi Azure Container Apps
  - Sieć w środowisku usługi Azure Container Apps
- Aby utworzyć pulę sesji, zobacz Tworzenie pul sesji w usłudze Azure Container Apps. Możesz użyć witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure.
  
  Ważne
  
  Dla typu puli sesji upewnij się, że wybrano interpreter kodu języka Python.
- Opcjonalnie: plik można przekazać do sesji przy użyciu witryny Azure Portal lub wysłać żądanie HTTPS. Następnie możesz odwołać się do pliku jako źródła danych w kodzie języka Python. Aby uzyskać więcej informacji, zobacz Przekazywanie pliku — sesje interpretera kodu bezserwerowego w usłudze Azure Container Apps. W przeciwnym razie możesz użyć akcji Przekaż plik z łącznika Interpreter kodu (sesja usługi Python Container Apps).
  
  Uwaga / Notatka
  
  Aby zarządzać plikami lub uruchamiać kod w puli sesji, upewnij się, że masz wbudowaną rolę platformy Azure o nazwie Azure ContainerApps Session Executor w puli sesji. W tym zadaniu zobacz Przyznawanie tożsamości dostępu do zasobów.
  
  Aby przekazać plik za pośrednictwem witryny Azure Portal, wykonaj następujące kroki:
  1. W witrynie Azure Portal otwórz zasób puli sesji interpretera kodu.
  2. Na pasku bocznym zasobu wybierz pozycję Plac zabaw.
  3. Na pasku narzędzi Plac zabaw wybierz pozycję Zarządzaj plikami.
    
    W poniższym przykładzie pokazano polecenie Zarządzaj plikami na pasku narzędzi Plac zabaw :
  4. W okienku Zarządzanie plikami wybierz pozycję Przekaż plik i podaj plik do przekazania.
Zasób standardowej aplikacji logiki i przepływ pracy agenta. Upewnij się, że skonfigurowaliśmy połączenie między akcją Agent domyślny i modelem sztucznej inteligencji do użycia na potrzeby generowania kodu.

Aby utworzyć ten przepływ pracy, zobacz Tworzenie przepływów pracy, które używają agentów i modeli sztucznej inteligencji do wykonywania zadań w usłudze Azure Logic Apps.

Uwaga / Notatka

Przepływy pracy agenta muszą rozpoczynać się od wyzwalacza Żądania . Łącznik Interpreter kodu (sesja usługi Container Apps w języku Python) udostępnia akcje, ale nie wyzwalacze.

Dokumentacja techniczna łącznika

Aby uzyskać informacje techniczne dotyczące operacji tego łącznika, zobacz dokumentację referencyjną łącznika.

Przekazywanie pliku

W Azure portal otwórz zasób aplikacji logicznych standardowych.
Na pasku bocznym zasobów w obszarze Przepływy pracy wybierz pozycję Przepływy pracy, a następnie wybierz przepływ pracy agenta.
Na pasku bocznym przepływu pracy w obszarze Narzędzia wybierz projektanta, aby otworzyć przepływ pracy.
W akcji Agent domyślny wykonaj ogólne kroki, aby utworzyć narzędzie i dodać akcję Interpreter kodu (sesja aplikacji kontenera języka Python) o nazwie Przekaż plik.
Jeśli zostanie wyświetlony monit o utworzenie połączenia, w okienku Tworzenie połączenia podaj informacje o połączeniu dla puli sesji.

W okienku informacji o akcji rozwiń węzeł Pliki wejściowe do przekazania i podaj następujące wartości:

Parameter	Wartość	Description
Nazwa pliku wejściowego	< nazwa pliku>	Nazwa, która ma zostać przypisana dla pliku.
Zawartość pliku wejściowego	< plik-zawartość>	Ścieżka do przekazania zawartości pliku.

W poniższym przykładzie przepływ pracy używa akcji HTTP , która wykonuje wywołanie REST w celu pobrania pliku z lokalizacji źródłowej. Akcja agenta ma narzędzie, które używa akcji Przekaż plik z nazwą pliku i zawartością jako parametrami. Nazwa pliku to ręczne dane wejściowe, podczas gdy zawartość pliku odwołuje się do danych wyjściowych z poprzedniej akcji HTTP :

Jeśli masz więcej plików do przekazania, wybierz pozycję Dodaj nowy element.
Gdy wszystko będzie gotowe, zapisz proces. Na pasku narzędzi projektanta wybierz pozycję Zapisz.