Üretken AI için eklentileri etkinleştirme (önizleme)

[Bu makale, yayın öncesi belgelerine dahildir ve değiştirilebilir.]

Müşteri hizmetleri temsilcileriniz (hizmet temsilcileri veya temsilcileri) çok çeşitli sistemlerden gelen verilere ve bilgilere güvenir. Eklentilerle, Microsoft dışı CRM verilerinizle doğrudan etkileşim kurabilirsiniz. Bu doğrudan etkileşim, servis temsilcilerinin işlerini yapmak için diğer sekmelere ve araçlara geçme ihtiyacını azaltmaya yardımcı olur ve çözüm süresini ve müşteri memnuniyetini artırır.

Önkoşullar

• Copilot Studio'de, gömülü AI destekli aracınızda bir istem eklentisi kullanmak istiyorsanız, bir istem eklentisi oluşturun.
• Copilot Studio'de, gömülü AI destekli aracınızda bir bağlayıcı eklentisi kullanmak istiyorsanız, bir özel bağlayıcı eklentisi oluşturun.

Eklentileri yapılandırma

Copilot Studio'de eklentiyi oluşturduktan sonra gömülü AI destekli aracınızda istem eklentisini veya bağlayıcı eklentisini kullanmak için eklentiyi yönetim merkezinde etkinleştirmeniz gerekir. Aşağıdaki bölümlerde eklentilerin nasıl etkinleştirileceği ve yapılandırılacağı açıklanmaktadır.

İstem eklentisi

1. Copilot Service yönetim merkezinde Üretkenlik'i seçin.
2. Üretkenlik sayfasında, Üretken AI için Eklentiler (Önizleme) için Yönet seçeneğini belirleyin. üretici AI için Eklentiler (Önizleme) sayfası, ortam için oluşturulan tüm eklenti istemleriyle birlikte görüntülenir.
3. Etkinleştirmek istediğiniz istem eklentisini seçin ve ardından komut çubuğunda Aç'ı seçin.
4. Erişim türünü seçin'de aşağıdaki türlerden birini seçin:
   • Copilot bulunan tüm aracılar: Aracı deneyimi profilleri aracılığıyla Copilot'ın etkinleştirildiği aracılar.
   • Belirli kullanıcı rolleri: Listeden rolleri seçin.
5. Girişleri tanımla(isteğe bağlı) ekranı görüntülenir. Bu adım isteğe bağlıdır ve Copilot yanıt oluşturmak için otomatik olarak kullanabileceği bağlam sağlamanıza olanak tanır. Bir giriş eklemezseniz, hizmet temsilcilerinin eklentiyi çalıştırırken bağlamı el ile belirtmeleri gerekir. Girişleri yapılandırmak ve bu özelliğin nasıl çalıştığı hakkında daha fazla bilgi edinmek için Girişleri tanımla bölümündeki adımları uygulayın.
6. İleri'yi seçin ve ardından Eklenti verileri ekranında Bu eklentinin verilerini sakla'yı seçin. Veriler, Copilot ile hizmet temsilcinizin etkileşimlerinin bir parçası olarak sohbet dökümleri olarak Dataverse veritabanınızda saklanır. Copilot metinlerini ve etkileşim verileri bölümünde daha fazla bilgi edinin.
7. Eklentiyi aç'ı seçin.
8. Sayfanın üst kısmındaki uyarı iletisinde Değişiklikleri yayımla'yı seçin ve ardından görüntülenen onay iletişim kutusunda Onayla'yı seçin. Değişikliklerin yayınlanması 15 dakikaya kadar sürebilir.

Özel bağlayıcı eklentisi

1. Copilot Service yönetim merkezinin site haritasında, eklentilere erişmek için aşağıdaki adımlardan birini seçin:

   • Temsilci deneyimi altından Üretkenlik>Üretken AI eklentileri (Önizleme) seçeneğini belirleyin.
   • İşlemler altından İçgörüler>Üretken AI eklentileri (Önizleme) öğesini seçin.

2. Yönet'i seçin.

3. Üretici AI için eklentiler (Önizleme) sayfasında, bir özel bağlayıcı eklentisi seçin ve ardından komut çubuğunda Aç'ı seçin.

4. Kullanıcı kimlik doğrulaması seç iletişim kutusunda , Bağlayıcıya bağlantı ayarlama bölümündeki üç nokta (...) düğmesini seçin ve ardından gerekli bağlantıyı seçin. Yeşil bir onay işareti veri kaynağının başarıyla bağlandığını gösterir.

5. Kullanıcı kimlik doğrulaması'nda, aşağıdaki seçeneklerden birini belirleyin:

   • Yönetici: Hizmet temsilcilerine veri erişimi vermek için yönetici kimlik doğrulamasını kullanır.
   • Aracı: Servis temsilcilerinin çalışma zamanında kimlik doğrulaması sağlamasını gerektirir. Bu seçenek, verilerin kısıtlı veya hassas olması durumunda önerilir.

6. Kullanıcı erişimini yönet ekranında, aşağıdaki erişim türlerinden birini seçin:

   • Copilot bulunan tüm temsilciler: Temsilci deneyimi profilleri aracılığıyla Copilot'ın etkinleştirildiği temsilciler.
   • Belirli kullanıcı rolleri: Listeden rolleri seçin.

7. İleri'yi seçin.

8. Girişleri tanımla(isteğe bağlı) ekranı görüntülenir. Bu adım isteğe bağlıdır ve Copilot yanıt oluşturmak için otomatik olarak kullanabileceği bağlam sağlamanıza olanak tanır. Bir giriş eklemezseniz, hizmet temsilcilerinin eklentiyi çalıştırırken bağlamı el ile belirtmeleri gerekir. Girişleri yapılandırmak ve bu özelliğin nasıl çalıştığı hakkında daha fazla bilgi edinmek için Girişleri tanımla bölümündeki adımları uygulayın.

9. Yanıtlar'da , Copilot öğesinin yanıtları yorumlamasını ve bunun yerine eklentide bulunan yanıtın tamamını sunmasını istiyorsanız Eklenti yanıtlarını özetleme'yi seçin.

10. İleri'yi seçin ve Eklenti verilerini Dynamics 365'a kaydet ekranında ve ardından Bu eklentinin verilerini Dynamics 365 Copilot transkriptine kaydet'i seçin. Veriler, Copilot ile hizmet temsilcinizin etkileşimlerinin bir parçası olarak sohbet dökümleri olarak Dataverse veritabanınızda saklanır. Copilot metinlerini ve etkileşim verileri bölümünde daha fazla bilgi edinin.

    Önemli

    Onay kutusunu seçip seçmemenize bakılmaksızın Copilot Studio tüm eklenti verilerini hizmet temsilcisi görüşme dökümlerinin bir parçası olarak kaydeder. Microsoft, bu bilgilere erişim sahibi değildir.

11. Eklentiyi aç'ı seçin.

12. Sayfanın üst kısmındaki uyarı iletisinde Değişiklikleri yayımla'yı seçin ve görüntülenen onay iletişim kutusunda Onayla'yı seçin. Değişikliklerin yayınlanması 15 dakikaya kadar sürebilir.

İstemler için girişleri tanımlama

Girdi tanımla (isteğe bağlı) ekranına girdiler eklediğinizde, ilgili verileri otomatik olarak dahil ederek isteminizin bağlam farkında olmasını sağlarsınız. Bu giriş, Copilot müşteri hizmetleri temsilcilerinin sistemde zaten var olan bilgileri manuel olarak girmesine gerek kalmadan belirtilen alanlara doğrudan erişmesini sağlar.

Girişleri yapılandırmazsanız istemler statik kalır ve bağlama erişme yeteneğinden yoksundur. Eklenti daha sonra servis temsilcilerinden manuel olarak girmeleri gereken ek bilgileri ister.

Örneğin, müşterinin adına ve servis talebi kimliğine göre müşterinin sipariş ayrıntılarını alan bir isteminiz var. Müşteri adı ve servis talebi kimliği alanlarını Girişleri tanımla (isteğe bağlı) alanına giriş olarak ekleyebilirsiniz.

Hizmet temsilcisi bir servis talebi açıp istemi tetiklediğinde, Copilot servis talebi kaydından müşteri adını ve servis talebi kimliğini otomatik olarak alır ve bunları isteme giriş olarak kullanır.

Katıştırılmış AI destekli aracıları için bir Parametre anahtarı oluşturmanız gerekir. Parametre anahtarı, Microsoft dışı CRM'den gerekli bağlamı almak için JavaScript dosyasında kullanılan benzersiz bir tanımlayıcıdır.

Parametre anahtarını ayarlama

Girişleri Tanımla sayfasında parametreleri ayarlamak için aşağıdaki adımları gerçekleştirin:

1. Kayıt türünü ve Veri alanını belirtin. Bu bilgileri, Parametre anahtarını oluşturmak için belirtmeniz gerekir.

2. Parametre anahtarındaki değeri kopyalamak için Kopyala seçeneğini seçin. Parametre anahtarı değeri, sistemin eklentiye girdi olarak ilettiği değeri depolamak için sistemin JavaScript içinde kullandığı bir değişkendir.

3. Kaydet'i seçin.

   

4. İleri'yi seçin, Dynamics 365'e eklenti verilerini kaydet'e gitmek ve ardından eklenti yapılandırmasını tamamlamak için adımları tamamlayın.

5. 2. adımda kopyaladığınız Parametre Anahtarı'nı JavaScript dosyasında kullanın. Eklentiye parametre anahtarını giriş olarak geçirin bölümünde daha fazla bilgi edinin.

6. Kurulumu tamamlamak için Microsoft olmayan CRM'lerde JavaScript dosyası URL'sini yapılandırın.

Parametre anahtarını eklentiye giriş olarak iletin

Parametre anahtarını ayarla adımının 2. adımında kopyaladığınız Parametre anahtarı değişkenini kullanan ve Microsoft CCaaS Embed SDK içindeki Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData işlevine abone olan bir JavaScript dosyası oluşturun. Aşağıdaki eylemler uygulanabilir:

• İşlev, eklenti verilerini alma isteğini dinler.
• Sistemden gerekli verileri alır ve değeri Parametre anahtarı değişkenine atar. Bu Parametre anahtarı değişkeni, Parametre anahtarını ayarla bölümünün 2. adımında kopyalanan değerdir.
• Parametre anahtarı değişkeninin değerini eklentiye döndürür. Eklenti bu değeri komut istemine giriş olarak kullanır.

Örneğin, Girişi Tanımla(isteğe bağlı) sayfasında iki Parametre Anahtarı, incident____customerid_account____accountid ve customerid_account____accountid ürettiniz. İşte eklentiye girdi olarak geçirilen incident____customerid_account____accountid için 1 değerini ve customerid_account____accountid için 2 değerini döndüren fonksiyonun örnek kodu.

Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData((request) => {
  return new Promise((resolve, reject) => {
    // 7 get plugin data
    const { objectData } = request;
    const pluginContext = objectData || {};
    const { entityId, entityName, parameters, parameterValues } = pluginContext;
    let responseData = null;
  console.log("External adapter plugin invoked...");
 
    if (entityName === "incident" && // sample entity name (case == incident)
      parameters.length > 0) {
      // copy parameter values
      const values = parameterValues;
      // override parameter values for 1P or 3P scenario
      parameters.forEach((param) => {
        if (param === "incident____customerid_account____accountid") {
          values[param] = "1";
        }
    
    if (param === "customerid_account____accountid") {
          values[param] = "2";
        }
      });
      // return the updated parameter values
      responseData = {
        entityId,
        entityName,
        parameters,
        parameterValues: values,
      };
    }
    const dataResponse = {
      objectId: request.objectId,
      objectType: request.objectType,
      data: responseData,
    };
  console.log("External adapter sending data from plugin:",responseData);
    resolve(dataResponse);
  });
});

Not

Kimlik doğrulama sorunlarını önlemek için bu dosyayı bir web sunucusunda barındırdığınızdan ve herkesin erişimine açtığınızdan emin olun.

Microsoft dışı CRM'lerde URL'yi yapılandırın

Copilot widget'ını Microsoft dışı CRM'nize yerleştirmek için kullandığınız Copilot yerleştirilebilir widget URL'sine JavaScript dosyanızın URL'sini, mevcut yerleştirme URL'sine "&copilotExtensionUrl=<URL to customer hosted .js file>" ekleyerek ekleyebilirsiniz.

Örneğin, JavaScript dosyanızın URL'si https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js ise, Microsoft dışı CRM'lerinize eklemeniz gereken URL aşağıdaki gibidir:

https://copilotforservice-prod.azureedge.net/widget/index.html?dynamicsUrl=https://X<your_org_URL>&copilotExtensionUrl=https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js

Eklentileri yönetme

Eklentileri yönetmek için komut menüsündeki seçenekleri kullanın. Düzenle düğmesi, eklenti ayarlarını güncellemenize ve değişiklikleri yayınlamanıza olanak tanır. Yayımlama işlemi devam ederken herhangi bir ayarı değiştiremezsiniz.

Dikkat edilmesi gereken noktalar

• Sadece bir eklenti eylemi ekleyebilirsiniz.
• Eklentiyi güncellerseniz eklentiyi Copilot Studio'de kaydedip yeniden yayınlamanızı öneririz. Değişiklikleri görmek için Copilot Service yönetim merkezindeki Üretici AI için eklentiler (Önizleme) bölümünde Yenile'yi seçebilirsiniz.