Copilot Agent Kit'i Takla

Copilot Agent Kit, Copilot Studio ajanlarının test edilmesi ve değerlendirilmesi için açık kaynaklı bir araç setidir. Örneğin, test çalışmalarını tanımlamanıza, kullanıcı sorgularının simülasyonunu oluşturmanıza ve aracı yanıtlarını doğrulamanıza yardımcı olur. Bu makale, Marketplace veya GitHub'tan kitin kurulumu için adım adım talimatları, dağıtım sonrası adımlar ve yapılandırma seçenekleriyle birlikte sunulmaktadır.

Note

Copilot Agent Kit'i indirip yüklemeden önce, tüm ön koşulları yerine getirdiğinizden emin olun.

Marketplace'ten Copilot Agent Kit'i kur

Eğer GitHub'tan Copilot Agent Kit'i kurmayı tercih ediyorsanız, GitHub'tan Install Copilot Agent Kit'e geçin.

Marketplace'ten Dağıtım

Marketplace'ten Copilot Agent Kit'i dağıtmak için şu adımları izleyin:

1. Marketplace'teki Copilot Agent Kit'ine gidin.
2. Şimdi al'ı seçin.
3. Gerekirse oturum açın.
4. Install Copilot Agent Kit görünümünde, Copilot Agent Kit'i dağıtmak istediğiniz ortamı seçin.
5. Terimleri ve deyimleri gözden geçirin. Kabul ediyorsanız kutuları işaretleyin ve Yükle'yi seçin.

Copilot Agent Kit'in kurulumu başlar.

Dağıtım sonrası adımlar (Marketplace)

Yükleme tamamlandıktan sonra şu dağıtım sonrası adımlarını izleyin:

1. Power Apps'e giriş yapın.
2. Çözümler'e gidin.
3. Varsayılan Çözüm'ü seçin.
4. Bağlantı referanslarını seçin.
5. Copilot Agent Kit - Dataverse'i bulun ve düzenleme için açın.
6. Tüm gerekli alanların doldurulduğundan ve seçilen bağlantının geçerli olduğundan emin olun. Gerektiğinde Dataverse'e yeni bir bağlantı oluşturun.
7. Kaydetseçeneğini seçin.
8. Daha fazla ve isteğe bağlı yapılandırma adımlarını izleyin.

Copilot Agent Kit'i GitHub'dan Kurulum

GitHub'tan Copilot Agent Kit'i kurmak için bu adımları izleyin. Marketplace'ten kurulum yapmayı tercih ediyorsanız, Marketplace'ten Install Copilot Agent Kit'e gidin.

En son GitHub sürümünü indirin

Power CAT Copilot Agent Kit için yönetilençözümün en son sürümünü indirin.

Copilot Agent Kit yönetilen zip dosyasını kur

Copilot Agent Kit yönetilen çözümünü kurmak için:

1. Power Apps'e giriş yapın.
2. Copilot Agent Kit'i kurmak istediğiniz ortamı seçin.
3. Çözümler'e gidin.
4. Çözümü İçeri Aktar seçin.
5. Göz at seçeneğini seçin.
6. CopilotStudioKit*_managed.zip dosyasını seçin.
7. sonrakiseçin.
8. Çözüm bilgilerini gözden geçirdikten sonra İleri'yi seçin.
9. İstenirse gerekli bağlantıları oluşturun ve İçeri Aktar'ı seçin.
10. Konuşma KPI raporu değerlerini şimdilik olduğu gibi bırakın. Bu değerleri daha sonra güncelleştirebilirsiniz.
11. İçeri aktarma işleminin tamamlanmasını bekleyin.

Mevcut çözümü yükseltme (GitHub)

Copilot Agent Kit'in en son sürümüne yükseltmek için şu adımları izleyin:

1. Power Apps'e giriş yapın.
2. Copilot Agent Kit'i yükseltmek istediğiniz ortamı seçin.
3. Çözümler'e gidin.
4. Çözümü İçeri Aktar seçin.
5. Göz at seçeneğini seçin.
6. CopilotStudioKit*_managed.zipöğesini seçin.
7. sonrakiseçin. Power Apps, bu yükseltmenin mevcut bir yönetilen çözüm olduğunu algılar.
8. İleri'yi seçerek mevcut çözümü yükseltmek istediğinizi onaylayın.
9. Konuşma KPI raporu değerlerini şimdilik olduğu gibi bırakın. Bu değerleri daha sonra güncelleştirebilirsiniz.
10. İçe aktar'ı seçin.

Note

Copilot Ajan Kit'i yükseltirken şu hatayla karşılaşabilirsiniz: "Power CAT Copilot Agent Kit" çözümü içe aktarılamadı: ImportAsHolding istisnayla başarısız oldu: Attribute: cat_copilottestrunid Entity: cat_CopilotTestRun'dan silemiyor çünkü bu özellik özel bir alan değil.

Bu sorun bilinmektedir ve araştırılıyor. Geçici bir çözüm olarak, yükseltmeyi uygulamadan önce hazırlayın. Çözümü yükseltme veya güncelleştirme bölümünde daha fazla bilgi edinin.

Diğer ve isteğe bağlı yapılandırma adımları

Bu yapılandırma adımları, Copilot Agent Kit'i Marketplace'ten veya GitHub'dan yüklediğinizden bağımsız olarak geçerlidir.

Tip

Copilot Agent Kit, bağlantı referanslarını, ortam değişkenlerini ve bulut akışlarını yapılandırmak için bir Kurulum Sihirbazı içerir. Kurulum Sihirbazını nasıl kullanacağınıza dair daha fazla bilgi edinin.

SharePoint eşitlemesini yapılandırma

Aşağıdaki adımlar isteğe bağlıdır ve yalnızca SharePoint eşitleme özelliğini kullanmayı planlıyorsanız gereklidir. Bu değerleri, özelliği kullanmadan önce istediğiniz zaman ayarlayabilirsiniz.

SharePoint bağlantısını kaynak SharePoint sitesine yönlendirin. Dataverse URL'sini, içeriğin eşitlendiği hedef özel aracılar için Dataverse örneğine yönlendirin.

Bu adımları izleyebilir veya Kurulum Sihirbazı kullanarak SharePoint bağlantı referansını yapılandırabilirsiniz.

SharePoint eşitleme özelliğini kullanmak için:

1. Bu makalenin daha önce anlattığı Copilot Ajan Kit'i kur.
2. Power Apps'e giriş yapın.
3. Çözümler'e gidin.
4. Varsayılan Çözüm'ü seçin.
5. Bağlantı referanslarını seçin.
6. Copilot Agent Kit - SharePoint bağlantı referansını bulun ve düzenleme için açın.
7. Tüm gerekli alanların doldurulduğundan ve seçilen bağlantının geçerli olduğundan emin olun. Gerektiğinde SharePoint'e yeni bir bağlantı oluşturun.
8. Kaydetseçeneğini seçin.

Daha fazla bilgi: Copilot Agent Kit'te ajanların yapılandırması hakkında bilgi edinin; dosya senkronizasyonu için yeni bir ajanı nasıl yapılandırmak dahil.

Aracı Envanteri Yapılandırma

Aşağıdaki adımlar isteğe bağlıdır ve yalnızca Aracı Envanteri özelliğini kullanmayı planlıyorsanız gereklidir. Bu değerleri, özelliği kullanmadan önce istediğiniz zaman ayarlayabilirsiniz.

Çözümdeki bağlantı referansları aracıların görünürlüğünü denetler. Diğer hesapları kullanabilirsiniz ancak tam görünürlük elde etmek için bu izinleri kullanın.

• Copilot Agent Kit - Power Platform for Admins, kiracıdaki ortamların listesini getirir. Power Platform yönetici düzeyi izinleri gerektirir.
• Copilot Ajan Kiti - Dataverse, ortamlardan ajan bilgilerini toplar. Tüm ortamlar için sistem yöneticisi düzeyinde izinler gerektirir.

Bu adımları takip edebilir veya Ajan Envanteri bağlantı referanslarını yapılandırmak için Kurulum Sihirbaşkanını kullanabilirsin.

Aracı Envanteri özelliğini kullanmak için:

1. Bu makalenin daha önce anlattığı Copilot Ajan Kit'i kur.
2. Power Apps'e giriş yapın.
3. Çözümler'e gidin.
4. Varsayılan Çözüm'ü seçin.
5. Bağlantı referanslarını seçin.
6. Copilot Agent Kit - Power Platform for Admins bağlantı referansını bulun ve düzenleme için açın.
7. Tüm gerekli alanların doldurulduğundan ve seçilen bağlantının geçerli olduğundan emin olun.
8. Kaydetseçeneğini seçin.
9. Copilot Agent Kit - Dataverse bağlantı referansını bulun ve düzenleme için açın.
10. Tüm gerekli alanların doldurulduğundan ve seçilen bağlantının geçerli olduğundan emin olun.
11. Kaydetseçeneğini seçin.

Akışları etkinleştirme

Note

SharePoint eşitlemesini kullanmayı planlıyorsanız, ilgili akışları etkinleştirmeden önce SharePoint eşitlemesini yapılandırın (adlar SharePoint Eşitlemesi ile başlar).

Copilot Agent Kit'te bulunan bulut akışlarını etkinleştirmek için ya bu adımları izleyin ya da Kurulum Sihirbazını kullanın.

1. Bu makalenin daha önce anlattığı Copilot Ajan Kit'i kur.
2. Power Automate'a giriş yapın.
3. Copilot Agent Kit ile ortamın seçildiğinden emin olun.
4. Çözümler'i seçin.
5. Copilot Agent Kit'i seçin.
6. Bulut akışları'nı seçin.
7. Tüm akışların etkinleştirildiğinden emin olun (Durum = Açık).
8. Etkinleştirilmemiş akışları aşağıdaki sırayla etkinleştirin:
   1. Torun ile biten akışlar.
   2. Child olarak biten akışlar.
   3. Geriye kalan akışlar, gerektiği şekilde ve herhangi bir sırayla.

Uyum Merkezi Kur

Uyum Merkezi'ni kurmak için, Copilot Agent Kit Uyum Merkezini Kurulum ve Yapılandırma bölümündeki adımları izleyin. Uyum Merkezi, Temsilci Envanteri gerektirir.

Eklenmiş Konuşma KPI panosunu yapılandırma

Bu adımları yalnızca eklenmiş Konuşma KPI'leri panosunu kullanmayı planlıyorsanız izleyin.

Adımlar sırasında aşağıdaki değerleri not edin:

• Çalışma alanı adı
• Çalışma Alanı GUID'i
• Rapor adı
• Rapor GUID'i

Raporu yayımlama

Konuşma KPI'leri raporunu yayımlamak için:

1. Bu makalenin daha önce anlattığı Copilot Ajan Kit'i kur.

2. Power CAT Copilot Agent Kit'GitHub deposundanConversation.KPIs.zip indirin.

3. .zip dosyasının içeriğini çıkartın.

4. Power BI Desktop uygulamasında Konuşma KPI'leri.pbit dosyasını açın.

5. Görüntülenen iletişim kutusunda Ortam URL'si olarak Dataverse URL'sini girin ve Yükle'yi (örneğin, org3c23948.crm.dynamics.comön ek olmadan https:// ) seçin.

   İletişim kutusu görünmüyorsa, Ortam URL'siniGiriş>Verileri dönüştür>Parametreleri düzenle alanına girin.

6. Verileri yenileyin ve gerektiği gibi oturum açın.

7. Bir çalışma alanına kaydedin ve yayımlayın.

8. Rapor adını ve Çalışma Alanı adını not edin.

9. Power BI'te oturum açın.

10. Yayımladığınız raporu açın ve URL'de Çalışma Alanı GUID'sini ve Rapor GUID'sini not edin.

    "Benim Çalışma Alanım"a yayımlarsanız, Çalışma Alanının GUID'i 00000000-0000-0000-0000-000000000000 olur.

11. Üç noktayı (...) seçin ve ardından anlamsal modeli Görüntüleyin.

12. Dosya Ayarları'nı> açın.

13. Veri kaynağı kimlik bilgilerinin sorun olup olmadığını denetleyin. Sorunları düzeltmek için oturum açın.

14. Yenile'ye gidin ve yenileme zamanlamasını ayarlayın.

Rapor ortamı değişkenini güncelleştirme

Eklenmiş Konuşma KPI'leri panosunu ayarlamak için ilgili ortam değişkenini doğru tanımlayıcılarla güncelleştirin. Bu adımları takip edebilir veya Kurulum Büyücüsü'nü kullanabilirsin.

1. Power Apps'e giriş yapın ve Copilot Agent Kit'i yüklediğiniz ortamı seçin.
2. Çözümler>Varsayılan Çözüm'ü seçin.
3. Ortam değişkenleri'ni seçin.
4. Konuşma KPI'leri Raporu'u bulun ve seçin.
5. Varsayılan Değer'deki yer tutucuları, yayımlama işlemi sırasında not ettiğiniz Çalışma Alanı adı, Çalışma Alanı GUID'i, Rapor Adı ve Rapor GUID değerleriyle değiştirin.
6. Kaydetseçeneğini seçin.

Copilot Agent Kit'te ajanların yapılandırılması hakkında bilgi edinin; Konuşma KPI'ları için yeni bir ajanı nasıl yapılandırmak dahil.

Copilot Agent Kit uygulamasına erişin

Copilot Agent Kit uygulamasına erişmek için:

1. Power Apps'e giriş yapın ve Copilot Agent Kit'i yüklediğiniz ortamı seçin.
2. Uygulamalar'a gidin.
3. Power CAT Copilot Agent Kit'i bulun ve seçin.
4. Yürüt’ü seçin.
5. (İsteğe bağlı) Uygulamaya yer işareti ekleyin.

Copilot Agent Kit uygulamasını paylaşın

Uygulamanın başarılı şekilde açıldığını doğruladıktan sonra, sahibi (veya Kit'i yükleyen sistem yöneticisi) Copilot Agent Kit uygulamasını ekiple paylaşmak zorundadır.

1. Power Apps'e giriş yapın.
2. Apps'i seçin.
3. "Copilot Agent Kit" araması ve tip Code olanı (model odaklı uygulama değil) bulun.
4. Üç noktayı (...) ve ardından uygulama adının yanındaki Paylaş'ı seçin.
5. Erişime ihtiyacı olan kullanıcıları veya güvenlik gruplarını arayın ve ekleyin.
6. Onaylamak için Paylaş'ı seçin.

Tuval uygulamasını kuruluşunuzla paylaşma bölümünde daha fazla bilgi edinin.

Sonraki adım

Kullanıcıları ve ekipleri yapılandırma