Microsoft Foundry Toolkit에서 선언적 에이전트 워크플로 사용 및 마이그레이션

Visual Studio Code Microsoft Foundry Toolkit을 사용하여 기존 선언적 워크플로를 사용하고 마이그레이션을 준비합니다. 저장된 워크플로를 테스트하고, 내보낸 YAML을 편집하고, GitHub Copilot 사용하여 정의를 Microsoft Agent Framework 코드로 변환할 수 있습니다.

중요합니다

Microsoft Foundry의 선언적 워크플로는 2026년 12월 1일에 미리 보기로 제공되며 사용 중지됩니다. 새 워크플로 개발을 위해 Microsoft Agent Framework를 사용합니다. 이 사용 중지는 호스트된 에이전트의 코드 기반 오케스트레이션에 영향을 주지 않습니다. 지원되는 마이그레이션 경로는 워크플로 마이그레이션 가이드 를 참조하세요.

사전 요구 사항

선언적 에이전트 워크플로 보기

프로젝트의 통합 에이전트 목록에서 워크플로를 찾습니다.

  1. Foundry 도구 키트 보기의 내 리소스 아래에서 선택한 Foundry 프로젝트를 확인합니다.
  2. 에이전트를 선택한 다음 워크플로 탭을 선택합니다.
  3. 워크플로 이름을 선택하여 해당 플레이그라운드를 엽니다.
  4. 버전 선택기를 사용하여 검사할 저장된 버전을 선택합니다.

플레이그라운드에는 워크플로 그래프와 대화 영역이 표시됩니다. 그래프는 읽기 전용입니다. 내보낸 YAML 또는 Foundry 포털을 사용하여 정의를 편집합니다.

기존 워크플로 정의 편집

정의를 편집하거나 마이그레이션하기 전에 내보냅니다. 변경 내용과 비교할 수 있도록 원본 YAML의 복사본을 유지합니다.

  1. Foundry 포털에서 기존 워크플로를 엽니다.
  2. 워크플로 디자이너에서 YAML 보기로 전환하고 정의를 복사하거나 내보냅니다. 자세한 내용은 워크플로 정의 내보내기(Export Your Workflow Definition)를 참조하세요.
  3. 로컬 작업 영역에 정의가 끝나는 .workflow.yaml이름으로 저장합니다(예: support.workflow.yaml.).
  4. Visual Studio Code 파일을 열고 YAML을 편집합니다.
  5. 파일을 저장합니다. 로컬 파일 변경은 Foundry의 워크플로를 업데이트하지 않습니다.

기존 워크플로의 새 버전 저장

사용 중지하기 전에 편집된 정의를 동일한 워크플로에 배포할 수 있습니다. 다른 리소스를 만들지 않도록 프로젝트 및 워크플로 이름을 확인합니다.

  1. Foundry 도구 키트에서 원래 워크플로의 프로젝트가 선택되어 있는지 확인합니다.
  2. .workflow.yaml 파일이 열려 있는 상태에서 편집기 도구 모음에서 배포를 선택합니다.
  3. Enter 워크플로 이름에 기존 워크플로의 이름을 입력합니다.
  4. 배포 성공 알림을 기다립니다.
  5. 에이전트 워크플로에서 워크플로 를>다시 열고 새 버전을 선택합니다.

기존 워크플로 이름을 사용하여 배포하면 새 버전이 만들어집니다. 다른 이름은 별도의 워크플로를 만듭니다. 이 경로를 사용하여 새 워크플로 개발을 시작하지 마세요.

플레이그라운드에서 워크플로 테스트

유지 관리 또는 마이그레이션하려는 저장된 버전을 테스트합니다. 나중에 동일한 요청을 사용하여 마이그레이션된 구현을 비교합니다.

  1. 워크플로의 플레이그라운드를 열고 필요한 버전을 선택합니다.
  2. 플레이그라운드 탭에서 새로 만들기를 선택하여 새 플레이그라운드 세션을 시작합니다.
  3. 워크플로를 연습하는 요청을 입력하고 보냅니다.
  4. 응답 및 실행 그래프를 검토합니다. 예상된 에이전트, 분기 및 단계가 실행되는지 확인합니다.
  5. 서로 다른 분기를 테스트하는 요청, 입력이 누락된 경우, 그리고 워크플로에 있는 승인 단계에 대해서도 반복하세요.

플레이그라운드는 저장된 Foundry 워크플로를 실행합니다. 로컬 YAML 파일 또는 Copilot 생성하는 코드에서 저장되지 않은 변경 내용은 실행되지 않습니다.

YAML 워크플로를 에이전트 프레임워크 코드로 변환

플레이그라운드의 코드 생성 작업을 사용하여 GitHub Copilot 선택한 워크플로 정의를 변환하도록 요청합니다. 생성된 코드는 검토하고 테스트해야 하는 시작점입니다.

  1. 워크플로 플레이그라운드에서 마이그레이션할 버전을 선택합니다.
  2. 코드 생성을 선택합니다.
  3. Python 또는 C#을 선택합니다.
  4. Copilot Chat 변환 요청을 검토하고 해당 프롬프트에 따라 코드를 생성합니다.
  5. 생성된 프로젝트, 종속성, 모델 연결, 도구 및 인증 구성을 검토합니다.
  6. 내보낸 YAML과 해당 오케스트레이션을 비교하세요. 분기, 변수, 에이전트 호출 및 사용자 승인 단계를 확인합니다.
  7. 코드를 로컬로 실행하고 원래 워크플로에 사용한 요청으로 테스트합니다. 에이전트 검사기를 사용하여 실행을 검사합니다.
  8. 코드가 필요에 따라 동작하는 경우 호스트된 에이전트 만들기 에 따라 지원되는 호스트 에이전트 프로젝트를 준비하고, 배포하고, 배포된 버전을 테스트합니다.

코드 변환은 호스트된 에이전트를 배포하거나 동등한 동작을 보장하지 않습니다. 마이그레이션을 완료하고 종속 애플리케이션에서 대체를 사용하는지 확인할 때까지 원래 정의를 유지합니다.

에이전트 프레임워크 선언적 YAML, Azure Logic Apps 및 직접 A2A 연결을 비롯한 다른 마이그레이션 선택은 워크플로 마이그레이션 가이드를 참조하세요.

관련 콘텐츠

다음 가이드를 사용하여 마이그레이션을 선택하고 완료합니다.

  • Last updated on