Çözümleri kullanarak aracıları dışarı ve içeri aktarma

Note

Bu makale, standard harness ile desteklenen ajanlarda veya ajan akışlarında kullanılan özellikleri açıklamaktadır.

Aracılarınızı birden çok ortamda taşıyabilmeniz için çözümleri kullanarak aracıları dışarı ve içeri aktarabilirsiniz.

İlk olarak özel bir çözüm oluşturun ve aracınızı buna ekleyin. Ardından, çözümü aracınızla dışarı aktarın ve başka bir ortama aktarın. Ayrıca, bir çözümü aracıyla yükseltebilir veya güncelleştirebilir ve yönetilmeyen katmanı, yönetilen bir aracıdan kaldırabilirsiniz.

Copilot Studio'daki çözüm gezgini hakkında daha fazla bilgi için bkz. Copilot Studio'da çözümleri görüntüleme ve yönetme.

Note

Aracıyı dışarı aktardığınızda konu düzeyinde veya düğüm düzeyinde yorumları dışarı aktaramazsınız.

Prerequisites

• Bu özelliği kullanabilmek için en azından Sistem Özelleştirici güvenlik rolüne sahip olmanız gerekir. Bir ortamda kullanıcı güvenliğini yapılandırma hakkında daha fazla bilgi edinin.
• Çözüm kavramları ve Copilot Studio'da Çözümler Oluşturma ve Yönetme bölümlerinde açıklandığı gibi çözüm kavramları hakkında bilgi sahibi olmanız gerekir.

Bilinmesi gerekenler

• Yönetilen çözümleri dışarı aktaramazsınız.

  • Bir çözüm oluşturduğunuzda bu varsayılan olarak yönetilmez. Bunu yönetilen bir çözüm olarak değiştirirseniz dışarı aktaramazsınız. Yeni bir çözüm oluşturmanız gerekir.

• Tüm aracı bileşenleri ve özellikleri dahil değildir.

  • Aracı talimatları (ana istem) dahildir.

    Ancak, özel konular ve bilgi kaynakları gibi bazı bileşenler, nasıl oluşturulduklarına veya bağlandıklarına bağlı olarak ayrı kaynaklar veya Dataverse tabloları olarak depolanıyorsa dahil edilmeyebilir.

  • Bazı bot özellikleri aktarılamaz, örneğin:

    • Konuşma kimliği
    • CDS Bot Kimliği
    • Ortam kimliği
    • Konu düzeyi veya düğüm düzeyinde açıklamalar

    İçeri aktarılan aracıda bazı öğeler eksik olabilir, örneğin aracı simgesi ve kanal ayrıntıları boş olabilir.

• Bir aracıyı çözümden kaldırmak, onun bileşenlerini çözümden kaldırmaz. Bileşenleri ayrı olarak kaldırmalısınız.

  Warning

  Çözümden aracıyı da kaldırmadığınız sürece, aracı konuları gibi yönetilmeyen aracı bileşenlerini doğrudan çözümden kaldırmayın.

  Konu başlıklarında yalnızca Copilot Studio kullanıcı arabirimindeki standart yazma işleminin bir parçası olarak değişiklik yapmanız gerekir. Bir aracının bileşenlerinin çözümden doğrudan kaldırılması veya değiştirilmesi, ihracat ve ithalat işlemlerinin başarısız olmasına neden olur.

• Konularından herhangi birinin adında nokta (.) içeren aracı içeren bir çözümü dışarı aktaramazsınız.

Özel çözüm oluşturma ve aracınızı ekleme

1. Copilot Studio çözüm gezgininde yeni bir çözüm oluşturmak için Copilot Studio'da çözümleri oluşturma ve yönetme adımlarını izleyin.

2. Oluşturduğunuz çözüm otomatik olarak açılır. Aksi takdirde çözümler listesinden seçin.

3. Mevcut olanı ekle'yi seçin, ardından Aracı'yı ve sonra tekrar Aracı'yı seçin.

4. Var olan aracıları ekle listesinde, dışarı aktarmak istediğiniz aracıları seçin ve ardından Ekle'yi seçin.

Note

Klasik sohbet botu için:

Beceriler kullanıyorsanız, becerinin ortam değişkeni Mevcut Değer'i kaldırmak için Bu çözümden kaldır'ı seçin.

Bir aracıyı çözümden kaldırmak, onun bileşenlerini çözümden kaldırmaz. Bileşenleri ayrı ayrı kaldırmanız gerekir.

Özel bir çözümdeki bir aracıya bileşen ekleme

konular veya akışlar gibi bileşenleri Copilot Studio'daki aracınıza eklerseniz, dışarı aktarmadan önce bunları yönetilmeyen çözümünüzdeki aracıya da eklemeniz gerekir.

1. Copilot Studio'da çözüm gezginini açın.

2. Temsilcinizi içeren çözümü seçin.

3. Nesneler bölmesinde, Aracılar altında aracınızı bulun.

4. Üç noktayı (⋮) seçin, İleri'yi seçin ve ardından Gerekli nesneleri ekle'yi seçin.

Power Apps belgelerindeki yönergeleri ve gereksinimleri gözden geçirerek mevcut bileşeni bir çözüme ekleyin.

Çözümünüze özel konnektörler ekleyin

Eğer ajanınız özel konnektörler kullanıyorsa, çözümlerde özel bağlayıcılar oluştur bölümündeki adımları izleyin ve bilinen sınırlamalar hakkında bilgi edinin.

Important

Önce özel konnektörleri içe aktarmalısınız, ardından ajan çözümüyle birlikte bağlantı referansını içe aktarmalısınız.

Power Automate akışlarını ekleyin

Akışları ve ortam değişkenlerini kullandığınızda, akışlar ve ortam değişkenleri için gerekli nesneleri ekleyin.

1. Copilot Studio'da çözüm gezginini açın.

2. Temsilcinizi içeren çözümü seçin.

3. Nesneler panelinde iş akışlarınızı bulun.

4. Üç noktayı (⋮) seçin, İleri'yi seçin ve ardından Gerekli nesneleri ekle'yi seçin.

Ortam değişkenleri ekleme

Ortam değişkenleri eklemek için şu adımları izleyin:

1. Copilot Studio'da çözüm gezginini açın.

2. Temsilcinizi içeren çözümü seçin.

3. Çözümde ortam değişkenleri yoksa Var olanı ekle'yi seçin, Diğer'i ve ardından Ortam değişkeni'ni seçin.

   1. Gerekli ortam değişkenlerini seçin.

   2. Sonra Sonraki'yi seçin ve Ekle'yi seçin.

4. Çözümün tüm ortam değişkenleri zaten varsa üç noktayı (⋮) seçin, Gelişmiş'i seçin ve ardından Çözümün tüm bağımlılıklara sahip olduğundan emin olmak için Gerekli nesneleri ekle'yi seçin.

Bileşenleri yönetilen çözümler için özelleştirin

Bileşenleri yönetilen bir çözümde özelleştirilebilir hale getirmek için bkz. Tablo yönetilen özelliklerini görüntüleme ve düzenleme.

Yönetilen çözümleri içe aktarmadan önce ortamınızın özelleştirmeye izin verdiğinden emin olun. Ortamınızın özelleştirmeleri veya yönetilmeyen çözümleri engellemediğinden emin olun. Dataverse'de Yönetilmeyen Engellenen Özelleştirmeler bölümünde daha fazla bilgi edinebilirsiniz.

Temsilcinizle çözümü dışa aktarma

Aracıları, bunları içeren çözümleri bir ortamdan diğerine aktarıp içe aktararak dışa ve içe aktarabilirsiniz.

Çözümü, aracınızla dışarı aktarmak için şu adımları izleyin:

1. Copilot Studio'da çözüm gezginini açın.

2. Yönetilmeyen çözümler listesinde, aracınızı içeren çözümü seçin.

3. Çözümü dışarı aktar'ı seçin. Power Apps export solutions deneyiminde olduğu gibi, Dışarı aktarmadan önce sağ bölmesi görüntülenir.

4. Adımların geri kalanı, Power Apps çözümleri dışarı aktarmakla aynıdır. Çözümü dışa aktarmayı tamamlamak için Power Apps belgelerindeki yönergeleri ve gereksinimleri izleyin.

Important

Ajanınızda çok sayıda bileşen varsa (örneğin 250'den fazla konu veya 100'den fazla varlık), standart harness kullanarak dışa aktarma konusuna bakın.

Ajanınızla çözümü içeri aktarın

Çözümü aracınızla birlikte başka bir ortama aktarmak için şu adımları izleyin:

1. Hedef ortamda Copilot Studio çözüm gezginini açın.

2. Çözümü içeri aktar'ı seçin. Power Apps çözümleri içe aktarma deneyimindeki gibi, Bir çözümü içeri aktar bölmesi sağda görünür.

3. Geri kalan adımlar, Power Apps'da çözümleri içeri aktarmayla aynıdır. çözümü aktarma işlemini tamamlamak için Power Apps belgelerindeki yönergeleri ve gereksinimleri izleyin.

Alma işlemi başarılı olmazsa, alma işleminin başarısız olmasına neden olan ilgili ayrıntıları içeren XML dosyasını karşıdan yüklemek için Günlük dosyasını indir'i seçin. Bir içe aktarma işleminin başarısız olmasının en yaygın nedeni, çözümün gerekli bazı bileşenleri içermemesidir.

1. Çözüm gezgininde listeden yeni içeri aktarılan çözümü seçin.

2. Nesneler bölmesinde Aracılar'ı seçin. Ardından Copilot Studio'da yeni bir sekmede temsilciyi açmak için temsilcinin adını seçin.

3. Aracı için kullanıcı kimlik doğrulamasını yeniden yapılandırın.

Important

• Paylaşılabilmesi için içe aktardığınız aracıyı yayınlamanız gerekir.
• Aracınızın simgesinin her yerde görünmesi 24 saate kadar sürebilir.

Teams'te aracıları dışarı ve içeri aktarma

Microsoft Teams'da, Power Apps Teams uygulamasını kullanarak aracıları tek tek ekipler arasında dışarı ve içeri aktarabilirsiniz.

Örneğin, bir Teams ekibinden (A ekibi) çalışan bir aracıyı dışarı aktarıp B ekibine aktarırsanız, B ekibi için sıfırdan oluşturmanız gerekmez.

Dataverse for Teams'ten özelleştirmeleri dışarı aktarma bölümündeki talimatları izleyin.

Dışarı aktarılacak özelleştirmeleri seçerken, dışarı aktarmak istediğiniz aracıyı seçin. Yalnızca belirli bir ekip için aracıları göstermek için yan bölmedeki filtreyi kullanın.

Aracı, bilgisayarınızdaki İndirilenler klasörüne kaydedilir.

Teams'te içeri aktarmak için Dataverse for Teams'e özelleştirmeleri içeri aktarma bölümündeki talimatları izleyin.

Ajanınız, içeri aktardığınız ekibin altındaki Teams'deki Copilot Studio uygulamasında görünür.