Uruchamianie przepływów pracy w ramach usługi Azure Logic Apps przez agentów w usłudze Foundry Agent Service (wersja zapoznawcza)

Dotyczy: Azure Logic Apps (Zużycie)

Uwaga / Notatka

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

Agenci często muszą pracować z systemami zewnętrznymi, takimi jak wywoływanie interfejsów API, aktualizowanie systemów lub koordynowanie wielu kroków. Jeśli jednak mieszasz logikę agenta i integracji lub bezpośrednio osadzasz logikę integracji w kodzie agenta, rozwiązania stają się trudniejsze do utrzymania, testowania, aktualizowania i rozwoju. Agenci mogą adeptycznie wybierać akcje do podjęcia lub użycia narzędzi. Nie są one jednak przeznaczone do zarządzania ponownymi próbami, długotrwałymi krokami lub awariami systemu zewnętrznego.

W programie Foundry dodaj przepływy pracy z usługi Azure Logic Apps do agentów jako akcje. Agenci mogą następnie uruchamiać wieloetapowe zadania biznesowe w produktach i usługach firmy Microsoft oraz różnych dostawców — często bez konieczności pisania kodu. Twoje rozwiązania zyskują i korzystają z zdolności agentowych dzięki logice integracji do wielokrotnego użycia.

Na poniższym diagramie pokazano, jak akcje agenta w rozwiązaniu Foundry (wersja klasyczna) odnoszą się do przepływów pracy w usłudze Azure Logic Apps:

Agent koncentruje się na wybraniu prawidłowej akcji w celu wywołania przepływu pracy integracji, podczas gdy przepływ pracy obsługuje zadania orkiestracji i integracji.

Usługa Azure Logic Apps obsługuje ponad 1400 łączników i natywnych, wbudowanych operacji danych, dzięki czemu agenci mogą integrować się z wieloma usługami lub produktami firmy Microsoft i firm innych niż Microsoft. Jeśli wstępnie utworzony łącznik lub operacja nie istnieje, utwórz łącznik niestandardowy.

W tym artykule pokazano, jak użyć przepływu pracy z usługi Azure Logic Apps jako narzędzia do wykonywania akcji agenta w rozwiązaniu Foundry. Kreator przeprowadzi Cię przez to, jak skonfigurować akcję. Następnie możesz edytować przepływ pracy lub rozszerzyć przepływ pracy w projektancie przepływu pracy dla usługi Azure Logic Apps.

Aby uzyskać więcej informacji, zobacz:

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

Uwaga / Notatka

Ten artykuł dotyczy portalu Microsoft Foundry (klasycznego). Aby uzyskać więcej informacji na temat nowego portalu, zobacz nowy portal Microsoft Foundry

Wymagania wstępne

• Konto i subskrypcja platformy Azure. Uzyskaj bezpłatne konto platformy Azure.

• Projekt Microsoft Foundry.

  Ten projekt organizuje pracę i zapisuje stan podczas tworzenia aplikacji i rozwiązań sztucznej inteligencji.

  Aby utworzyć projekt węzła i umożliwić hostowanie projektu oraz skonfigurowanie środowiska współpracy zespołowej, musisz mieć jedną z następujących ról w kontroli dostępu opartej na rolach (RBAC) firmy Microsoft, zgodnie z zasadą najmniejszych uprawnień:

  • Współautor (najmniej uprzywilejowany)
  • Właściciel

  Jeśli masz inną rolę, musisz utworzyć centrum. Aby uzyskać więcej informacji, zobacz:

  • Kontrola dostępu oparta na rolach dla Microsoft Foundry
  • Kontrola dostępu oparta na rolach dla rozwiązania Microsoft Foundry (skoncentrowana na centrum)(klasyczna)

• Model usługi Azure OpenAI w wersji gpt-4.1 lub starszej wdrożonej dla projektu Foundry.

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

• Agent dla projektu Foundry.

• Zasób aplikacji typu "logika zużycia" i przepływ pracy, który spełnia następujące wymagania:

  Wymaganie	Opis
  Opcja hostingu	Używa opcji hostingu Zużycie .
  Subskrypcja platformy Azure	Używa tej samej subskrypcji co projekt Foundry.
  Grupa zasobów platformy Azure	Używa tej samej grupy zasobów co projekt Foundry.
  Wyzwalacz żądania	Operacja określająca warunki, które należy spełnić przed uruchomieniem kolejnych akcji w przepływie pracy. Domyślna nazwa wyzwalacza to Po odebraniu żądania HTTP. Wywołanie akcji agenta wymaga interfejsu API opartego na protokole REST. Wyzwalacz Żądanie udostępnia punkt końcowy REST, który usługa lub system może wywołać w celu uruchomienia przepływu pracy. Dlatego w przypadku wywołania akcji można używać tylko przepływów pracy rozpoczynających się od wyzwalacza Żądania .
  Opis wyzwalacza	Ten opis, który podajesz wraz z informacjami o wyzwalaczu w usłudze Azure Logic Apps, pomaga agentowi wybrać właściwą akcję w systemie Foundry.
  Schemat wyzwalacza	Schemat JSON opisujący oczekiwane dane wejściowe wyzwalacza. Narzędzie Foundry automatycznie importuje schemat z definicją akcji. Aby uzyskać więcej informacji, zobacz Wyzwalacz żądania.
  Akcja odpowiedzi	Przepływ pracy musi zawsze kończyć się tą akcją, która zwraca odpowiedź do Foundry po zakończeniu przepływu pracy.

  Aby zaimplementować logikę biznesową lub przypadek użycia, przepływ pracy może zawierać inne akcje z galerii łączników, w tym natywne dla środowiska uruchomieniowego operacje wbudowane, które implementują logikę dla danego scenariusza biznesowego.

  Na przykład na poniższym diagramie przedstawiono przykładową akcję o nazwie Get-weather-forecast-today , która jest dodawana jako narzędzie dla agenta o nazwie WeatherAgent w narzędziu Foundry. Ta akcja uruchamia przepływ pracy o nazwie Get-weather-forecast-today w usłudze Azure Logic Apps:

  

  Aby uzyskać więcej informacji, zobacz:

  • 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

• Skonfiguruj następujące zmienne środowiskowe z informacjami z projektu Foundry:

  export PROJECT_ENDPOINT="<your_project_endpoint>"
  export MODEL_DEPLOYMENT_NAME="<your_model_deployment_name>"
  export SUBSCRIPTION_ID="<your_Azure_subscription_ID>"
  export resource_group_name="<your_resource_group_name>"
  

  Aby uzyskać przykładowy kod, zobacz narzędzie AzureLogicAppTool w witrynie GitHub.

Ograniczenia

Ta wersja ma następujące ograniczenia:

Ograniczenie

Opis

Obsługa przepływu pracy aplikacji logiki

Akcje agenta obsługują obecnie tylko przepływy pracy aplikacji logiki Zużycie, które działają w wielodostępnych usługach Azure Logic Apps. Zasób aplikacji logiki Zużycie może mieć tylko jeden przepływ pracy. 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. Zasób standardowej aplikacji logiki może mieć wiele przepływów pracy.

Aby uzyskać więcej informacji, zobacz Opcje hostingu dla wdrożeń aplikacji logiki.

Dodaj akcję do swojego agenta

Aby skonfigurować akcję dla Twojego agenta w celu uruchomienia procesu aplikacji Logic Apps, należy wykonać następujące kroki:

1. W portalu Foundry (wersja klasyczna) otwórz projekt.

2. Na pasku bocznym projektu w obszarze Kompilowanie i dostosowywanie wybierz pozycję Agenci.

   Jeśli nie wdrożono modelu dla agenta, zostanie otwarty kreator umożliwiający wykonanie tego zadania przed kontynuowaniem. Pamiętaj, aby wybrać model, który obsługuje akcje agentów. Aby uzyskać więcej informacji, zobacz Wdrażanie modelu.

3. Na stronie Tworzenie i debugowanie agentów w obszarze Moi agenci wybierz agenta.

   

4. Obok listy agentów w sekcji Konfiguracja przewiń w dół do sekcji Akcje i wybierz pozycję Dodaj.

   

   Uwaga / Notatka

   Nie wszystkie modele obsługują akcje agenta. Jeśli sekcja Akcje jest niedostępna, musisz wdrożyć model GPT-4.1 lub starszy.

5. W kreatorze Dodawanie akcji wybierz pozycję Azure Logic Apps.

   

6. 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 akcji, sprawdź wymagania wstępne#.

   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:

   

7. W kreatorze 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: Przejrzyj następujące elementy: - 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	< Grupa-zasobów-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:

   

8. Po zakończeniu wybierz przycisk Dalej.

2: Tworzenie i uwierzytelnianie połączeń

Aby utworzyć połączenia wymagane przez akcję i uwierzytelnić dostęp do wymaganych usług, systemów, aplikacji lub źródeł danych, wykonaj następujące kroki. Szablon bazowy określa łączniki używane dla tej akcji oraz w odpowiednim przepływie pracy aplikacji logicznej.

1. W kreatorze akcji Dodaj aplikację logiczną w obszarze Uwierzytelnianie uwierzytelnij wszystkie połączenia, dla których należy je utworzyć.

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. Powtórz te kroki dla każdego wymaganego połączenia.

4. Po zakończeniu wybierz przycisk Dalej.

3. Potwierdzanie szczegółów akcji

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 kreatorze akcji Dodaj Logic App w obszarze Zasób sprawdź wszystkie podane informacje o akcji.

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

   1. Zapoznaj się z oświadczeniem, że potwierdzasz i rozumiesz następujące zdarzenia, gdy opuścisz sekcję Zasób, wybierając 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ń przepływów pracy aplikacji logiki dotyczących zużycia, zobacz:

        • 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. Po zakończeniu wybierz przycisk Dalej.

4. Zakończ tworzenie działania jako narzędzia

Przejrzyj informacje generowane przez portal dotyczące akcji jako narzędzia. Agent używa tych informacji do uruchamiania akcji (narzędzia) i uwierzytelniania dostępu do wszelkich odpowiednich usług lub zasobów platformy Azure, firmy Microsoft i innych firm.

1. W kreatorze akcji Dodaj aplikację logiczną w sekcji Schemat przejrzyj następujące informacje i upewnij się, że podano opis scenariusza użycia 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 narzędzia 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 tylko do odczytu dla połączenia, które narzędzie wykorzystuje do uzyskiwania dostępu do platformy Azure, usług firmy Microsoft oraz zasobów zewnętrznych, bez konieczności każdorazowego podawania poświadczeń. Aby uzyskać więcej informacji, zobacz Połączenia w portalu Foundry.
   Opis sposobu wywoływania narzędzia	Opis określający, kiedy agent wywołuje narzędzie.
   schemat	Schemat przepływu pracy aplikacji logiki w formacie JavaScript Object Notation (JSON).

   

2. Po zakończeniu wybierz pozycję Utwórz.

   Kreator przywraca Cię do strony Agenci twojego agenta. W sekcji Setup (Konfiguracja ) sekcja Actions (Akcje ) zawiera teraz nazwę narzędzia i ikonę usługi Azure Logic Apps, na przykład:

   

5. 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 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:

   

6. Usuwanie zasobów

Jeśli nie potrzebujesz zasobów utworzonych w tym przewodniku, usuń je, 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. Aby usunąć akcję z agenta w portalu Foundry, obok nazwy akcji wybierz przycisk wielokropka (...), a następnie wybierz 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ń.

1: Ustawianie zmiennych środowiskowych

W systemie ustaw następujące zmienne środowiskowe:

Zmienna środowiskowa	Opis
PROJECT_ENDPOINT	Punkt końcowy projektu Microsoft Foundry. Aby znaleźć tę wartość, w portalu Foundry na pasku bocznym projektu wybierz pozycję Przegląd. Znajdź właściwość o nazwie Punkt końcowy projektu Microsoft Foundry.
MODEL_DEPLOYMENT_NAME	Nazwa wdrożenia modelu AI. Aby znaleźć tę wartość, w portalu Foundry w menu paska bocznego projektu w sekcji Moje zasoby wybierz pozycję Modele i punkty końcowe i poszukaj w kolumnie Nazwa .
SUBSCRIPTION_ID	Identyfikator subskrypcji platformy Azure.
resource_group_name	Nazwa grupy zasobów.

Aby uzyskać przykładowy kod, zobacz:

• Narzędzie AzureLogicAppTool w witrynie GitHub

• Pełny przykład integracji usługi Azure Logic Apps z agentem Foundry

  W tym przykładzie pokazano, jak zintegrować agenta w klasycznym rozwiązaniu Foundry z aplikacją logiki Consumption w portalu Azure.

2: Tworzenie klienta projektu

Aby nawiązać połączenie z projektem Foundry i innymi zasobami, wykonaj następujące kroki, aby utworzyć obiekt klienta:

import os
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Initialize the AIProjectClient
project_client = AIProjectClient(
   endpoint=os.environ["PROJECT_ENDPOINT"],
   credential=DefaultAzureCredential()
)

3. Rejestrowanie aplikacji logiki

Zarejestruj zasób aplikacji logiki zużycia, podając nazwę wyzwalacza oraz informacje o wyzwalaczu. Aby znaleźć AzureLogicAppTool kod narzędzia, odwiedź pełny przykład na GitHubie.

from user_logic_apps import AzureLogicAppTool

# Logic app details
LOGIC_APP_NAME = "your_logic_app_name"
TRIGGER_NAME = "your_trigger_name"

# Register the logic app name with the agent tool utility by extracting the following values from environment variables
subscription_id = os.environ["SUBSCRIPTION_ID"]
resource_group = os.environ["resource_group_name"]

# Create and initialize AzureLogicAppTool utility
logic_app_tool = AzureLogicAppTool(subscription_id, resource_group)
logic_app_tool.register_logic_app(LOGIC_APP_NAME, TRIGGER_NAME)
print(f"Registered logic app '{LOGIC_APP_NAME}' with trigger '{TRIGGER_NAME}'.")

4: Tworzenie agenta z przepływem pracy jako działanie (narzędzie)

Poniższy kod tworzy agenta i dołącza aplikację Logic Apps jako akcję lub narzędzie agenta. W tym przykładzie przepływ pracy aplikacji logicznej wysyła wiadomość e-mail.

from azure.ai.agents.models import ToolSet, FunctionTool
from user_functions import fetch_current_datetime
from user_logic_apps import create_send_email_function

# Create the logic app action for the agent
send_email_func = create_send_email_function(
    logic_app_tool, logic_app_name
)

# Prepare the action tool for the agent
functions_to_use = {fetch_current_datetime, send_email_func}

# Create an agent and assign the toolset
functions = FunctionTool(functions=functions_to_use)
toolset = ToolSet()
toolset.add(functions)

agent = project_client.agents.create_agent(
    model=os.environ["MODEL_DEPLOYMENT_NAME"],
    name="SendEmailAgent",
    instructions="You're a specialized agent for sending emails.",
    toolset=toolset,
)
print(f"Created agent, ID: {agent.id}")

5. Tworzenie wątku na potrzeby komunikacji

Poniższy kod tworzy wątek i dodaje komunikat użytkownika, aby rozpocząć konwersację między klientem projektu a agentem.

# Create a thread for communication
thread = project_client.agents.threads.create()
print(f"Created thread, ID: {thread.id}")

# Create a message in the thread
message = project_client.agents.messages.create(
    thread_id=thread.id,
    role="user",
    content="Hello, send an email to <RECIPIENT_EMAIL> with the date and time in '%Y-%m-%d %H:%M:%S' format.",
)
print(f"Created message, ID: {message['id']}")

6: Przetestuj agenta i akcję

Aby sprawdzić, jak dobrze agent wykonuje zadanie, uruchom agenta, sprawdź, jak model używa narzędzia aplikacji logiki i sprawdź dane wyjściowe.

# Create and run the agent on the thread
run = project_client.agents.runs.create_and_process(
    thread_id=thread.id, agent_id=agent.id
)
print(f"Run finished with status: {run.status}")

if run.status == "failed":
    print(f"Run failed: {run.last_error}")

# Fetch, log, and display all messages
messages = project_client.agents.messages.list(thread_id=thread.id)
for message in messages:
    if msg.txt = msg.text_messages[-1]
    print(f"Role: {msg.role}: {last_text.text.value}")

7. Czyszczenie zasobów

Usuń agenta po zakończeniu korzystania z zasobów, aby nie ponosić dalszych kosztów.

# Delete the agent
project_client.agents.delete_agent(agent.id)
print("Deleted agent.")

Opcjonalnie: Przejrzyj podstawową aplikację logiki i przepływ 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, aby debugować lub rozwiązywać problemy, które mogą wystąpić w przepływie pracy.

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

2. Z listy wyników w obszarze Zasoby wybierz zasób aplikacji logiki.

   

3. Aby wyświetlić historię uruchamiania przepływu pracy, dane wejściowe, dane wyjściowe i inne informacje, na pasku bocznym 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, zobacz Wyświetlanie stanu przepływu pracy i historii uruchamiania.

Opcjonalnie: Otwórz przepływ pracy w projektancie

Aby przejrzeć definicję i operacje przepływu pracy lub edytować przepływ pracy, otwórz projektanta.

1. Na pasku bocznym aplikacji logiki w obszarze Narzędzia programistyczne wybierz projektanta. Jeśli nadal jesteś w widoku monitorowania, na pasku narzędzi widoku monitorowania wybierz pozycję Edytuj.

   Teraz możesz przejrzeć operacje przepływu pracy, które obejmują wyzwalacz i akcje, 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, dodaj więcej akcji.

   Jeśli chcesz, aby jakikolwiek przepływ pracy był wyświetlany w galerii Dodaj akcję aplikacji logiki w Foundry i uruchomiony jako narzędzie agenta, upewnij się, że wszelkie zmiany wprowadzone w przepływie pracy nadal spełniają określone wymagania.

   Ostrzeżenie

   Mimo że można edytować przepływ pracy, nie usuwaj ani nie zmieniaj wyzwalacza żądania ani istniejących akcji w przepływie pracy. W przeciwnym razie ryzykujesz zerwanie relacji między agentem a odpowiednią akcją w narzędziu Foundry i przepływem pracy w witrynie Azure Portal. Te przedmioty mają skonfigurowane parametry, które współpracują ze sobą, więc zmiany w tych operacjach mogą zakłócić działanie 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, które wyzwalacz oczekuje otrzymać w żądaniu HTTPS, dołącz schemat JSON, który określa i który weryfikuje te dane wejściowe, które zewnętrzne wywołania zawierają w swoim żądaniu.

   Aby uzyskać więcej informacji, zobacz Tworzenie przepływu pracy za pomocą wyzwalacza lub akcji.

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

Opcjonalnie: Testowanie zaktualizowanego przepływu pracy w projektancie

Jeśli wprowadzisz zmiany w workflowie pogody lub chcesz przetestować inny workflow, 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. Po zakończeniu 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. Sprawdź dane wejściowe i wyjściowe każdej operacji, korzystając z odpowiednich kroków w temacie Wyświetlanie historii uruchamiania przepływu pracy.

Rozliczenia i ceny

Opłaty są naliczane za przepływy pracy aplikacji logiki typu Consumption na podstawie modelu rozliczeń z płatnością za użycie.

W przypadku usługi Azure Logic Apps zobacz:

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

W przypadku Foundry zobacz następujące zasoby:

• Planowanie kosztów usługi Microsoft Foundry (wersja klasyczna) i zarządzanie nimi
• Cennik rozwiązania Microsoft Foundry

Często zadawane pytania

Jak działa uwierzytelnianie dla wywołań z usługi Foundry do usługi Azure Logic Apps?

Usługa Azure Logic Apps obsługuje następujące typy uwierzytelniania dla wywołań przychodzących z usługi Foundry do wyzwalacza Żądania w przepływie pracy aplikacji logiki:

• Uwierzytelnianie oparte na sygnaturze dostępu współdzielonego (SAS)

  Gdy agent wywołuje akcję uruchamiającą przepływ pracy aplikacji Logic Apps, narzędzie Foundry wysyła żądanie do adresu URL wywołania zwrotnego w wyzwalaczu Request przepływu pracy. Ten adres URL wywołania zwrotnego, który zawiera sygnaturę dostępu współdzielonego (SAS), można uzyskać, korzystając z Workflows - List callback Url z interfejsu API REST dla usługi Azure Logic Apps.

  W przypadku uwierzytelniania za pomocą SAS usługa Azure Logic Apps obsługuje również następujące zadania:

  • Utwórz adresy URL sygnatur dostępu współdzielonego z określonym okresem ważności.
  • Używaj wielu kluczy i obracaj je zgodnie z potrzebami.

  Aby uzyskać więcej informacji, zobacz Generowanie klucza lub tokenu sygnatury dostępu współdzielonego (SAS).

• Zasady uwierzytelniania OAuth oparte na identyfikatorze Entra firmy Microsoft

  Usługa Azure Logic Apps obsługuje uwierzytelnianie dla wywołań wyzwalaczy żądań przy użyciu protokołu OAuth z identyfikatorem Entra firmy Microsoft. Zasady uwierzytelniania można określić do użycia podczas weryfikowania tokenów OAuth. Aby uzyskać więcej informacji, zobacz Enable OAuth 2.0 with Microsoft Entra ID in Azure Logic Apps (Włączanie protokołu OAuth 2.0 przy użyciu identyfikatora Entra firmy Microsoft w usłudze Azure Logic Apps).

Aby uzyskać więcej informacji na temat zabezpieczania wywołań przychodzących w usłudze Azure Logic Apps, zobacz Access for inbound calls to request-based triggers (Dostęp do wywołań przychodzących do wyzwalaczy opartych na żądaniach).

Treści powiązane

• Pełny przykład integracji usługi Azure Logic Apps z agentem Foundry
• Dowiedz się więcej o usłudze Microsoft Foundry
• Dowiedz się więcej o usłudze Azure Logic Apps