Extienda los agentes Copilot o Copilot con acciones de conector (versión preliminar) Microsoft 365

Las acciones de conector le permiten definir conectores que se pueden invocar desde superficies de IA en Power Platform. Para las acciones del conector, debe identificar las acciones habilitadas para su uso en Copilot. También puede capturar la información que los modelos de lenguaje grandes requieren para identificar y utilizar eficazmente el complemento, como campos de resumen y descripción.

Requisitos previos

Se necesitan algunos requisitos previos para ampliar las experiencias de copiloto de marca Microsoft con acciones de conector.

Requisitos previos generales

Para todos los tipos de Copilot, debes tener credenciales de nivel de creador, una licencia de copiloto y una licencia de Microsoft Teams.

Microsoft 365 Requisitos previos para las ventas de Copilot agente y el servicio de Copilot Microsoft 365

Para el servicio Copilot agente y las ventas Copilot agente, debe iniciar sesión en una cuenta ambiente que contenga el agente que desea extender. Microsoft 365 Microsoft 365

Microsoft 365 Requisitos previos para las ventas de Copilot agente

• Los clientes de Salesforce deben iniciar sesión en su entorno Dataverse. Este entorno suele denominarse msdyn_viva.
• Debe iniciar sesión en Copilot ventas agente a través de Outlook en el ambiente que desea extender al menos una vez antes de extender. Microsoft 365

Agregar una acción de conector

Agregar una acción de conector a un copiloto de marca Microsoft implica unos pocos pasos. Las siguientes secciones proporcionan orientación sobre cómo agregar una acción de conector a Microsoft 365 Copilot, Microsoft 365 agente de Copilot y Microsoft 365 Copilot para ventas.

Seleccionar el agente y elige la acción del conector

1. En la página de inicio, Seleccionar Agentes.

   

2. En la lista de agentes en la navegación de la izquierda, Seleccionar el agente de Copilot que desea ampliar.

   

   Se muestra la página de descripción general de agente.

3. Seleccione la pestaña Acciones. Puede ver una lista de las acciones que ya están presentes en Copilot.

4. A continuación, seleccionar + Agregar una acción.

   Se le proporciona una lista de todos los tipos de acciones compatibles con agente de Copilot.

   

5. Seleccione Conector para extender con una acción de conector.

   Se muestra la página Seleccione su conector. Se le proporciona una lista de tipos de conectores disponibles para seleccionar.

   Los conectores conectan a los copilotos con diferentes servicios. La lista incluye todos los conectores certificados ofrecidos por Microsoft.

   Dependiendo del Copilot, la lista también puede incluir cualquier conector personalizado que esté presente en el entorno actual. Hay una barra de búsqueda disponible para ayudarle a encontrar el conector que desea utilizar.

   Nota

   En este momento, no se pueden agregar conectores personalizados Microsoft 365 Copilot servicio agente.

Seleccione el tipo de conector y seleccione una solución

1. Encuentre su tipo de conector usando la barra de búsqueda y selecciónelo.

   

   Se muestra la página Construya una acción de IA personalizada usando su conector.

2. Escriba un nombre y una descripción para el conector.

   El nombre del conector debe ser único. De manera predeterminada tomará el nombre del tipo de conector elegido. Debe agregar más información de definición para asegurarse de que sea un nombre único y que sea fácil discernir qué hace para los usuarios que quieran habilitarlo más adelante. Considere incluir en la descripción los tipos de acciones que permite, como "El servicio de correo le permite recuperar y crear mensajes".

   

   La descripción puede proporcionarse si está presente en el conector que seleccionó. Agente utiliza la descripción para identificar cuándo se puede utilizar la acción para obtener respuestas a la solicitud del usuario. Realice la descripción de la forma lo más detallada y descriptiva que pueda. Proporcione detalles específicos utilizando términos que espera que utilicen los usuarios al solicitar la acción. Para continuar con el ejemplo del servicio de correo, puede incluir algo como:

   "El servicio de correo brinda la capacidad de obtener listas de mensajes existentes, recuperar carpetas donde se almacenan los mensajes, enumerar títulos de mensajes y carpetas, obtener mensajes, actualizar títulos y cuerpos de mensajes, establecer prioridad para los mensajes".

   La descripción permite a agente de Copilot saber que debe utilizar la acción sin recibir instrucciones explícitas, lo que permite una experiencia de lenguaje más natural.

3. En Solución, una lista enumera todas las soluciones disponibles en el entorno actual. Seleccione la solución que desee usar. Para obtener más información sobre qué son las soluciones y por qué le benefician, consulte Conceptos de solución.

   

   Si tiene una solución preferida o el conector seleccionado ya está en la solución, esa solución se selecciona automáticamente. Puede seleccionar una solución o dejarla en blanco. Si la deja en blanco la solución, se creará una solución con el nombre de la acción y el editor predeterminado. Almacenar su acción en una solución le permite moverla fácilmente entre entornos.

   Nota

   En este caso, no verá la solución predeterminada ni la solución predeterminada de CDS como opción, ya que recomendamos tener una solución personalizada para facilitar la administración. Para obtener más información, consulte : Solución predeterminada frente a solución personalizada.

4. Elija una solución y seleccione Siguiente.

   Se mostrará la página Seleccionar y configure su acción de complemento . Esta página muestra todas las acciones que están disponibles para añadirlas a su conector. Puede seleccionar y configurar cualquier acción que desea que admita su copiloto, una a la vez. Se incluye una barra de búsqueda para ayudarle a encontrar la acción que desea seleccionar. No hay límite para la cantidad de acciones que puede seleccionar para el conector.

   

Agregar acciones al conector

A continuación, debe seleccionar entre las acciones disponibles para agregarlas al conector.

Nota

Los conectores solo ejecutan las acciones que usted selecciona y configura específicamente aquí. Si una acción no aparece en la lista, entonces no está disponible. No es posible agregar o eliminar acciones de un conector desde el asistente de acciones de Copilot Studio.

1. Seleccione una acción para continuar. La página Configurar su acción de complemento se muestra para esa acción elegida.

   

2. Proporcione un nombre y una descripción para su acción. En este caso, el nombre no tiene por qué ser único. Lo más probable es que estos valores se completen desde el conector. Sin embargo, al igual que con la descripción del conector, debe proporcionar una descripción detallada para que agente sepa cuándo invocar la acción específica. La descripción ayuda a permitir un enfoque de lenguaje más natural para seleccionar la acción que se va a ejecutar. Por ejemplo, si una acción es "Mostrar una lista de carpetas de mensajes", podría utilizar:

   "Mostrar una lista de carpetas de mensajes le permite obtener una lista de todas las carpetas de mensajes disponibles en el servicio de correo. Esta acción recupera todas las carpetas, las colocará en una vista de lista y se las devuelve".

   La descripción de la acción proporciona las claves de contexto "enumerar carpetas de mensajes", "obtener", "todos", "recuperar", "enumerar", "servicio de correo", "devolver", "carpetas" y "ver". Su copiloto puede usar estas claves de contexto para identificar cuándo la acción es la correcta para una solicitud de usuario.

3. Después de completar la página, seleccione Siguiente. Se muestra la página Revisar los parámetros de su acción.

4. Seleccione Siguiente para continuar.

   Esta acción le lleva de vuelta a la página Seleccionar y configurar su acción de complemento. Podrás ver la nueva acción que ha seleccionado.

   

5. Seleccione otra acción y repita los pasos de configuración de la acción anterior si lo desea.

   De forma alternativa, seleccione Siguiente. Se muestra la pantalla Revisar, probar y publicar su acción.

   

   La página Revisar, probar y publicar su acción muestra los detalles de todos los pasos de configuración hasta este punto. Puede revisarlos y luego probar su acción antes de publicarlos.

Prueba

Una vez configurada la acción del conector, ahora puede probarla.

Nota

En este momento, el servicio Copilot agente no permite realizar pruebas desde dentro del asistente de creación de acciones del conector. Microsoft 365 Cuando esta función esté disponible, podrá probar el complemento desde esta pantalla. Por ahora los usuarios deben publicar el complemento y luego pueden validar que sea funcional dentro del servicio Copilot agente directamente después de que sea habilitado por un Administrador. Microsoft 365

1. Seleccione su conexión existente en el menú desplegable o seleccione + Nueva conexión si no tiene una conexión.

   Si selecciona + Nueva conexión, se abre un asistente donde puede agregar detalles para establecer la conexión. Cuando esté listo, podrá seleccionar la nueva conexión desde el menú desplegable.

2. Cuando haya seleccionado una conexión, seleccione Acción de prueba.

3. Cuando vea un mensaje que indique que la acción está lista para probar, haga clic en Seleccionar Abrir para probar para abrir el chat copiloto en una nueva ventana. Abra el menú lateral para ver la acción y actívela.

   La acción aparece con un icono de vaso de precipitados debajo del conector elegido con formato Nombre de prueba-acción.

4. Ahora puede probar el complemento probando las indicaciones que espera que utilice el usuario. También puede utilizar el comando –developer on para obtener más información sobre la ejecución de la indicación. Una vez que esté satisfecho con los resultados, regrese a la ventana de Copilot Studio.

Publicar

1. Una vez que haya terminado de probar, seleccione Publicar.

   Se muestra una página que muestra que su conector está en proceso de publicación. Una vez completado, verá una página que indica que su conector se ha publicado.

2. Seleccione Ir a la página Detalles para ver los detalles del conector publicado.

   Nota

   Ahora que su conector está publicado, un administrador debe habilitarlo antes de que el copiloto pueda utilizarlo. Si no ve el conector en copiloto, asegúrese de que el conector esté habilitado a través del Centro de administración de Microsoft o de la página de agentes de copiloto. Una vez habilitado correctamente, el conector se mostrará en el desplegable. Este paso puede tener un retraso de hasta 24 horas la primera vez que lo haga.

3. También puede mover fácilmente un conector de un entorno a otro utilizando una solución. Para ello, seleccione Exportar solución en la página de detalles. Exportar la solución le permite exportar el conector.

   

4. Cambie el número de versión si es necesario y seleccione si la solución debe ser Administrada o No administrada.

   • Administrado significa que no espera tener que realizar más cambios en la solución.
   • No administrado significa que desea realizar cambios en la solución en el entorno de destino.

5. Al finalizar, verá un mensaje verde con la opción de Descargar la solución, que guarda el archivo .zip en su sistema.

   Nota

   No es necesario que seleccione Publicar en el panel de soluciones.

6. Regrese a la página agente Acciones en Copilot Studio e Seleccionar Importar solución en el destino ambiente.

   

7. Explore para seleccionar el archivo .zip para su solución exportada y seleccione Siguiente para continuar. Podrá ver cómo aparece el conector en la lista Acciones.

Eliminar una acción de conector

Si necesita eliminar una acción de conector, ejecute el procedimiento siguiente.

Localizar la solución utilizada por la acción del conector

El procedimiento para eliminar una acción de conector se lleva a cabo en Power Apps Maker Portal. Sin embargo, necesita la solución utilizada para la acción del conector en Copilot Studio.

1. Abierto Copilot Studio.

2. Seleccione el entorno utilizado para crear la acción del conector.

3. En Agentes, Seleccionar el agente donde se creó la acción del conector.

4. Seleccionar la pestaña Acciones para ver la lista de acciones asociadas con agente.

5. Seleccione la acción que desea eliminar y anote el nombre de la solución.

   

Eliminar conector en Power Apps Maker Portal

1. Vaya al Maker Portal (https://make.powerapps.com) y seleccione el entorno que utilizó en Copilot Studio para crear acciones.

2. En el panel de navegación, seleccione Soluciones para ver la lista de las soluciones instaladas en el entorno.

3. Localice la solución que utilizó para crear la acción y selecciónela.

   Aparece una lista de objetos asociados con la solución.

4. Busque la acción de conector que desea eliminar. La acción es de tipo AIPlugin.

   Propina

   Si no ve su acción en la solución, muévala del estado de borrador al estado listo publicándola.

5. Antes de eliminar la acción, debe eliminar la dependencia en la tabla AICopilot_AIPlugin. En primer lugar, seleccione Avanzado>Mostrar dependencias.

   

   Se muestran las dependencias de la acción del conector.

6. Para la entrada AICopilot_AIPlugin en la lista de dependencias, seleccione Eliminar.

   

7. Regrese a la lista de objetos y elimine la acción seleccionando Quitar>Eliminar de este entorno.

   

8. Elimine todas las operaciones de tipo AIPluginOperation en la tabla seleccionando Quitar>Eliminar de este entorno.

   

9. Vuelva a Copilot Studio para comprobar que la acción se ha eliminado de la vista Acciones del Copilot.

Nota

Este procedimiento elimina la acción de la lista Acciones. Sin embargo, esto no eliminará ninguna conexión creada con el origen de datos.