Habilitar complementos para IA generativa (versión preliminar)

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Sus representantes del servicio al cliente (representantes de servicio o representantes) dependen de los datos y la información procedentes de una amplia variedad de sistemas. Con los complementos, puede interactuar directamente con sus datos de CRM que no son de Microsoft. Esta interacción directa, puede reducir la necesidad de que los representantes de servicio cambien a otras pestañas y herramientas para hacer su trabajo y mejorar el tiempo de resolución y la satisfacción del cliente.

Requisitos previos

• En Copilot Studio, si quiere usar un complemento prompt en su agente de IA integrado, cree un complemento prompt.
• En Copilot Studio, si quiere usar un complemento de conector en el agente de IA embebido, cree un complemento de conector personalizado.

Configurar complementos

Para usar el plugin de prompt o el plugin de conector en el agente de IA incrustado después de crear el plugin en Copilot Studio, debe habilitar el plugin desde el centro de administración. Las siguientes secciones describen cómo habilitar y configurar complementos.

Definir entradas para indicaciones

Al agregar entradas en la pantalla Definir entradas (opcional), permite que la solicitud tenga en cuenta el contexto mediante la incorporación automática de datos relevantes. Esta entrada permite que Copilot acceda directamente a los campos especificados sin necesidad de que los representantes de servicio al cliente escriban manualmente la información que ya existe en el sistema.

Si no configura las entradas, las indicaciones permanecen estáticas y carecen de la capacidad de acceder al contexto. A continuación, el plugin solicita a los representantes de servicio información adicional que deben introducir manualmente.

Por ejemplo, tiene un comando que recupera los detalles del pedido de un cliente en función del nombre del cliente y el ID de caso. Puede agregar los campos Nombre del cliente e Id. de caso como entrada en Definir entradas (opcional).

Cuando un representante del servicio abre un caso y desencadena el mensaje, Copilot recoge automáticamente el nombre del cliente y el identificador de caso del registro de casos y los usa como entradas para el mensaje.

En el caso de los agentes de IA integrados, debe generar una Clave de parámetro. La clave de parámetro es un identificador único que se usa en un archivo JavaScript para recuperar el contexto necesario del CRM que no es de Microsoft.

Configurar la clave de parámetro

Para configurar los parámetros en la página Definir entradas, realice los siguientes pasos:

1. Especifique el Tipo de registro y el campo de datos. Debe especificar esta información para generar la Clave de parámetro.

2. Seleccione Copiar para copiar el valor en Clave de parámetro. El valor de la clave de parámetro es una variable que el sistema utiliza en un JavaScript para almacenar el valor que el sistema pasa al complemento como entrada.

3. Haga clic en Guardar.

   

4. Seleccione Siguiente para ir a Guardar datos del complemento en Dynamics 365 y, a continuación, complete los pasos para finalizar la configuración del complemento.

5. Utilice la Clave de parámetro en el archivo JavaScript que copió en el paso 2. Obtenga más información en Pasar la clave de parámetro como entrada al complemento.

6. Configure la dirección URL del archivo JavaScript en CRM no Microsoft para completar la configuración.

Pase la clave de parámetro como entrada al complemento

Cree un archivo JavaScript que use la variable Parameter Key que copió en el paso 2 de Configurar la clave de parámetro y se suscribe a la función Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData dentro del SDK de Microsoft CCaaS Embed. Son aplicables las siguientes acciones:

• La función escucha una solicitud para obtener datos del complemento.
• Recupera los datos necesarios del sistema y asigna el valor a la variable Clave de parámetro. Esta variable clave de parámetro es el valor copiado en el paso 2 de la sección Configurar la clave del parámetro.
• Devuelve el valor de la variable Clave de parámetro al complemento. El plugin utiliza este valor como entrada para el mensaje.

Por ejemplo, generó dos Claves de parámetroincident____customerid_account____accountid y customerid_account____accountid en la página Definir entrada (opcional). Este es el código de ejemplo de la función que devuelve un valor de 1 para incident____customerid_account____accountid y 2 para customerid_account____accountid que luego se pasan como entradas al complemento.

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

Configurar la URL en CRM no de Microsoft

Puede añadir la URL de su archivo JavaScript a la URL del widget incrustable de Copilot que utiliza para insertar el widget de Copilot en un CRM que no sea de Microsoft agregando "&copilotExtensionUrl=<URL to customer hosted .js file>" a la URL de incrustación existente.

Por ejemplo, si la dirección URL de su archivo JavaScript es https://embedcopilotnonprod.blob.core.windows.net/embedcopilotnonprodcontainer/demopromptplugin.js, la dirección URL que debe agregar en los CRM que no son de Microsoft es la siguiente:

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

Administrar complementos

Utilice las opciones en el menú de comandos para administrar los complementos. El botón de edición te permite actualizar la configuración del complemento y publicar los cambios. No se puede cambiar ninguna configuración mientras la publicación está en proceso.

Consideraciones

• Solo puede agregar una acción de complemento.
• Si actualiza el complemento, se recomienda guardar y volver a publicar el complemento en Copilot Studio. A continuación, puede seleccionar Refresh en Plugins para IA Generativa (versión preliminar) en el centro de administración del servicio Copilot para ver los cambios.