Aracılığıyla paylaş


Copilot Studio Kit'i yükleme

Copilot Studio Kit, Copilot Studio aracılarını test ve değerlendirmeye yönelik bir açık kaynak araç setidir. Örneğin, test çalışmalarını tanımlamanızı, kullanıcı sorgularının simülasyonunu yapmanızı ve aracı yanıtlarını doğrulamanızı sağlar. Bu makale, MarketplaceveyaGitHub'dan kitin kurulumu için adım adım talimatları, dağıtım sonrası adımlar ve yapılandırma seçenekleriyle birlikte sunulmaktadır.

Uyarı

Copilot Studio Kit'i indirip yüklemeden önce tüm önkoşulların karşılandığından emin olun.

Marketplace'ten Copilot Studio Kit'i kur

Copilot Studio Kit'i GitHub'dan yüklemeyi tercih ediyorsanız GitHub'dan Copilot Studio Kit'i yükleme bölümüne atlayın.

Marketplace'ten Dağıtım

Marketplace'ten Copilot Studio Kit'i kurmak için şu adımları izleyin:

  1. Marketplace'teki Copilot Studio Kit'e gidin.
  2. Şimdi al'ı seçin.
  3. Gerekirse oturum açın.
  4. Copilot Studio Kit'i Yükle görünümünde, Copilot Studio 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 Studio 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'te oturum açın.
  2. Çözümler'e gidin.
  3. Varsayılan Çözüm'ü seçin.
  4. Bağlantı referanslarını seçin.
  5. Copilot Studio Kit - Dataverse'i bulun ve düzenlemek üzere 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.

GitHub'dan Copilot Studio Kit'i yükleme

GitHub'dan Copilot Studio Kit'i yüklemek için bu adımları izleyin. Marketplace'ten kurulum yapmayı tercih ediyorsanız, Marketplace'ten Copilot Studio Kit'i Install sayfasına gidin.

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

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

CopilotStudioKit yönetilen zip dosyasını yükleme

Copilot Studio Kit yönetilen çözümünü yüklemek için:

  1. Power Apps'te oturum açın.
  2. Copilot Studio Kit'i yüklemek 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 Studio Kit'in önceki bir sürümünü yüklediyseniz ve en son sürüme yükseltmek istiyorsanız şu adımları izleyin:

  1. Power Apps'te oturum açın.
  2. Copilot Studio 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. İçeri aktar'ı seçin.

Uyarı

Copilot Studio Kit'i yükseltirken aşağıdaki hatayla karşılaşabilirsiniz: "Çözüm "Power CAT Copilot Studio Kit" içe aktarılamadı: ImportAsHolding şu istisnayla başarısız oldu: Nitelik silinemiyor: cat_copilottestrunid Varlıktan: cat_CopilotTestRun çünkü öznitelik ö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 Studio Kit'i Marketplace'ten veya GitHub'dan yüklediğinizden bağımsız olarak geçerlidir.

Tavsiye

Copilot Studio 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ı kullanmak hakkında 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öneltin. Dataverse URL'sini, içeriğin eşitlendiği hedef özel aracılar için Dataverse örneğine yönlendirin.

Bu adımları takip edebilir veya SharePoint bağlantı referansını yapılandırmak için Kurulum Büyücüsü'nü kullanabilirsin.

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

  1. Bu makalenin önceki bölümlerinde açıklanan Copilot Studio Kit'i yükleyin.
  2. Power Apps'te oturum açın.
  3. Çözümler'e gidin.
  4. Varsayılan Çözüm'ü seçin.
  5. Bağlantı referanslarını seçin.
  6. Copilot Studio Kit - SharePoint bağlantı referansını bulun ve düzenlemek üzere 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: Dosya eşitlemesi için yeni aracı yapılandırma da dahil olmak üzere Copilot Studio Kit'te aracıları yapılandırma hakkında bilgi edinin.

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 Studio Kit - Yöneticiler için Power Platform kiracıdaki ortamların listesini getirir. Power Platform yönetici düzeyi izinleri gerektirir.
  • Copilot Studio Kit - Dataverse ortamlardan aracı 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 önceki bölümlerinde açıklanan Copilot Studio Kit'i yükleyin.
  2. Power Apps'te oturum açın.
  3. Çözümler'e gidin.
  4. Varsayılan Çözüm'ü seçin.
  5. Bağlantı referanslarını seçin.
  6. Copilot Studio Kit - Power Platform for Admins bağlantı referansını bulun ve düzenlemek üzere 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 Studio Kit - Dataverse bağlantı referansını bulun ve düzenlemek üzere 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.

Kullanım ölçümlerini etkinleştirme

Aracı Envanterinde isteğe bağlı Kullanım Ölçümlerini etkinleştirmek için aşağıdaki adımları tamamlayın:

  1. Ortamınızda Microsoft Entra Id (önceden kimliği doğrulanmış) ile http bağlayıcısının kullanılmasına izin verildiğinden emin olun.
  2. AgentInventoryUsage*_managed.zip dosyasını Power CAT Copilot Studio Kit GitHub deposundan içeri aktarın.
  3. İçeri aktarma işlemi sırasında lisans ana bilgisayar URL'sini kullanarak bir bağlantı oluşturun: https://licensing.powerplatform.microsoft.com/

Microsoft Entra ID bağlayıcısı ile HTTP için Temel Kaynak URL'si olarak lisans ana bilgisayar URL'sinin yapılandırmasını gösteren ekran görüntüsü.

Akışları etkinleştirme

Uyarı

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 Studio Kit'te bulunan bulut akışlarını etkinleştirmek için ya bu adımları takip edin ya da Kurulum Sihirbazını kullanın.

  1. Bu makalenin önceki bölümlerinde açıklanan Copilot Studio Kit'i yükleyin.
  2. Power Automate'te oturum açın
  3. Copilot Studio Kit'i içeren ortamın seçildiğinden emin olun.
  4. Çözümler'i seçin.
  5. Copilot Studio 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. En alt 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 Studio Kit Uyum Merkezi'ni Kurulum ve Yapılandırma bölümindeki 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 gereklidir.

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

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

Raporu yayımlama

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

  1. Bu makalenin önceki bölümlerinde açıklanan Copilot Studio Kit'i yükleyin.

  2. Power CAT Copilot Studio 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ünmezse, Ana Sayfa>> bölümüne Ortam URL'sini 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'da 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'te oturum açın ve Copilot Studio 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.

Daha fazla bilgi: Konuşma KPI'leri için yeni bir aracı yapılandırma da dahil olmak üzere Copilot Studio Kit'te aracıları yapılandırma hakkında bilgi edinin.

Copilot Studio Kit uygulamasına erişme

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

  1. Power Apps'te oturum açın ve Copilot Studio Kit'i yüklediğiniz ortamı seçin.
  2. Uygulamalar bölümüne gidin.
  3. Power CAT Copilot Studio Kit'i bulun ve seçin.
  4. Oynat'ı seçin.
  5. (İsteğe bağlı) Uygulamaya yer işareti ekleyin.

Sonraki adım