Microsoft Visual Studio Code 대한 Microsoft Copilot Studio 확장 설치

필수 조건

Microsoft Visual Studio Code Microsoft Copilot Studio 확장을 설치하기 전에 다음 요구 사항을 충족하는지 확인합니다.

시스템 요구 사항

  • 운영 체제:
    • Windows(x64 아키텍처)
      • Windows 10 버전 1809 이상
      • Windows 11(모든 버전)
    • macOS
  • Visual Studio Code: 버전 1.80 이상(안정적인 최신 버전 권장)
  • 인터넷 연결: 설치 및 인증에 필수

계정 요구 사항

  • Microsoft 계정: Copilot Studio 라이선스 또는 액세스 권한이 있는 활성 Microsoft 계정
  • Copilot Studio 라이선스: 계정에 할당된 적절한 라이선스
  • 환경 액세스: 하나 이상의 Copilot Studio 환경에 액세스할 수 있는 권한
  • 에이전트 권한: 편집하려는 에이전트에 대한 읽기 및 쓰기 권한

설치 단계

Visual Studio Code Copilot Studio 확장을 설치하는 방법에는 두 가지가 있습니다.

  • Visual Studio 코드 내에서 설치
  • Visual Studio Code Marketplace 웹 사이트에서 설치

방법 1: Visual Studio Code에서 설치하기

  1. 활동 바에서 확장 기능 아이콘을 선택하거나 Ctrl+Shift+X를 누르세요. Visual Studio Code Extensions 창이 열립니다.

  2. 검색 창에서 "Copilot Studio"를 입력합니다. 결과 목록에서 공식 Copilot Studio 확장을 찾습니다. 출판사가 "Microsoft"인지 확인하세요.

  3. 올바른 확장 프로그램을 찾으면 선택해서 확장 기능 상세 페이지를 열어보세요.

  4. 설치 를 선택 해 설치를 시작하세요.

  5. 설치가 완료되기를 기다립니다. Visual Studio Code 다시 로드하라는 메시지가 표시될 수 있습니다. 이 경우 메시지가 표시되면 Reload 선택합니다.

  6. 설치 상태를 확인하세요. 작업 표시줄에서 Copilot Studio 아이콘을 찾습니다. Copilot Studio 브랜딩과 함께 아이콘이 나타납니다.

방법 2: Visual Studio Code Marketplace 웹 사이트에서 설치

  1. https://marketplace.visualstudio.com/ 이동하여 "Copilot Studio"를 검색합니다. https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio 직접 링크를 사용할 수도 있습니다.

  2. 마켓플레이스 페이지에서 설치 를 선택하세요. 브라우저 프롬프트에서 Visual Studio Code 열도록 요청하기 전에 Visual Studio Code 다운로드하라는 메시지가 표시될 수 있습니다.

  3. 활동 표시줄에서 확장 아이콘을 찾아 브라우저에서 Visual Studio Code 열고 설치를 확인하도록 허용합니다.

초기 구성

첫 번째 발사

  1. 작업 표시줄에서 Copilot Studio 아이콘을 선택합니다. 확장 기능은 애플리케이션 창으로 열립니다. Copilot Studio 확장에서 로그인해야 함을 나타내는 팝업 알림이 표시됩니다.

  2. 팝업에서 로그인을 선택한 후 허용을 선택하세요. 기본 브라우저는 Microsoft 인증 페이지로 열립니다.

  3. 인증 자격 증명을 입력하고 필요하다면 다중 인증을 완료하세요.

  4. 요청된 권한 사항을 검토하세요:

    • Copilot Studio 에이전트 읽기 및 쓰기
    • 환경 정보 접근
    • 파일을 클라우드에 동기화하기

    수락 또는 허용을 선택하세요. 브라우저에서 창을 닫고 Visual Studio Code 돌아갈 수 있다는 메시지가 표시됩니다.

  5. Visual Studio Code로 돌아가세요. 확장 창은 접근 가능한 환경과 그 환경 내 에이전트들을 불러옵니다.

성공적인 설정 확인

인증 후에는 Visual Studio Code Copilot Studio 확장의 Agents 창 아래에 구조가 표시됩니다. 다음과 같은 구조와 유사한 중첩된 환경과 에이전트가 포함된 환경 그룹 목록을 보게 될 것입니다:

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

설치 문제 해결

다음은 Copilot Studio Visual Studio Code 확장을 설치하거나 구성할 때 발생할 수 있는 몇 가지 문제에 대한 문제 해결 단계입니다.

연장이 나타나지 않습니다

Problem: Copilot Studio 아이콘이 작업 표시줄에 나타나지 않습니다.

Solution:

  1. Visual Studio Code 다시 로드
  2. 확장 프로그램을 선택하고 설치 목록에서 확장 프로그램을 찾으세요. 확장 프로그램이 비활성화되어 있지 않은지 확인하세요.
  3. Visual Studio Code 최신 버전으로 업데이트합니다.
  4. 확장 프로그램을 다시 설치하세요.

인증 실패

문제: 인증이 실패하거나 반복적으로 반복됩니다.

Solution:

  1. 브라우저의 캐시 및 쿠키를 microsoft.com에서 삭제하세요.

  2. 다른 브라우저로 로그인해 보세요. 이 브라우저를 임시로 기본값으로 설정하세요.

  3. 인증을 차단할 수 있는 브라우저 확장 프로그램을 비활성화하세요.

  4. 기업 방화벽과 프록시 설정을 확인하세요.

  5. 지원되는 계정 유형을 사용하고 있는지 꼭 확인하세요.

Visual Studio Code Marketplace에서 확장을 찾을 수 없음

Problem: 검색할 때 Copilot Studio 확장을 찾을 수 없습니다.

Solution:

  1. 웹 검색이 아니라 확장 프로그램 창에서 검색하는지 꼭 확인하세요.

  2. 맞춤법 검사: "Copilot Studio."

  3. 관리자에게 문의하여 조직에서 Visual Studio Code 마켓플레이스 액세스를 제한하는지 확인합니다.

확장 제거

확장을 제거하려면:

  1. 확장 창을 열어보세요.

  2. 설치된 확장에서 Copilot Studio 찾습니다.

  3. 목록 항목에서'관리 (기어 아이콘) >삭제'를 선택하세요.

  4. 메시지가 표시되면 Visual Studio Code 다시 로드합니다.

비고

확장 프로그램을 삭제해도 로컬에 복제된 에이전트 파일이 삭제되지 않습니다. 이 파일은 수동으로 제거해야 합니다.

다음 단계

확장을 설치하고 Copilot Studio에서 인증한 후 다음을 수행할 준비가 되었습니다.

  • Last updated on