Sklonuj swojego agenta Microsoft Copilot Studio w Microsoft Visual Studio Code

Podczas klonowania agenta z Microsoft Copilot Studio przy użyciu rozszerzenia pobierasz definicję agenta i powiązane definicje składników z programu Copilot Studio na komputer lokalny. Te pliki można edytować przy użyciu usługi Microsoft Visual Studio Code. Operacja klonowania tworzy lokalną przestrzeń roboczą ze wszystkimi plikami agentów w ustrukturyzowanym formacie katalogu.

Wymagania wstępne

Zanim zaczniesz klonować agenty, istnieją ważne wymagania wstępne i kwestie do rozważenia.

Wybierz lokalizację miejsca pracy

Wybierz odpowiedni lokalny folder dla plików agenta. To właśnie w tym miejscu rozszerzenie zapisuje pliki agenta. Oto kilka ważnych wskazówek dotyczących wyboru lokalizacji:

  • Zadbaj o odpowiednią ilość miejsca na dysku. Typowy agent może mieć różne rozmiary w zależności od liczby komponentów.
  • Jeśli to możliwe, używaj ścieżki bez spacji, choć spacje są obsługiwane.
  • Rozważ użycie lokalizacji, która jest już śledzona przez Gita.

Zrozum, co jest klonowane

Podczas klonowania agenta pliki agenta są klonowane lokalnie w wybranej lokalizacji, tworząc definicję struktury podobną do następującej w eksploratorze 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

Metody klonowania

Jeśli używasz rozszerzenia po raz pierwszy, a nawet nowego do Visual Studio Code, najprostszym sposobem sklonowania agenta jest wybranie Clone Agent gdy zostanie otwarte okienko Extension. Jednak ta opcja nie jest dostępna, gdy masz już sklonowanego i otwartego agenta lokalnie. Zamiast tego można zastosować następujące metody:

To najprostsza i najbardziej zalecana metoda klonowania agenta.

  1. Otwórz rozszerzenie Copilot Studio, wybierając ikonę Copilot Studio na pasku działań. Możesz również nacisnąć Ctrl+Shift+P i wprowadzić "Copilot Studio: Focus on Agents View". Okienko Copilot Studio otworzy się na pasku bocznym.

  2. W panelu Agenci wybierz środowisko docelowe z listy rozwijanej (na przykład "Środowisko 1"), aby zobaczyć listę agentów w środowisku.

    > Environment 1
  Environment 2
  Environment 3

  3. Wybierz agenta do klonowania z listy. Agenty wyświetlają ostatnią datę ich modyfikacji. Kliknij prawym przyciskiem myszy na nazwę agenta i wybierz Sklonuj agenta.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    Otwiera się okno dialogowe do wyboru plików.

  4. Przejdź do wybranej lokalizacji w oknie wyboru plików lub utwórz nowy folder i wybierz Wybierz folder. Proces klonowania się rozpoczyna.

  5. Poczekaj, aż proces klonowania się zakończy. Pojawia się powiadomienie o postępie z informacją "Klonowanie agenta: Bot obsługi klienta", a następnie komunikat o sukcesie "Agent sklonował się pomyślnie." Ten proces zwykle trwa 10-30 sekund.

  6. Sprawdź, czy klonowanie zakończyło się pomyślnie. Folder agenta zostanie otwarty w eksploratorze Visual Studio Code, w okienku kontroli źródła zostanie wyświetlone czyste drzewo robocze, a w oknie pliku zostanie wyświetlona nazwa folderu.

Metoda 3: Klonuj za pomocą palety poleceń

Użyj tej metody, jeśli wolisz workflow skoncentrowany na klawiaturze.

  1. Otwórz paletę poleceń, naciskając Ctrl+Shift+P.

  2. Wpisz "Copilot Studio: Clone Agent" i naciśnij Enter. Polecenie się wykonuje i pojawiają się podpowiedzi.

  3. Postępuj zgodnie z instrukcjami, aby wybrać środowisko, wybrać agenta, wybrać folder docelowy i poczekać na zakończenie klonowania. Agent jest sklonowany do wybranej przez ciebie lokalizacji.

Metoda 3: Klonowanie za pomocą adresu URL agenta

Ta metoda jest przydatna, gdy ktoś udostępnia Ci adres URL agenta.

  1. Otwórz swojego agenta w portalu internetowym Copilot Studio.

  2. Wybierz Ustawienia>Szczegóły agenta i skopiuj adres URL agenta. URL powinien mieć format: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. URL jest teraz w schowku.

  3. Wróć do Visual Studio Code i otwórz rozszerzenie programu Copilot Studio.

  4. Wybierz agenta klona. Rozszerzenie wykrywa adres URL w twoim schowku i wyświetla agenta oznaczonego jako "(from clipboard)".

  5. Wybierz agenta oznaczonego "(ze schowka)", wybierz docelowy folder i poczekaj na zakończenie procesu klonowania. Agent jest sklonowany do wybranej przez ciebie lokalizacji.

Typowe scenariusze klonowania

Oto kilka typowych scenariuszy, gdy klonowanie agentów jest przydatne, wraz z ogólnymi szczegółami dotyczącymi sugerowanego przepływu pracy.

Scenariusz 1: Klon do solowego rozwoju

Cel: podjęcie samodzielnej pracy nad agentem

  1. Sklonuj agenta do lokalnego folderu.

  2. Zainicjalizuj repozytorium Git z Kontroli Źródeł w nawigacji.

  3. Lokalne wprowadzanie zmian.

  4. Zrób swoje zobowiązania.

  5. Zastosuj zmiany w programie Copilot Studio, gdy wszystko będzie gotowe.

Scenariusz 2: Klon do współpracy zespołowej

Cel: Wielu deweloperów pracujących nad tym samym agentem

  1. Pierwszy deweloper klonuje agenta.

  2. Pierwszy deweloper inicjuje usługę Git i wypycha zawartość do udostępnionego repozytorium (GitHub, Azure DevOps).

  3. Inni deweloperzy klonują z współdzielonego repozytorium Git.

  4. Każdy deweloper uruchamia program Copilot Studio: Ponowne dołączenie agenta aby połączyć swój folder lokalny z programem Copilot Studio.

  5. Zespół używa usługi Git do współpracy i śledzenia zmian oraz używa rozszerzenia Visual Studio Code do pracy z agentem.

  6. Następnie każdy deweloper wprowadza zmiany w programie Copilot Studio, aby przetestować je lub przenieść do innego środowiska podrzędnego na podstawie ich cyklu życia tworzenia oprogramowania lub zautomatyzowanych procesów przetwarzania.

Scenariusz 3: Sklonuj wiele środowisk

Cel: Zarządzanie wersjami rozwojowymi, testowymi i produkcyjnymi

Zalecanym podejściem do wdrażania w wielu środowiskach jest stosowanie rozwiązań. Rozważmy zautomatyzowany proces wdrażania z procesami organizacyjnymi, które są audytowalne i skalowalne, takie jak pipelines. W przypadku użytkowników, którzy nie chcą pracować z rozwiązaniami, rozszerzenie Copilot Studio umożliwia synchronizowanie definicji agenta programu Copilot Studio z komputera lokalnego do innego środowiska. Warto jednak rozważyć proces organizacyjny przenoszenia zasobów technicznych do środowisk downstream, aby zapewnić audyt, telemetrię i inne kluczowe komponenty w cyklu życia tworzenia oprogramowania podczas dostarczania oprogramowania klientom i użytkownikom końcowym.

  1. Sklonuj agenta ze środowiska programistycznego do lokalnego folderu deweloperskiego.

  2. Wprowadź zmiany w folderze deweloperskim.

  3. Wprowadź te zmiany i testuj je w tym samym środowisku.

  4. Użyj Copilot Studio: Ponownie podłącz agenta aby połączyć agenta ze środowiskiem alternatywnym.

  5. Przetestuj agenta w okienku testowania programu Copilot Studio.

Najlepsze praktyki

Wykonaj

  • Sklonuj wszystkich agentów do spójnego miejsca.
  • Inicjalizuj Git zaraz po sklonowaniu.
  • Użyj znaczącej nazwy folderu.
  • Sprawdź, czy klon działa, zanim wprowadzisz zmiany.
  • Zachowaj kopię zapasową lokalizacji klonowania (na przykład w GitHub lub Azure DevOps).
  • Zapisz lokalizację klona w wewnętrznej wiki zespołu lub dokumentacji zespołu.

Nie

  • Nie klonuj do tymczasowych katalogów.
  • Nie klonuj wielokrotnie w różne miejsca. Takie działanie może powodować zamieszanie.

Dalsze kroki

Po sklonowaniu agenta:

  • Last updated on