Używanie i migrowanie przepływów pracy agenta deklaratywnego za pomocą zestawu narzędzi Microsoft Foundry Toolkit

Użyj zestawu narzędzi Microsoft Foundry Toolkit for Visual Studio Code do pracy z istniejącymi przepływami pracy deklaratywnych i przygotuj je do migracji. Możesz przetestować zapisany przepływ pracy, edytować wyeksportowany kod YAML i użyć GitHub Copilot, aby pomóc przekonwertować definicję na kod platformy agenta Microsoft.

Ważna

Deklaratywne przepływy pracy w Microsoft Foundry są obecnie dostępne w wersji zapoznawczej i zostaną wycofane 1 grudnia 2026 r. Użyj platformy Microsoft Agent Framework do tworzenia nowych przepływów pracy. To wycofanie nie ma wpływu na orkiestrację opartą na kodzie w agentach hostowanych. Zapoznaj się z przewodnikiem migracji przepływu pracy , aby zapoznać się z obsługiwanymi ścieżkami migracji.

Wymagania wstępne

Wyświetlanie przepływu pracy agenta deklaratywnego

Znajdź przepływ pracy na liście skonsolidowanych agentów projektu.

  1. W widoku Zestawu narzędzi Foundry w obszarze Moje zasoby potwierdź wybrany projekt Foundry.
  2. Wybierz pozycję Agenci, a następnie wybierz kartę Przepływ pracy .
  3. Wybierz nazwę przepływu pracy, aby otworzyć jego środowisko testowe.
  4. Użyj selektora wersji, aby wybrać zapisaną wersję, którą chcesz sprawdzić.

Plac zabaw przedstawia wykres przepływu pracy i obszar konwersacji. Wykres jest tylko do odczytu. Użyj wyeksportowanego pliku YAML lub portalu Foundry, aby edytować definicję.

Edytowanie istniejącej definicji przepływu pracy

Wyeksportuj definicję przed jego edytowaniem lub migracją. Zachowaj kopię oryginalnego kodu YAML, aby można było porównać go ze zmianami.

  1. Otwórz istniejący przepływ pracy w portalu Foundry.
  2. W projektancie przepływu pracy przejdź do widoku YAML i skopiuj lub wyeksportuj definicję. Aby uzyskać szczegółowe informacje, zobacz Eksportowanie definicji przepływu pracy.
  3. Zapisz definicję w lokalnym obszarze roboczym z nazwą kończącą się na .workflow.yaml, na przykład support.workflow.yaml.
  4. Otwórz plik w Visual Studio Code i edytuj plik YAML.
  5. Zapisz plik. Zmiany plików lokalnych nie aktualizują przepływu pracy w rozwiązaniu Foundry.

Zapisywanie nowej wersji istniejącego przepływu pracy

Przed wycofaniem można wdrożyć edytowaną definicję do tego samego przepływu pracy. Potwierdź nazwę projektu i przepływu pracy, aby uniknąć tworzenia innego zasobu.

  1. Upewnij się, że projekt oryginalnego przepływu pracy został wybrany w narzędziu Foundry Toolkit.
  2. Po otwarciu .workflow.yaml pliku wybierz pozycję Wdróż na pasku narzędzi edytora.
  3. W polu Wprowadź nazwę przepływu pracy wprowadź nazwę istniejącego przepływu pracy.
  4. Poczekaj na powiadomienie o powodzeniu wdrożenia.
  5. Otwórz ponownie przepływ pracy z sekcji Agenci> i wybierz nową wersję.

Wdrażanie przy użyciu istniejącej nazwy przepływu pracy powoduje utworzenie nowej wersji. Inna nazwa tworzy oddzielny przepływ pracy; Nie używaj tej ścieżki do rozpoczęcia tworzenia nowego przepływu pracy.

Testowanie przepływu pracy na placu zabaw

Przetestuj zapisaną wersję, którą planujesz zachować lub przeprowadzić migrację. Później użyj tych samych żądań, aby porównać zmigrowaną implementację.

  1. Otwórz środowisko testowe przepływu pracy i wybierz wymaganą wersję.
  2. Na karcie Plac zabaw wybierz pozycję Nowy , aby rozpocząć nową sesję placu zabaw.
  3. Wprowadź żądanie, które uruchamia przepływ pracy, i wyślij je.
  4. Przejrzyj odpowiedź i graf wykonania. Upewnij się, że oczekiwani agenci, gałęzie i kroki są uruchamiane.
  5. Powtórz to, używając żądań, które obejmują różne ścieżki, przypadki z brakującymi danymi wejściowymi oraz wszelkie etapy zatwierdzania w przepływie pracy.

Plac zabaw uruchamia zapisany przepływ pracy foundry. Nie uruchamia niezapisanych zmian w lokalnym pliku YAML lub kodzie, który Copilot generuje.

Konwertowanie przepływu pracy YAML na kod platformy Agent Framework

Użyj akcji generowania kodu w playgroundzie, aby poprosić GitHub Copilot o przekształcenie wybranej definicji przepływu pracy. Wygenerowany kod to punkt wyjścia, który należy przejrzeć i przetestować.

  1. W środowisku testowym przepływu pracy wybierz wersję do migracji.
  2. Wybierz pozycję Generuj kod.
  3. Wybierz Python lub C#.
  4. Przejrzyj żądanie konwersji w Copilot Chat i postępuj zgodnie z monitami, aby wygenerować kod.
  5. Przejrzyj wygenerowany projekt, zależności, połączenia modelu, narzędzia i konfigurację uwierzytelniania.
  6. Porównaj aranżację z wyeksportowanym kodem YAML. Sprawdź rozgałęzianie, zmienne, wywołania agenta i etapy wymagające zatwierdzenia przez człowieka.
  7. Uruchom kod lokalnie i przetestuj go przy użyciu żądań użytych do oryginalnego przepływu pracy. Użyj Inspektora agenta do sprawdzenia wykonania.
  8. Gdy kod działa zgodnie z wymaganiami, postępuj zgodnie z instrukcjami Tworzenie hostowanych agentów , aby przygotować obsługiwany projekt hostowanego agenta, wdrożyć go i przetestować wdrożoną wersję.

Konwersja kodu nie wdraża hostowanego agenta ani nie gwarantuje równoważnego zachowania. Zachowaj oryginalną definicję do momentu ukończenia migracji i upewnij się, że aplikacje zależne używają zamiany.

Informacje o innych opcjach migracji, w tym o deklaratywnym kodzie YAML platformy Agent Framework, usłudze Azure Logic Apps i bezpośrednich połączeniach A2A, znajdziesz w przewodniku po migracji przepływów pracy.

Treści powiązane

Skorzystaj z tych przewodników, aby wybrać i ukończyć migrację:

  • Last updated on