Microsoft Visual Studio Code'da Microsoft Copilot Studio aracınızı kopyalama

Uzantıyı kullanarak bir aracıyı Microsoft Copilot Studio kopyaladığınızda, aracı tanımını ve ilgili bileşen tanımlarını Copilot Studio'dan yerel makinenize indirirsiniz. Bu dosyaları Microsoft Visual Studio Code kullanarak düzenleyebilirsiniz. Klon işlemi, tüm ajan dosyalarının yapılandırılmış bir dizin formatında olduğu yerel bir çalışma alanı oluşturur.

Önkoşullar

Ajanları klonlamaya başlamadan önce bazı önemli ön koşullar ve hususlar vardır.

Bir çalışma alanı konumu seçin

Ajan dosyalarınız için uygun yerel bir klasör seçin. Bu konum, uzantının ajan dosyalarını kaydettiği yerdir. İşte bir yer seçmek için bazı önemli ipuçları:

  • Yeterli disk alanını garanti edin. Tipik bir ajan, bileşen sayısına bağlı olarak boyut olarak değişebilir.
  • Mümkünse boşluk içermeyen bir yol kullanın, ancak boşluklar desteklenmektedir.
  • Git tarafından zaten takip edilen bir konum kullanmayı düşünün.

Neyin klonlandığını anlamak

Bir aracıyı kopyaladığınızda, aracı dosyaları seçtiğiniz konumda yerel olarak kopyalandığından, Visual Studio Code Gezgini'nde aşağıdakine benzer bir yapı tanımı oluşturulur:

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

Klonlama yöntemleri

Uzantıyı ilk kez kullanıyorsanız veya Visual Studio Code yeniyseniz, aracıyı kopyalamanın en kolay yolu Extension bölmesi açıkken Clone Agent seçmektir. Ancak, zaten bir Ajan'ı klonlayıp yerel olarak açıyorsanız, bu seçenek mevcut değildir. Bunun yerine aşağıdaki yöntemler kullanılabilir:

Bu, bir ajanı klonlamak için en basit ve önerilen yöntemdir.

  1. Etkinlik çubuğundaki Copilot Studio simgesini seçerek Copilot Studio uzantısını açın. Ayrıca Ctrl+Shift+P tuşlarına basıp "Copilot Studio: Aracılar Görünümüne Odaklan" girebilirsiniz. Copilot Studio bölmesi kenar çubuğunda açılır.

  2. Ajanlar panelinde, açılır menüden hedef ortamınızı seçin (örneğin, "Ortam 1"), böylece ortamdaki ajanların listesini görebilirsiniz.

    > Environment 1
  Environment 2
  Environment 3

  3. Listeden klonlanacak ajanı seçin. Ajanlar son değişiklik tarihlerini gösterir. Ajan adına sağ tıklayın ve Clone agent seçeneğini seçin.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    Bir dosya seçici diyalogu açılır.

  4. Dosya seçici diyalogunda istediğiniz konuma gidin veya yeni bir klasör oluşturup Klasörü Seç'i seçin. Klonlama süreci başlar.

  5. Klonlama sürecinin tamamlanmasını bekleyin. "Cloning agent: Customer Support Bot" şeklinde ilerleme bildirimi görünüyor ve ardından "Agent Cloned successfully" başarı mesajı geliyor. Bu süreç genellikle 10-30 saniye sürer.

  6. Klonlamanın başarıyla tamamlandığını doğrulayın. Aracı klasörü Visual Studio Code gezgininde açılır, kaynak denetim bölmesi temiz bir çalışma ağacı gösterir ve dosya penceresinde klasörünüzün adı görüntülenir.

Yöntem 3: Komut paleti kullanarak klonlama

Klavye odaklı iş akışlarını tercih ediyorsanız bu yöntemi kullanın.

  1. Komut paletini açın, tuşuna basarak Ctrl+Shift+P.

  2. "Copilot Studio: Clone Agent" yazın ve Enter tuşuna basın. Komut çalıştırılır ve uyarılar görünür.

  3. Ortamınızı seçin, ajanı seçin, hedef klasörü seçin ve klonlama tamamlanana kadar bekleyin. Ajan seçtiğiniz konuma klonlanıyor.

Yöntem 3: Ajan URL'si kullanarak klonlama

Bu yöntem, biri sizinle bir ajan URL'si paylaştığında faydalıdır.

  1. Aracınızı Copilot Studio web portalında açın.

  2. Settings>Agent details seçeneğini seçin ve ajan URL'sini kopyalayın. URL'nin şu formatı olmalıdır: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. URL artık panonuzda.

  3. Visual Studio Code dönün ve Copilot Studio uzantısını açın.

  4. Klon ajanı seçin. Uzantı, panodaki URL'yi tespit eder ve ajanı "(clipboarddan)" olarak işaretler.

  5. "(Clipboarddan)" işaretli ajanı seçin, bir hedef klasörü seçin ve klonlamanın tamamlanmasını bekleyin. Ajan seçtiğiniz konuma klonlanıyor.

Yaygın klonlama senaryoları

İşte ajanların klonlanmasının faydalı olduğu birkaç yaygın senaryo ve önerilen iş akışına dair yüksek düzey detaylar yer almaktadır.

Senaryo 1: Solo geliştirme için klon

Hedef: Bir ajan üzerinde tek başına çalışın

  1. Ajanı yerel bir klasöre klonlayın.

  2. Navigasyondaki Kaynak Kontrolü'nden bir Git deposunu başlatın.

  3. Değişiklikleri yerel olarak yapın.

  4. Taahhütlerinizi yapın.

  5. Hazır olduğunuzda değişiklikleri Copilot Studio'ya uygulayın.

Senaryo 2: Ekip iş birliği için klon

Hedef: Aynı ajanda çalışan birden fazla geliştirici

  1. İlk geliştirici ajanı klonlar.

  2. İlk geliştirici Git'i başlatır ve içeriği paylaşılan bir depoya (GitHub, Azure DevOps) iletir.

  3. Diğer geliştiriciler ortak Git deposundan klonlar.

  4. Her geliştirici, yerel klasörlerini Copilot Studio'ya bağlamak için Copilot Studio: Reattach Agent çalıştırır.

  5. Ekip, işbirliği yapmak ve değişiklikleri izlemek için Git'i kullanır ve aracı üzerinde çalışmak için Visual Studio Code uzantısını kullanır.

  6. Ardından her geliştirici, test için Copilot Studio'ya değişiklikler uygular veya yazılım geliştirme yaşam döngüsüne veya otomatik işlem hatlarına göre başka bir aşağı akış ortamına gönderimler uygular.

Senaryo 3: Birden fazla ortamı klonla

Hedef: Geliştirme, test ve üretim sürümlerini yönetin

Birden fazla ortamda dağıtım için önerilen yaklaşım, çözümler kullanmaktır. Denetim yapılabilir ve ölçeklenebilir organizasyon süreçlerine sahip otomatik bir dağıtım süreci düşünün; örneğin boru hatları. Çözümlerle çalışmamayı seçen kullanıcılar için, Copilot Studio uzantısı yerel bir makineden Copilot Studio aracı tanımını başka bir ortama eşitleme özelliği sağlar. Yazılım gönderirken yazılım geliştirme yaşam döngüsünde denetim, telemetri ve diğer kritik bileşenleri sağlamak için teknik varlıkları aşağı akış ortamlarına taşıma organizasyon sürecini de göz önünde bulundurmalısınız.

  1. Geliştirme ortamından ajanı yerel bir geliştirme klasörüne klonlayın.

  2. Geliştirme klasöründe değişiklikler yapın.

  3. Bu değişiklikleri uygulayın ve aynı ortamda test edin.

  4. Aracıyı alternatif ortama bağlamak için Copilot Studio: Aracıyı yeniden bağlama kullanın.

  5. Aracıyı Copilot Studio test bölmesinde test edin.

Önerilen yöntemler

Yap

  • Tüm ajanları tutarlı bir konuma klonlayın.
  • Klonlamadan hemen sonra Git'i başlatın.
  • Anlamlı bir klasör adı kullanın.
  • Değişiklik yapmadan önce klonun çalıştığını kontrol et.
  • Kopya konumunuzu yedeklenmiş olarak tutun (örneğin, GitHub veya Azure DevOps).
  • Klon konumunuzu dahili ekip wiki veya dokümantasyonunuzda belgeleyin.

Yapma

  • Dosyaları geçici dizinlere klonlamayın.
  • Farklı konumlara birden fazla kez klonlama yapma. Bunu yapmak kafa karışıklığına yol açabilir.

Sonraki Adımlar

Ajanınızı klonladıktan sonra:

  • Last updated on