Microsoft Visual Studio Code에서 Microsoft Copilot Studio 에이전트를 복제하세요.

확장을 사용하여 Microsoft Copilot Studio 에이전트를 복제하는 경우 Copilot Studio에서 로컬 컴퓨터로 에이전트 정의 및 관련 구성 요소 정의를 다운로드합니다. Microsoft Visual Studio Code 사용하여 이러한 파일을 편집할 수 있습니다. 복제 작업은 모든 에이전트 파일이 구조화된 디렉터리 형식으로 포함된 로컬 작업 공간을 생성합니다.

필수 조건

복제 에이전트를 시작하기 전에 몇 가지 중요한 전제 조건과 고려사항이 있습니다.

작업 공간 위치 선택

에이전트 파일을 위한 적절한 로컬 폴더를 선택하세요. 이 위치에 확장 프로그램이 에이전트 파일을 저장합니다. 장소를 선택할 때 중요한 팁을 소개합니다:

  • 충분한 디스크 공간을 확보하세요. 일반적인 에이전트는 구성 요소 수에 따라 크기가 다양할 수 있습니다.
  • 가능하다면 공백이 없는 경로를 사용하세요. 다만 공백은 지원됩니다.
  • 이미 Git에서 추적되는 위치를 사용하는 것을 고려해 보세요.

무엇이 복제되는지 이해하세요

에이전트를 복제하면 에이전트 파일이 선택한 위치에 로컬로 복제되어 Visual Studio Code 탐색기에서 다음과 같은 구조 정의를 만듭니다.

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

복제 방법

처음으로 확장을 사용하거나 Visual Studio Code 처음 사용하는 경우 에이전트를 복제하는 가장 쉬운 방법은 Extension 창이 열려 있을 때 Clone Agent 선택하는 것입니다. 하지만 이미 에이전트를 복제해 로컬에서 열어둔 경우에는 이 옵션이 불가능합니다. 대신 다음 방법들을 사용할 수 있습니다:

이것이 에이전트를 복제하는 가장 직관적이고 권장되는 방법입니다.

  1. 작업 표시줄에서 Copilot Studio 아이콘을 선택하여 Copilot Studio 확장을 엽니다. Ctrl+Shift+P 키를 누르고 "Copilot Studio: 에이전트 보기에 포커스"를 입력할 수도 있습니다. Copilot Studio 창이 사이드바에서 열립니다.

  2. 에이전트 창에서 드롭다운 리스트(예: "환경 1")에서 대상 환경을 선택하면 환경 내 에이전트 목록을 볼 수 있습니다.

    > Environment 1
  Environment 2
  Environment 3

  3. 목록에서 복제할 에이전트를 선택하세요. 요원들은 마지막 수정 날짜를 표시합니다. 에이전트 이름을 우클릭하고 클론 에이전트를 선택하세요.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    파일 선택기 대화상자가 열립니다.

  4. 파일 선택 대화상자에서 원하는 위치로 이동하거나 새 폴더를 만들고 ' 폴더 선택'을 선택하세요. 복제 과정이 시작됩니다.

  5. 복제 과정이 완료될 때까지 기다려. 진행 상황 알림이 "복제 에이전트: 고객 지원 봇"과 함께 "에이전트 성공적으로 복제됨"이라는 성공 메시지가 나타납니다. 이 과정은 보통 10-30초 정도 걸립니다.

  6. 복제가 성공적으로 완료되었는지 확인하세요. 에이전트 폴더가 Visual Studio Code 탐색기에서 열리고 소스 제어 창에 깨끗한 작업 트리가 표시되고 파일 창에 폴더 이름이 표시됩니다.

방법 3: 명령 팔레트를 이용한 복제

키보드 중심 워크플로우를 선호한다면 이 방법을 사용하세요.

  1. 명령 팔레트를 열려면 Ctrl+Shift+P 키를 누르세요.

  2. "Copilot Studio: Clone Agent"를 입력한 후 Enter 누릅니다. 명령어가 실행되고 프롬프트가 나타납니다.

  3. 환경을 선택하고, 에이전트를 선택하고, 목적지 폴더를 선택한 후 복제가 완료될 때까지 기다리는 안내를 따라가세요. 에이전트는 선택한 위치에 복제됩니다.

방법 3: 에이전트 URL을 이용한 복제

이 방법은 누군가가 에이전트 URL을 공유할 때 유용합니다.

  1. Copilot Studio 웹 포털에서 에이전트를 엽니다.

  2. 설정>에이전트 세부 정보를 선택한 후 에이전트 URL을 복사하세요. URL의 형식은 다음과 같아야 합니다: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. URL은 이제 당신의 클립보드에 있습니다.

  3. Visual Studio Code 돌아가서 Copilot Studio 확장을 엽니다.

  4. 클론에이전트를 선택하세요. 확장 프로그램은 클립보드 내 URL을 감지하고 "(from clipboard)"로 표시된 에이전트를 표시합니다.

  5. "(클립보드에서)"로 표시된 에이전트를 선택하고, 목적지 폴더를 선택한 후 복제가 완료될 때까지 기다리세요. 에이전트는 선택한 위치에 복제됩니다.

일반적인 복제 시나리오

다음은 에이전트 복제가 유용한 몇 가지 일반적인 시나리오와 제안된 워크플로우에 대한 고수준 세부사항을 소개합니다.

시나리오 1: 솔로 개발을 위한 클론

목표: 혼자서 에이전트를 작업하세요

  1. 에이전트를 로컬 폴더에 복제하세요.

  2. 내비게이션에서 Source Control에서 Git 저장소를 초기화하세요.

  3. 로컬에서 변경합니다.

  4. 커밋을 완료하세요.

  5. 준비가 되면 변경 내용을 Copilot Studio에 적용합니다.

시나리오 2: 팀 협업을 위한 복제

목표: 여러 개발자가 같은 에이전트를 작업하고 있습니다

  1. 첫 번째 개발자가 에이전트를 복제합니다.

  2. 첫 번째 개발자는 Git을 초기화하고 콘텐츠를 공유 리포지토리(GitHub, Azure DevOps)에 푸시합니다.

  3. 다른 개발자들은 공유 Git 저장소에서 복제합니다.

  4. 각 개발자는 Copilot Studio: 에이전트 다시 연결을 실행하여 로컬 폴더를 Copilot Studio에 연결합니다.

  5. 팀은 Git을 사용하여 공동 작업 및 변경 내용을 추적하고 Visual Studio Code 확장을 사용하여 에이전트에서 작업합니다.

  6. 그런 다음 각 개발자는 테스트를 위해 Copilot Studio에 변경 내용을 적용하거나 소프트웨어 개발 수명 주기 또는 자동화된 파이프라인에 따라 다른 다운스트림 환경으로 푸시합니다.

시나리오 3: 여러 환경 복제

목표: 개발, 테스트, 생산 버전 관리

여러 환경 배포를 위한 권장 접근법은 솔루션을 사용하는 것입니다. 파이프라인과 같이 감사 가능하고 확장 가능한 조직 프로세스가 포함된 자동화된 배포 프로세스를 고려해 보십시오. 솔루션을 사용하지 않도록 선택한 사용자의 경우 Copilot Studio 확장은 로컬 컴퓨터에서 다른 환경으로 Copilot Studio 에이전트 정의를 동기화하는 기능을 제공합니다. 고객 및 최종 사용자를 위한 소프트웨어를 출시할 때 소프트웨어 개발 수명주기 내에서 감사, 텔레메트리 및 기타 중요한 구성 요소를 제공하기 위해 기술 자산을 하위 환경으로 이전하는 조직 프로세스를 고려해야 합니다.

  1. 개발 환경에서 에이전트를 로컬 개발 폴더로 복제하세요.

  2. 개발 폴더에서 변경을 하세요.

  3. 그 변경 사항을 적용하고 같은 환경에서 테스트하세요.

  4. Copilot Studio: 에이전트 다시 연결을 사용하여 에이전트를 대체 환경에 연결합니다.

  5. Copilot Studio 테스트 창에서 에이전트를 테스트합니다.

모범 사례

실행

  • 모든 요원을 일관된 위치로 복제하세요.
  • 복제 직후 바로 Git을 초기화하세요.
  • 의미 있는 폴더 이름을 사용하세요.
  • 변경하기 전에 복제본이 제대로 작동하는지 확인하세요.
  • 복제 위치를 백업된 상태로 유지합니다(예: GitHub 또는 Azure DevOps).
  • 내부 팀 위키나 문서에 복제 위치를 문서화하세요.

하지 마세요

  • 임시 디렉터리로 복제하지 마세요.
  • 여러 번 다른 위치로 복제하지 마세요. 그렇게 하면 혼란을 일으킬 수 있습니다.

다음 단계

에이전트를 복제한 후:

  • Last updated on