Çözümleri kullanarak botları dışarı ve içeri aktarma (önizleme)

[Bu konu yayın öncesi belgesine dahildir ve değiştirilebilir.]

Botlarınızı çoklu ortamlar arasında taşıyabilmeniz için çözümleri kullanarak dışarı ve içeri aktarabilirsiniz.

Bu, farklı amaçlar için farklı ortamlar kullandığınızda veya halka dağıtım yöntemleri kullandığınızda yararlı olabilir. Örneğin, botlarınızı şirket içinde test edip doğruladığınız belirli bir ortamınız, yalnızca bir kullanıcı alt kümesi için testlerinizi doğruladığınız başka bir ortamınız, son olarak müşteriler ve son kullanıcılar ile botlarınızı paylaştığınız nihai üretim ortamınız olabilir.

Not

Botları yalnızca Power Virtual Agents web uygulamasıyla içeri ve dışarı aktarabilirsiniz. Bu özellik Microsoft Teams'de Power Virtual Agents uygulamasında kullanılamaz.

Ön koşullar

Önemli

Bu özellikler, önizleme durumundadır ve genel kullanılabilirlikten önce size sunulmuştur. Bu sayede özellikleri test edip değerlendirebilir ve Microsoft'a geri bildirimde bulunabilirsiniz.

Önizlemelerde azaltılmış veya ticari sürümlerden farklı gizlilik, güvenlik ya da uyumluluk taahhütleri kullanılabilir. Bu nedenle, önizlemeler "canlı" veya üretim Müşteri Verileri, Kişisel Veriler veya en yüksek uyumluluk gereksinimlerine tabi diğer verilerle kullanılmak üzere tasarlanmamıştır. "Canlı" verilerin herhangi bir kullanımı yalnızca sizin sorumluluğunuzdadır ve son kullanıcılarınızı önizleme kullanımıyla ilgili hassas bilgileri içermemesi gerektiğini bildirmek sizin sorumluluğunuzdadır.

Bu önizlemeler ve Microsoft'un sunmayı tercih edebileceği her türlü destek, "olduğu gibi", "tüm hatalarıyla birlikte", "kullanıma hazır" ve garanti verilmeksizin sağlanır.

Çözüme bir bot ekleme

Botları bir ortamdan dışarı aktarmak ve başka bir ortamda içeri aktarmak için çözümleri kullanabilirsiniz. Çözüm, botlar için "taşıyıcı" görevi görür ve tek bir çözümde birden fazla botu içeri aktarabilirsiniz. Başka bir ortama düzgün şekilde dışarı ve içeri aktarmak için bir çözümde en az bir botunuzun olması gerekir.

Dışarı ve içeri aktarma işlemini yönetmek için bir çözüm oluşturma

  1. Dışarı aktarmak istediğiniz Power Virtual Agents sohbet botunda oturun açın.

  2. Ayarlar'ı seçin ve sonra Genel ayarlar'ı seçin.

    Vurgulanmış ayarlar dişlisini gösteren ekran görüntüsü

  3. Botu dışarı/içeri aktar bölümünde Power Apps Çözümleri'ne git'i seçin.

    Power Virtual Agents'tan Power Platform yönetim merkezine bağlanma

  4. Power Apps'ta oturum açın ve Yeni çözüm'ü seçin. Bu tabloda açıklanan alanların her birine ilişkin bilgileri girin ve ardından Oluştur'u seçin.

    Vurgulanmış yeni çözüm düğmesi

    Alan Açıklama
    Görünen ad Çözümler listesinde gösterilen ad. Bunu daha sonra değiştirebilirsiniz.
    Ad Çözümün benzersiz adı Bu, Görünen ad alanına girdiğiniz değer kullanılarak oluşturulur. Çözümü kaydetmeden önce bunu düzenleyebilirsiniz, ancak çözümü kaydettikten sonra onu değiştiremezsiniz.
    Yayımcı Varsayılan yayımcıyı seçebilir veya yeni bir yayımcı oluşturabilirsiniz. Çözümü kullanacağınız ortamlarda tutarlı şekilde kullanabileceğiniz bir yayımcı oluşturmanızı öneririz. Daha fazla bilgi için Çözüm yayımcısı genel bakışına gidin.
    Sürüm Çözümünüzün sürümü için bir sayı girin. Bu yalnızca, çözümünüzü dışa aktarırsanız önemlidir. Çözümü dışa aktardığınızda, çözüm numarası dosya adına dahil edilir.

Ayarlar altında Sohbet botu verme/alma bölümünü göremiyorsanız, sohbet botunuzu yükseltmeniz gerekir. Botu yükselt'i seçin. Bu işlem birkaç dakika sürebilir.

Önemli

Bu adımları yalnızca Power Virtual Agents ayarları sayfasında Sohbet botu verme/alma seçeneği görmezseniz izleyin.

Yeni oluşturulan botların yükseltilmesi gerekmez ve yükseltme için bir seçenek gösterilmez.

Botu yükselt düğmesini vurgulayan ekran görüntüsü

Not

"Yükseltme beklenenden daha uzun sürüyor. Hiçbir işlem yapmanız gerekmiyor." bildirimi görüntülenebilir. Bildirim 10 dakika sonra kaybolmazsa tarayıcınızı yenilemeyi deneyin. Güncelleştirmeleri kaybetmeden botunuzda çalışmaya devam edebilirsiniz.

Birkaç gün sonra uyarıyı görmeye devam ederseniz bot kimliğinizle bir destek isteği oluşturun. Yöneticiler, destek isteği oluşturmak için Power Platform yönetim merkezinde Yardım + desteği kullanabilir.

Yükseltmenin tamamlanması için gereken süre hakkında uyarı

Botunuzu çözüme ekleme

  1. Botunuzu eklemek istediğiniz çözümü seçin.

  2. Var olanı ekle'yi ve Sohbet Botu'nu seçin.

    Vurgulanmış var olanı ekle menüsü

  3. Mevcut sohbet botlarını ekle panelinde, dışarı aktarmak istediğiniz botu (veya botları) seçin. Ekle'yi seçin.

    Botlar listesinde seçili Sohbet Botu

  4. Çözüme eklediğiniz botu (veya botları) görmek için üst menüdeki filtrede Sohbet Botu'nu seçin. Botun adı seçildiğinde Power Virtual Agents portalında açılır.

  5. Botunuzda beceriler yoksa bu adımı tamamlamanız gerekmez.

    Botunuzda beceriler varsa ilgili ortam değişkenlerini çözüme eklemeniz gerekir. Her beceride iki ortam değişkeni vardır: AppIDve manifestURL.

    1. Botunuzu eklemek istediğiniz çözümü seçin.

    2. Var olanı ekle'yi ve Ortam değişkenleri'ni seçin.

    3. Mevcut ortam değişkenleri ekle panelinde botunuzun becerileri için ortam değişkenlerini seçin. Her beceride iki ortam değişkeni vardır. Ortam değişkenleri Görünen ad sütunu bot adını köşeli ayraçlar içinde gösterir. Örneğin, [Bot adı] Beceri adı.

      Dışarı aktarma için seçilen becerilerin listesi

    4. Botun becerilerinin ortam değişkenlerini seçin.

    5. Bunları çözüme eklemek için İleri'yi seçin.

Not

Bir botun çözümden kaldırılması bileşenlerini çözümden kaldırmaz. Bileşenlerin kaldırılması ayrı olarak gerçekleştirilmelidir.

Uyarı

Botun kendisini çözümden kaldırmadıkça yönetilmeyen sohbet botu alt bileşenlerini (bot konuları gibi) doğrudan Power Apps portalından kaldırmayın.

Konularda yalnızca Power Virtual Agents portalı içinden değişiklik yapmanız gerekir.

Sohbet botu alt bileşenlerinin Power Apps içinden kaldırılması veya değiştirilmesi, dışarı aktarma ve içeri aktarmanın başarısız olmasına neden olur.

Botları dışarı ve içeri aktarma

Botları, içerdikleri çözümleri bir ortamdan diğerine dışarı ve içeri aktararak dışarı ve içeri aktarabilirsiniz.

Botunuzun bulunduğu çözümü dışarı aktarma

  1. Çözümler listesinde, dışarı aktarmak istediğiniz botun bulunduğu çözümü seçin. Dışa aktar'ı seçin.

    Dışarı aktar düğmesi

    Not

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

    Botunuzda çok sayıda bileşen varsa (örneğin 250'den fazla konu veya 100'den fazla varlık), botu klasik Power Apps portalı kullanarak dışarı aktarın.

    Klasik görünüme geçme

  2. Dışarı aktarmadan önce panelinde İleri'yi seçin.

  3. Bu çözümü dışarı aktar paneli görüntülenir. Aşağıdaki seçenekler arasından girme veya seçim yapın ve ardından Dışa aktar'i seçin:

    Seçenek Açıklama
    Sürüm numarası Power Virtual Agents, geçerli sürümü görüntülerken çözüm sürümünüzü otomatik olarak artırır. Varsayılan sürümü kabul edebilir veya kendi metninizi girebilirsiniz.
    Farklı dışarı aktar Paket türünü Yönetilen veya Yönetilmeyen olarak seçin. Yönetilen ve yönetilmeyen çözümler hakkında daha fazla bilgi edinin.

Dışa aktarma işleminin tamamlanması birkaç dakika sürebilir. Tamamlandığında web tarayıcınız tarafından bir .zip dosyası indirilir. Dosya SolutionName_Version_ManagementType.zip biçimindedir.

Botunuzun bulunduğu çözümü içeri aktarma

Not

İçeri aktardığınız yeni veya var olan ortamlarda önceden en az bir botunuzun olması gerekir. Bu, bir botu içeri aktardığınızda ortamınızda doğru yapılandırmaya sahip olmanızı sağlar.

  1. Üst menüde, ortam adını seçin ve botunuzu içeri aktarmak istediğiniz ortamı seçin.

    Seçili ortam seçici

  2. Çözümler sekmesine gidin ve komut çubuğunda İçeri aktar'ı seçin.

    Vurgulanmış içeri aktar düğmesi

  3. Çözüm Paketi Seç penceresinde, Dosya Seç seçeneğini belirleyin ve içeri aktarmak istediğiniz botun bulunduğu çözümü içeren .zip dosyasını bulun.

  4. İleri'yi seçin.

  5. Çözümün nasıl görüntüleneceğine dair bilgi. İçe aktar'ı seçin.

  6. İçeri aktarma işlemi tamamlanırken birkaç dakika beklemeniz gerekebilir. Sonuçlar görüntüleyin ve daha sonra Kapat.

    İçeri aktarma başarılı olmazsa alınan hata veya uyarıları gösteren bir rapor görürsünüz. XML dosyasında neyin içeri aktarma işleminin başarısız olmasına yol açtığı hakkında ayrıntıları almak için Günlük Dosyasını İndir'i seçin.

    Bir içeri aktarma işleminin başarısız olmasının en yaygın nedeni çözümün bazı gerekli bileşenleri içermemesidir. Örneğin, ortamda yükseltilmiş botunuz olmayabilir.

  7. İçeri aktarma işleminden sonra içeri aktarılan çözümü açın. Ortam değişkeni'ni seçmek için üst menüdeki filtre menüsünü kullanın. Değerleri Çözüme bot ekleme bölümünde açıklanan şekilde girin.

  8. Botunuzda aşağıdakilerin herhangi biri varsa ilk defa içeri aktarma işleminden sonra bunları yapılandırmanız gerekir:

    • Power Automate akışları: Akış bağlantılarını ilk kez yapılandırın. Akışı güncelleştirirken botun sonraki içeri aktarmalar için akış bağlantılarını yeniden yapılandırmanız gerekmez.

      Power Automate'ten yararlanan bir botun bulunduğu çözümü içeri aktarırsanız ve bu içeri aktarma işlemine yeni akışlar eklenirse Power Virtual Agents portalını ziyaret etmeniz ve botu seçmeniz gerekir.

    • Beceriler: Becerilerin ortam değişkenleri için değerler ekleyin.

    • Son kullanıcı kimlik doğrulaması: Kullanıcı adına eylem gerçekleştirebilmesi için botta son kullanıcı kimlik doğrulamasını yapılandırın. Bot, Azure Active Directory (Azure AD), Microsoft hesabı veya Facebook gibi herhangi bir OAuth2 kimlik sağlayıcısı ile ayarlanabilir.

    • Müşteri hizmetleri devri: Bot görev aktarmalarını bir insan temsilciye ileten harici hizmetleri yapılandırın.

    • Çok kanallı: Facebook gibi harici kanalları ve Microsoft Teams gibi Power Virtual Agents olmayan dahili hizmetleri yapılandırın:

  9. Sohbet Botu'nu seçmek için filtre menüsünü kullanın. Ardından, botu Power Virtual Agents portalında açmak için botun adını seçebilirsiniz. Ayrıca doğrudan portala gidebilir ve içeri aktardığınız ortam altında içeri aktarılan botu açabilirsiniz.

    Power Virtual Agents'ta bot ve ortam listesi

Önemli

Paylaşmadan önce yeni aktardığınız botunuzu yayımlamanız gerekir.

Sohbet botu bulunan bir çözümü yükseltme veya güncelleştirme

PVA portalında sohbet botunuza yeni sohbet bot bileşenleri (yeni konular veya akışlar gibi) eklerseniz, bu değişiklikleri hedef ortamınızdaki sohbet botunda da güncelleştirmeniz gerekir. Bunun için, Sohbet botunun adının yanındaki ... menüsü altındaki Gerekli bileşenleri ekle seçeneğini belirleyerek bileşenleri yönetilmeyen çözüme ekleyebilirsiniz.

Diğer menüsünün altındaki Gerekli bileşenleri ekle seçeneğinin vurgulandığı ekran görüntüsü

Var olan bir yönetilen çözümü güncelleştirmeniz gereken zamanlar vardır. Daha fazla bilgi edinmek için Bir çözümü yükseltme veya güncelleştirme bölümüne gidin.

Yönetilen sohbet botundan yönetilmeyen katmanı kaldırma

Microsoft Dataverse ortamı içindeki farklı düzeylerde yönetilen ve yönetilmeyen çözümler vardır. Daha fazla bilgi edinmek için Çözüm katmanları bölümüne gidin.

Yönetilen bir bileşeni düzenlediğinizde bileşene yönetilmeyen "Etkin" katmanı eklenir. Bu durumda çözümü dağıttıktan sonra en son değişiklikleri görmezsiniz.

En son güncelleştirmeleri göstermek için, yönetilmeyen "Etkin" katmanını kaldırmanız gerekir.

Bileşenin parçası olduğu tüm çözümleri görmek için Çözüm katmanlarını göster seçeneğini kullanın. Doğrudan bir şeyi değiştirdiyseniz diğer tüm çözümlerin en üstünde bir "Etkin" çözümü de görebilirsiniz.

  1. Bileşen adının yanındaki bağlamsal ... menüsünden Çözüm katmanlarını göster'i seçin.

    Çözüm katmanlarını göster seçeneği

  2. Çözüm katmanı sayfasında, yönetilmeyen katmanı seçin ve ardından katmanı kaldırmak için Yönetilmeyen katmanı kaldır'ı seçin.