Del via


Opsætte den integrerede oplevelse i ServiceNow

Du kan indlejre Service in Microsoft 365 Copilot-agenter direkte i ServiceNow-skrivebordet med kontekstuel bevidsthed om den underliggende platform. Denne integration hjælper programmet med at give bedre svar og hjælper med yderligere at strømline arbejdsgangen for dine AI-agenter.

Forudsætninger

Inden du begynder, skal du have følgende miljøer og konsol:

  • En tjeneste i Microsoft 365 Copilot-instansen, der er forbundet til et ServiceNow-miljø.
  • Et ServiceNow-produktionsmiljø eller prøveversionsmiljø

Hvis dine kundeservicemedarbejdere skal kunne bruge agenter i ServiceNow, skal du desuden tildele dem rollerne Basisbruger og agent på omnikanal. Hvis du aktiverer Copilot for flere brugere, tildel de nødvendige roller til alle tiltænkte brugere og inkluder deres brugergrupper, når du konfigurerer widgetten i ServiceNow. Du kan få mere at vide under Tildele en sikkerhedsrolle til en bruger.

Integrere agenten i ServiceNow

  1. Udfør trinnene i Navigation for at kopiere URL-adressen til den integrerede widget # Copilot, der starter efter <iframe src=>. F.eks., https://copilotforservice-test.azureedge.net/widget/index.html?dynamicsUrl=https://XXXXXX.crm10.dynamics.com. Du bruger denne URL i Configure widget i ServiceNow-trinet.

  2. Installer viden-API-plug-in'en

    1. I dit ServiceNow-miljø, vælg Alle, søg efter plug-ins, og vælg derefter Systemdefinition>Plugins.
    2. Søg efter Viden API. Systemet skal returnere viden api plugin (app-id: sn_km_api).
    3. Vælg Viden API-kortet.
    4. Vælg Installér, og vælg derefter den seneste version.
    5. Vælg Installer nu, og vent derefter på, at Installationen af Knowledge API er fuldført.
  3. Installer Openframe-plugin'et

    1. I dit ServiceNow-miljø, vælg Alle, søg efter plug-ins, og vælg derefter Systemdefinition>Plugins.
    2. Søg efter Openframe. Systemet skal returnere openframe plugin (Plugin id: com.sn_openframe).
    3. Vælg Installer for at starte plugin-installationen.
    4. Vælg Installer, og vent derefter på, at installationen er fuldført.
  4. Installer Customer Service-plug-in'en

    1. I dit ServiceNow-miljø, vælg Alle, søg efter plug-ins, og vælg derefter Systemdefinition>Plugins.
    2. Søg efter com.sn_customerservice. Systemet skal returnere Customer Service (Plugin id: com.sn_customerservice).
    3. Vælg Installer for at starte plugin-installationen.
    4. Vælg Installer, og vent derefter på, at installationen er fuldført.
  5. Tilføj brugergrænseflade-scriptet til klassisk UI-navigator

    1. I dit ServiceNow-miljø skal du sikre dig, at du er i det globale arbejdsområde: Vælg globusikonet i øverste højre hjørne, og kontrollér derefter Programomfanget er angivet til Global.
    2. Vælg Alle, og søg derrefter efter UI Scripts, og vælg derefter System UI>UI Scripts.
    3. Vælg Ny, og udfyld følgende formular:
      • API-navn: Copilot-åben struktur til skrivebords-script

      • UI Type: Skrivebord

      • Markér afkrydsningsfeltet Global.

      • Script: Kopier indholdet i følgende script:

        (function () {
          try {
            var logMoniker = "Copilot Navigator UI script: ";
            if (
              !window.parent.navigationListenerAdded &&
              !window.copilotNavigationClassicListenerAdded
            ) {
              console.log(logMoniker + "loading desktop navigator....");
              var payload = {
                url: window.location.href,
                source: "classicUIScript",
                sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
                configType: "singleFrame"
              };
              var context = {
                payload: JSON.stringify(payload),
                method: "openframe_communication"
              };
              CustomEvent.fireAll("openframe_request", context);
        
              window.navigation.addEventListener("navigate", (event) => {
                console.log(
                  logMoniker +
                    "desktop PAGE NAVIGATED: " +
                    "\n Old Url: " +
                    window.location.href +
                    "\n New url: " +
                    event.destination.url
                );
        
                var payload = {
                  url: event.destination.url,
                  source: "classicUIScript",
                  sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
                  configType: "singleFrame"
                };
                var context = {
                  payload: JSON.stringify(payload),
                  method: "openframe_communication"
                };
                CustomEvent.fireAll("openframe_request", context);
              });
        
              window.copilotNavigationClassicListenerAdded = true;
            } else {
              console.log(logMoniker + "Skipping desktop navigator load....");
            }
          } catch (error) {
            console.log(logMoniker + "Classic UI navigator error");
            console.log(error);
          }
        })();
        
  6. Tilføj klientscriptet til arbejdsområdenavigator

    1. I dit ServiceNow-miljø skal du sikre dig, at du er i det globale arbejdsområde: Vælg globusikonet i øverste højre hjørne, og kontrollér derefter Programomfanget er angivet til Global.
    2. Vælg Alle, og søg derefter efter Scripts til klient, og vælg derefter System-definition>Klientscripts.
    3. Vælg Ny, og udfyld følgende formular:
    • Navn: Copilot-åben struktur til arbejdsområdenavigation-script

    • Tabel: Global [global]

    • Brugergrænsefladetype: Mobil/serviceportal

    • Type: onLoad

    • Script: Kopier indholdet i følgende script:

      function onLoad() {
          var table = g_form.getTableName();
          try {
              if (table == 'incident' || table == 'sys_email' || table == 'sn_customerservice_case' || table == 'interaction') {
                  var logMoniker = "Copilot Navigator Workspaces Client script: ";
      
                  if (!globalThis.copilotNavigationWorkspaceListenerAdded) {
                      console.log(logMoniker + "loading workspace navigator....");
                      var payload = {
                          url: globalThis.window.location.href,
                          source: "workspaceClientScript",
                          sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
                          configType: "singleFrame"
                      };
                      var context = {
                          payload: JSON.stringify(payload),
                          method: "openframe_communication"
                      };
                      globalThis.CustomEvent.fireAll("openframe_request", context);
      
                      globalThis.window.navigation.addEventListener("navigate", (event) => {
                          console.log(
                              logMoniker +
                              "Workspace PAGE NAVIGATED: " +
                              "\n Old Url: " +
                              globalThis.window.location.href +
                              "\n New url: " +
                              event.destination.url
                          );
      
                          var payload = {
                              url: event.destination.url,
                              source: "workspaceClientScript",
                              sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
                              configType: "singleFrame"
                          };
                          var context = {
                              payload: JSON.stringify(payload),
                              method: "openframe_communication"
                          };
                          globalThis.CustomEvent.fireAll("openframe_request", context);
                      });
      
                      globalThis.copilotNavigationWorkspaceListenerAdded = true;
                  } else {
                      console.log(logMoniker + "Workspace navigator already loaded....");
                  }
              }
          } catch (error) {
              console.error(logMoniker + "Workspace Navigator error");
              console.error(error);
          }
      }
      
  7. I dit ServiceNow-miljø skal du sikre dig, at du er i det globale arbejdsområde: Vælg globusikonet i øverste højre hjørne, og kontrollér derefter Programomfanget er angivet til Global.

    1. Vælg Alle, og søg derefter efter Scripts til klient, og vælg derefter System-definition>Klientscripts.
    2. Vælg Ny, og udfyld følgende formular:
    • Navn: Copilot-åben struktur til hændelsestabel-script

    • Tabel: Hændelse [incident]

    • UI Type: Skrivebord

    • Type: onLoad

    • Script: Kopier indholdet i følgende script:

        function onLoad() {
          try {
              var tableName = g_form.getTableName();
              var id = g_form.getUniqueValue();
              var payload = {
                  recordId: id,
                  objectType: tableName,
                  source: "classicClientScript",
                  sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
                  configType: "singleFrame"
              };
              var context = {
                  payload: JSON.stringify(payload),
                  method: "openframe_communication"
              };
              CustomEvent.fireAll("openframe_request", context);
          } catch (error) {
              console.log(
                  "Copilot Navigator UI script: CopilotClassicClientScriptCase navigator error"
              );
              console.log(error);
          }
      }
      

    d. Vælg Ny igen, og udfyld derefter formularen på følgende måde: - Navn: Copilot-åben struktur mailtabelscript - Tabel: Email [sys_email] - Brugergrænsefladetype: Skrivebord - Type: onLoad

    • Script: Kopier indholdet i følgende script:
      function onLoad() {
            try {
                var tableName = g_form.getTableName();
                var id = g_form.getUniqueValue();
                var payload = {
                    recordId: id,
                    objectType: tableName,
                    source: "classicClientScript",
                    sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
                    configType: "singleFrame"
                };
                var context = {
                    payload: JSON.stringify(payload),
                    method: "openframe_communication"
                };
                CustomEvent.fireAll("openframe_request", context);
            } catch (error) {
                console.log(
                    "Copilot Navigator UI script: CopilotClassicClientScriptCase navigator error"
                );
                console.log(error);
            }
         }
    

    e. Vælg Ny igen, og udfyld derefter formularen på følgende måde:

    • Navn: Copilot-åben struktur sagstabel-script

    • Tabel: Sag [sn_customerservice_case]

    • UI-type: Skrivebord

    • Type: onLoad

    • Script: Kopier indholdet i følgende script:

      function onLoad() {
          try {
              var tableName = g_form.getTableName();
              var id = g_form.getUniqueValue();
              var payload = {
                  recordId: id,
                  objectType: tableName,
                  source: "classicClientScript",
                  sourceId: "b54abfa8-3d78-4aa0-ae3f-1e2ffbc56850",
                  configType: "singleFrame"
              };
              var context = {
                  payload: JSON.stringify(payload),
                  method: "openframe_communication"
              };
              CustomEvent.fireAll("openframe_request", context);
          } catch (error) {
              console.log(
                  "Copilot Navigator UI script: CopilotClassicClientScriptCase navigator error"
              );
              console.log(error);
          }
      }
      
  8. Konfigurer widget i ServiceNow

    1. I dit ServiceNow-miljø, vælg Alle, søg efter OpenFrame, og vælg derefter OpenFrame>Konfigurationer.
    2. Klik på Ny i øverste højre hjørne.
    3. Skriv Microsoft Copilot for navn og titel.
    4. Skriv 450 for bredden og 600 for højden.
    5. Vælg de brugergrupper , du vil aktivere Service for i Microsoft 365 Copilot.
    6. Vælg låseikonet ved siden af URL-feltet for at låse det op, og indsæt derefter tjenesten i Microsoft 365 Copilot widget-URL'en, som du tidligere gemte, fra Servicen i Microsoft 365 Copilots adminside.
    7. Vælg Send.
    8. Opdater siden. Tjenesten i Microsoft 365 Copilot-widgetten burde være tilgængelig i den øverste navigationsbjælke for det ikon, du har valgt.
    9. Før du åbner Service i Microsoft 365 Copilot, skal du sikre dig, at du har tilladt pop-ups fra din ServiceNow-side.