Instalowanie rozszerzenia Microsoft Copilot Studio dla usługi Microsoft Visual Studio Code

Wymagania wstępne

Przed zainstalowaniem rozszerzenia Microsoft Copilot Studio dla usługi Microsoft Visual Studio Code upewnij się, że spełniasz następujące wymagania:

Wymagania systemowe

  • System operacyjny:
    • Windows (architektura x64)
      • Windows 10 w wersji 1809 lub nowszej
      • Windows 11 (dowolna wersja)
    • macOS
  • Visual Studio Code: wersja 1.80 lub nowsza (zalecana najnowsza stabilna wersja)
  • Połączenie internetowe: Wymagane do instalacji i uwierzytelniania

Wymagania dotyczące konta

  • Konto Microsoft: Aktywne konto Microsoft z licencją lub dostępem do Copilot Studio
  • Copilot Studio license: Odpowiednia licencja przypisana do konta
  • Environment access: Uprawnienia do dostępu do co najmniej jednego środowiska Copilot Studio
  • Uprawnienia agenta: Dostęp do odczytu i zapisu do agentów, których planujesz edytować

Kroki instalacji

Istnieją dwa sposoby instalowania rozszerzenia programu Copilot Studio w Visual Studio Code:

  • Instalowanie z poziomu kodu Visual Studio
  • Instalowanie z witryny Visual Studio Code Marketplace

Metoda 1. Instalowanie z Visual Studio Code

  1. Wybierz ikonę Rozszerzenia na pasku aktywności lub naciśnij Ctrl+Shift+X. W Visual Studio Code zostanie otwarte okienko Extensions.

  2. Na pasku wyszukiwania wprowadź ciąg "Copilot Studio". Poszukaj oficjalnego rozszerzenia Copilot Studio na liście wyników. Sprawdź, czy wydawcą jest "Microsoft."

  3. Gdy znajdziesz właściwe rozszerzenie, wybierz je, aby otworzyć stronę szczegółów rozszerzenia.

  4. Wybierz Zainstaluj, aby rozpocząć instalację.

  5. Poczekaj na ukończenie instalacji. Jeśli pojawi się monit o ponowne załadowanie Visual Studio Code, wybierz opcję Reload.

  6. Sprawdź instalację. Wyszukaj ikonę Copilot Studio na pasku działań. Zostanie wyświetlona ikona z marką Copilot Studio.

Metoda 2: Instalowanie z witryny Visual Studio Code Marketplace

  1. Przejdź do https://marketplace.visualstudio.com/ i wyszukaj "Copilot Studio". Możesz również użyć bezpośredniego linku: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

  2. Wybierz Install na stronie marketplace. Komunikaty przeglądarki mogą zasugerować pobranie Visual Studio Code, zanim poproszą o jego otwarcie.

  3. Zezwól przeglądarce na otwieranie Visual Studio Code i potwierdzanie instalacji, wyszukując ikonę rozszerzenia na pasku działań.

Konfiguracja początkowa

Pierwszy start

  1. Wybierz ikonę Copilot Studio na pasku działań. Rozszerzenie otwiera się jako panel aplikacji. Zostanie wyświetlone wyskakujące powiadomienie wskazujące, że rozszerzenie Copilot Studio wymaga zalogowania się.

  2. Wybierz Zaloguj się w okienku, a następnie wybierz Pozwól. Domyślna przeglądarka otwiera stronę uwierzytelniania Microsoft.

  3. Wprowadź swoje dane uwierzytelniające i w razie potrzeby wykonaj uwierzytelnianie wieloskładnikowe.

  4. Przejrzyj żądane uprawnienia:

    • Odczytywanie i zapisywanie agentów funkcji Copilot Studio
    • Informacje o środowisku dostępu
    • Synchronizuj pliki do chmury

    Wybierz Zaakceptuj lub Pozwól. W przeglądarce zostanie wyświetlony monit o zamknięcie okna i powrót do Visual Studio Code.

  5. Wróć do programu Visual Studio Code. Panel rozszerzenia ładuje środowiska, do których masz dostęp, oraz agentów w tych środowiskach.

Sprawdź pomyślne ustawienie

Po uwierzytelnieniu powinna zostać wyświetlona struktura w okienku Agents w rozszerzeniu Copilot Studio w Visual Studio Code. Powinna być widoczna lista grup środowiskowych z zagnieżdżonymi środowiskami i agentami, podobna do następującej struktury:

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

Rozwiązywanie problemów z instalacją

Poniżej przedstawiono kroki rozwiązywania niektórych problemów, które mogą wystąpić podczas instalowania lub konfigurowania rozszerzenia Visual Studio Code programu Copilot Studio.

Rozszerzenie nie pojawia się

Problem: Ikona programu Copilot Studio nie jest wyświetlana na pasku działań.

Rozwiązanie:

  1. Załaduj ponownie Visual Studio Code
  2. Wybierz Rozszerzenia i wyszukaj to rozszerzenie na liście Zainstalowanych . Upewnij się, że rozszerzenie nie jest wyłączone.
  3. Zaktualizuj Visual Studio Code do najnowszej wersji.
  4. Zainstaluj rozszerzenie ponownie.

Błędy uwierzytelniania

Problem: Uwierzytelnianie zawodzi lub powtarza się wielokrotnie.

Rozwiązanie:

  1. Wyczyść pamięć podręczną przeglądarki i pliki cookie dla microsoft.com.

  2. Spróbuj zalogować się za pomocą innej przeglądarki. Tymczasowo ustaw tę przeglądarkę jako domyślną.

  3. Wyłącz rozszerzenia do przeglądarek, które mogą blokować uwierzytelnianie.

  4. Sprawdź korporacyjne ustawienia zapory sieciowej i proxy.

  5. Upewnij się, że używasz obsługiwanego typu konta.

Nie można odnaleźć rozszerzenia w witrynie Visual Studio Code Marketplace

Problem: Nie można odnaleźć rozszerzenia Copilot Studio podczas wyszukiwania.

Rozwiązanie:

  1. Upewnij się, że szukasz w panelu Rozszerzenia , a nie w internecie.

  2. Sprawdź pisownię: "Copilot Studio".

  3. Skonsultuj się z administratorem, aby sprawdzić, czy Twoja organizacja ogranicza dostęp do witryny Visual Studio Code Marketplace.

Odinstalowywanie rozszerzenia

Aby usunąć rozszerzenie:

  1. Otwórz panel Rozszerzenia.

  2. Znajdź Copilot Studio w zainstalowanych rozszerzeniach.

  3. W wpisie na liście wybierzZarządzaj (ikona sprzętu) >Odinstaluj.

  4. Zrestartuj Visual Studio Code po wyświetleniu komunikatu.

Uwaga / Notatka

Odinstalowanie rozszerzenia nie usuwa lokalnie sklonowanych plików agentów. Musisz usunąć te pliki ręcznie.

Dalsze kroki

Po zainstalowaniu rozszerzenia i uwierzytelnieniu za pomocą programu Copilot Studio możesz wykonać następujące działania:

  • Last updated on