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 desea utilizar un complemento de solicitud en su agente de IA insertado, cree un complemento de solicitud.
• En Copilot Studio, si desea utilizar un complemento de conector en su agente de IA insertado, cree un complemento de conector personalizado.

Configurar complementos

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

Definir entradas para solicitudes

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 a Copilot acceder directamente a los campos especificados sin necesidad de que los representantes del servicio al cliente especifiquen 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 una indicación que recupera los detalles del pedido de un cliente en función del nombre del cliente y el identificador del caso. Puede agregar los campos Nombre del cliente e Id. de caso como entrada en Definir entradas (opcional).

Cuando un representante de servicio abre un caso y desencadena la solicitud, Copilot selecciona automáticamente el nombre del cliente y el ID del caso del registro del caso y los usa como entradas para la solicitud.

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. Seleccione Guardar.

   

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

5. Utilice la Clave de parámetro que copió en el paso 2 en el archivo JavaScript. 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 Clave de parámetro que copió en el paso 2 de Configurar la clave del parámetro y se suscriba a la función Microsoft.CCaaS.EmbedSDK.Copilot.onGetPluginData dentro del SDK de inserción de Microsoft CCaaS. 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 anexar la dirección URL del archivo JavaScript a la dirección URL del widget insertable de Copilot que usa para insertar el widget Copilot en su CRM que no es de Microsoft agregando "&copilotExtensionUrl=<URL to customer hosted .js file>" a la dirección URL de inserció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, le recomendamos que guarde y vuelva a publicarlo in Copilot Studio. A continuación, puede seleccionar Actualizar en complementos para IA generativa (versión preliminar) en el Centro de administración de Copilot Service para ver los cambios.