Włączanie dodatków plug-in dla generatywnej AI (wersja zapoznawcza)

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Przedstawiciele działu obsługi klienta (przedstawiciele lub przedstawiciele) polegają na danych i informacjach z wielu różnych systemów. Za pomocą wtyczek można wchodzić w bezpośrednią interakcję z danymi CRM firmy innej niż Microsoft. Ta bezpośrednia interakcja pomaga zmniejszyć potrzebę przełączania się przedstawicieli obsługi na inne karty i narzędzia w celu wykonywania swojej pracy, a także skraca czas rozwiązywania problemów i zwiększa zadowolenie klientów.

Wymagania wstępne

• W Copilot Studio, jeśli chcesz użyć wtyczki monitu w osadzonym agent AI, utwórz wtyczkę monitu.
• W Copilot Studio, jeśli chcesz użyć wtyczki monitu w osadzonym agent AI, utwórz wtyczkę monitu.

Konfigurowanie wtyczek

Aby użyć wtyczki monitu lub wtyczki łącznika w osadzonym agent AI po utworzeniu wtyczki w Copilot Studio należy włączyć wtyczkę w centrum administracyjnym. W poniższych sekcjach opisano sposób włączania i konfigurowania wtyczek.

Monit na dodatek plug-in

1. W centrum administracyjnym usługi Copilot wybierz pozycję Produktywność.
2. Na stronie Produktywność wybierz pozycję Zarządzaj dla opcji Wtyczki dla generatywnej AI (wersja zapoznawcza). Zostanie wyświetlona strona Wtyczki dla generujący AI (wersja zapoznawcza) ze wszystkimi monitami dotyczącymi wtyczek wygenerowanymi dla środowiska.
3. Wybierz tabelę, którą chcesz włączyć dla ról połączenia, a następnie na pasku poleceń wybierz pozycję Włącz.
4. W obszarze Wybierz typ dostępu wybierz jeden z następujących typów:
   • Wszyscy agenci, którzy mają Copilot: agenci, dla których włączono obsługę Copilot za pośrednictwem profilów doświadczenia agentów.
   • Konkretne role użytkowników: Wybierz role z listy.
5. Zostanie wyświetlony ekran Definiowanie danych wejściowych (opcjonalnie). Ten krok jest opcjonalny i umożliwia podanie kontekstu, którego Copilot może automatycznie użyć do wygenerowania odpowiedzi. Jeśli nie dodasz danych wejściowych, przedstawiciele usługi muszą ręcznie określić kontekst podczas uruchamiania wtyczki. Aby skonfigurować dane wejściowe i dowiedzieć się więcej o tym, jak działa ta funkcja, wykonaj kroki opisane w sekcji Definiowanie danych wejściowych .
6. Wybierz przycisk Dalej, a następnie na ekranie Dane wtyczki wybierz pozycję Przechowuj dane tej wtyczki. Dane są przechowywane w Twojej Dataverse bazie danych jako transkrypcje czatu z interakcji Twojego przedstawiciela działu obsługi z Copilot. Więcej informacji: Pobieranie transkrypcji i danych interakcji usługi Copilot.
7. Wybierz opcję Włącz plugin.
8. Wybierz pozycję Opublikuj zmiany w komunikacie alertu w górnej części strony, a następnie wybierz pozycję Potwierdź w wyświetlonym oknie dialogowym potwierdzenia. Opublikowanie zmian może potrwać do 15 minut.

Niestandardowy łącznik-wtyczka

1. Na mapie witryny centrum administracyjnego usługi Copilot wybierz jeden z następujących kroków, aby uzyskać dostęp do wtyczek:

   • Wybierz Produktywność>Dodatek plugin dla generatywnej AI (wersja zapoznawcza) w Doświadczenie agenta.
   • Wybierz Wgląd>Dodatki plugin dla generatywnej AI (wersja zapoznawcza) w Operacje.

2. Zaznacz Zarządzaj.

3. Na stronie Wtyczki dla generatywnej AI (wersja zapoznawcza) wybierz łącznik niestandardowy, a następnie wybierz pozycję Włącz na pasku poleceń.

4. W oknie dialogowym Wybieranie uwierzytelniania użytkownika wybierz przycisk wielokropka (...) w obszarze Konfiguruj link do łącznika, a następnie wybierz wymagane połączenie. Zielony znacznik wyboru oznacza, że źródło danych się pomyślnie.

5. W Uwierzytelnianie użytkownika, wybierz jedną z poniższych opcji:

   • Administrator: używa uwierzytelniania administratora, aby udzielić dostępu do danych przedstawicielom działu obsługi.
   • Agent: wymaga od przedstawicieli działu obsługi uwierzytelniania w czasie wykonywania. Ta opcja jest zalecana, jeśli dane są ograniczone lub poufne.

6. Na ekranie Zarządzaj dostępem użytkowników wybierz jeden z następujących typów dostępu:

   • Wszyscy agenci, którzy mają Copilot: agenci, dla których włączono obsługę Copilot za pośrednictwem profilów doświadczenia agentów.
   • Konkretne role użytkowników: Wybierz role z listy.

7. Wybierz Dalej.

8. Zostanie wyświetlony ekran Definiowanie danych wejściowych (opcjonalnie). Ten krok jest opcjonalny i umożliwia podanie kontekstu, którego Copilot może automatycznie użyć do wygenerowania odpowiedzi. Jeśli nie dodasz danych wejściowych, przedstawiciele usługi muszą ręcznie określić kontekst podczas uruchamiania wtyczki. Aby skonfigurować dane wejściowe i dowiedzieć się więcej o tym, jak działa ta funkcja, wykonaj kroki opisane w sekcji Definiowanie danych wejściowych .

9. W obszarze Odpowiedzi wybierz pozycję Nie podsumowuj odpowiedzi wtyczek, jeśli nie chcesz, aby Copilot interpretował odpowiedzi, a zamiast tego przedstawiał całą odpowiedź, która jest dostępna we wtyczce.

10. Wybierz Dalej i na ekranie Zapisz dane wtyczki w Dynamics 365 wybierz Zapisz dane tej wtyczki w transkrypcji Dynamics 365 Copilot. Dane są przechowywane w Twojej Dataverse bazie danych jako transkrypcje czatu z interakcji Twojego przedstawiciela działu obsługi z Copilot. Więcej informacji: Pobieranie transkrypcji i danych interakcji usługi Copilot.

    Ważne

    Niezależnie od tego, czy zaznaczysz pole wyboru, Copilot Studio zapisuje wszystkie dane wtyczki jako część transkrypcji rozmów agenta. Firma Microsoft nie ma dostępu do tych informacji.

11. Wybierz opcję Włącz plugin.

12. Wybierz pozycję Opublikuj zmiany w komunikacie alertu w górnej części strony, a następnie wybierz pozycję Potwierdź w wyświetlonym oknie dialogowym potwierdzenia. Opublikowanie zmian może potrwać do 15 minut.

Definiowanie danych wejściowych dla monitów

Po dodaniu danych wejściowych na ekranie Definiowanie danych wejściowych (opcjonalnie) monit staje się zależny od kontekstu dzięki automatycznemu dołączaniu odpowiednich danych. To wprowadzenie umożliwia firmie Copilot bezpośredni dostęp do określonych pól bez konieczności ręcznego wprowadzania przez przedstawicieli działu obsługi klienta informacji, które już istnieją w systemie.

Jeśli nie skonfigurujesz danych wejściowych, monity pozostaną statyczne i nie będą miały dostępu do kontekstu. Następnie wtyczka prosi przedstawicieli serwisu o dodatkowe informacje, które muszą wprowadzić ręcznie.

Na przykład istnieje monit, który pobiera szczegóły zamówienia klienta na podstawie jego nazwy i identyfikatora sprawy. Pola Nazwa klienta i Identyfikator przypadku można dodać jako dane wejściowe w obszarze Definiowanie danych wejściowych (opcjonalnie).

Gdy przedstawiciel działu obsługi otwiera sprawę i wyzwala monit, Copilot automatycznie pobiera nazwę klienta i identyfikator sprawy z rekordu sprawy i używa ich jako danych wejściowych monitu.

W przypadku osadzonych agentów AI należy wygenerować klucz parametru. Klucz parametru jest unikatowym identyfikatorem, który jest używany w pliku JavaScript w celu pobrania wymaganego kontekstu z CRM innego niż Microsoft.

Konfigurowanie klucza parametrów

Aby skonfigurować parametry na stronie Definiowanie danych wejściowych, wykonaj następujące kroki:

1. Określ Typ rekordu i Pole danych. Te informacje należy określić, aby wygenerować klucz parametru.

2. Wybierz Kopiuj , aby skopiować wartość w Klucz parametru. Wartość klucza parametru jest zmienną, której system używa w JavaScript do przechowywania wartości, którą system przekazuje do wtyczki jako dane wejściowe.

3. Wybierz pozycję Zapisz.

   

4. Wybierz przycisk Dalej , aby przejść do pozycji Zapisz dane wtyczki w Dynamics 365, a następnie wykonaj kroki, aby zakończyć konfigurację wtyczki.

5. Użyj klucza parametru skopiowanego w kroku 2 w pliku JavaScript. Dowiedz się więcej w temacie Przekazywanie klucza parametru jako danych wejściowych do wtyczki.

6. Skonfiguruj adres URL pliku JavaScript w systemach CRM innych niż Microsoft, aby ukończyć konfigurację.

Przekaż klucz parametru jako dane wejściowe do wtyczki

Utwórz plik JavaScript, który używa zmiennej Klucz parametru skopiowanej w kroku 2 parametruUstawianie klucza i subskrybuje do Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData funkcję w zestawie SDK osadzania Microsoft CCaaS. Dostępne są poniższe akcje:

• Funkcja nasłuchuje żądania pobrania danych wtyczki.
• Pobiera wymagane dane z systemu i przypisuje wartość do zmiennej Klucz parametru. Ta klucz parametru zmienna jest wartością skopiowaną w kroku 2 sekcji Ustawienie klucza parametru.
• Zwraca wartość zmiennej klucz parametru do wtyczki. Wtyczka używa tej wartości jako danych wejściowych monitu.

Na przykład wygenerowano dwa klucze parametru, incident____customerid_account____accountid i customerid_account____accountid na stronie Definiowanie danych wejściowych (opcjonalnie). Oto przykładowy kod funkcji, która zwraca wartość 1 dla incident____customerid_account____accountid i 2 dla customerid_account____accountid , które są następnie przekazywane jako dane wejściowe do wtyczki.

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);
  });
});

Notatka

Upewnij się, że przechowujesz ten plik na serwerze internetowym i udostępniasz go publicznie, aby uniknąć problemów z uwierzytelnianiem.

Konfiguruj w usłudze Microsoft

Adres URL pliku JavaScript można dołączyć do adresu URL widżetu Copilot do osadzenia, który jest używany do osadzania widżetu Copilot w systemie CRM firmy innej niż Microsoft, dodając "&copilotExtensionUrl=<URL to customer hosted .js file>" go do istniejącego adresu URL osadzania.

Jeśli na przykład adres URL pliku JavaScript to https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js adres URL, który należy dodać w systemach CRM innych niż Microsoft, jest następujący:

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

Zarządzanie wtyczkami

Użyj opcji w menu poleceń, aby zarządzać wtyczkami. Przycisk edycji umożliwia aktualizację ustawień wtyczki i opublikowanie zmian. Nie możesz zmienić żadnych ustawień, gdy publikowanie jest w toku.

Kwestie wymagające rozważenia

• Można dodać tylko jedną akcję wtyczki.
• Jeśli zaktualizujesz wtyczkę, zalecamy zapisanie i ponowne opublikowanie wtyczki w programie Copilot Studio. Następnie możesz wybrać pozycję Odświeżwtyczki dla AI generatywnej (wersja zapoznawcza) w centrum administracyjnym usługi Copilot, aby wyświetlić zmiany.