Instalar el kit de agente Copilot

Copilot Agent Kit es un kit de herramientas de código abierto para probar y evaluar agentes de Copilot Studio. Por ejemplo, le ayuda a definir casos de prueba, simular consultas de usuario y validar las respuestas del agente. Este artículo ofrece instrucciones paso a paso para instalar el kit desde Marketplace o GitHub, junto con pasos posteriores al despliegue y opciones de configuración.

Instala el Kit de Agente Copilot desde el Marketplace

Si prefieres instalar Copilot Agent Kit desde GitHub, salta a Instalar Copilot Agent Kit desde GitHub.

Despliegue desde el Marketplace

Para desplegar el Kit de Agente Copilot desde Marketplace, sigue estos pasos:

1. Ve al kit de agente de Copilot en el mercado.
2. Seleccione Instálelo ahora.
3. Inicie sesión si es necesario.
4. En la vista Instalar el Kit de Agente Copilot, selecciona el entorno donde quieres desplegar el Kit de Agente Copilot.
5. Revise los términos y las declaraciones. Si está de acuerdo, active las casillas y seleccione Instalar.

Comienza la instalación del Copilot Agente Kit.

Pasos posteriores al despliegue (Marketplace)

Una vez finalizada la instalación, siga estos pasos posteriores a la implementación:

1. Inicie sesión en Power Apps.
2. Vaya a Soluciones.
3. Seleccione Solución predeterminada.
4. Seleccione Referencias de conexión.
5. Localiza el Kit de Agente Copilot - Dataverse y ábrelo para editarlo.
6. Asegúrese de que se rellenan todos los campos obligatorios y de que la conexión seleccionada es válida. Cree una nueva conexión a Dataverse según sea necesario.
7. Haga clic en Guardar.
8. Siga los pasos de configuración adicionales y opcionales.

Instala el Kit de Agente Copilot desde GitHub

Sigue estos pasos para instalar Copilot Agent Kit desde GitHub. Si prefieres instalar desde el Marketplace, ve a Instalar el Kit de Agente Copilot desde el Marketplace.

Descarga de la versión más reciente de GitHub

Descarga la última versión de la solución gestionada para el Power CAT Copilot Agent Kit.

Instalar el archivo zip gestionado del Copilot Agent Kit

Para instalar la solución gestionada del Copilot Agent Kit:

1. Inicie sesión en Power Apps.
2. Selecciona el entorno donde quieres instalar el Kit de Agente Copilot.
3. Vaya a Soluciones.
4. Seleccione Importar solución.
5. Haga clic en Examinar.
6. Seleccione el archivo CopilotStudioKit*_managed.zip.
7. Seleccione Siguiente.
8. Después de revisar la información de la solución, seleccione Siguiente.
9. Si se le solicita, cree las conexiones necesarias y seleccione Importar.
10. Deje los valores del informe KPIs de conversación tal como están por ahora. Puede actualizar estos valores más adelante.
11. Espere a que finalice la operación de importación.

Actualización de la solución existente (GitHub)

Para actualizar a la última versión del Kit de Agente Copilot, sigue estos pasos:

1. Inicie sesión en Power Apps.
2. Selecciona el entorno donde quieres mejorar el Kit de Agente Copilot.
3. Vaya a Soluciones.
4. Seleccione Importar solución.
5. Haga clic en Examinar.
6. Seleccione CopilotStudioKit*_managed.zip.
7. Seleccione Siguiente. Power Apps reconoce que esta actualización es una solución administrada existente.
8. Para confirmar que desea actualizar la solución existente, seleccione Siguiente.
9. Deje los valores del informe KPIs de conversación tal como están por ahora. Puede actualizar estos valores más adelante.
10. Seleccione Importar.

Pasos de configuración adicionales y opcionales

Estos pasos de configuración se aplican tanto si instalaste el Copilot Agent Kit desde Marketplace como desde GitHub.

Configurar la sincronización de SharePoint

Los pasos siguientes son opcionales y solo son necesarios si planea usar la característica de sincronización de SharePoint . Puede establecer estos valores en cualquier momento antes de usar la característica.

Dirige la conexión a SharePoint al sitio de SharePoint de origen. Apunte la dirección URL de Dataverse a la instancia de Dataverse para los agentes personalizados de destino donde se sincroniza el contenido.

Puede seguir estos pasos o usar el Asistente para Setup para configurar la referencia de conexión de SharePoint.

Para usar la característica de sincronización de SharePoint:

1. Instala el Kit de Agente Copilot, descrito anteriormente en este artículo.
2. Inicie sesión en Power Apps.
3. Vaya a Soluciones.
4. Seleccione Solución predeterminada.
5. Seleccione Referencias de conexión.
6. Localiza la referencia de conexión Copilot Agent Kit - SharePoint y ábrela para editarla.
7. Asegúrese de que todos los campos obligatorios se rellenan y que la conexión seleccionada es válida. Cree una nueva conexión a SharePoint según sea necesario.
8. Haga clic en Guardar.

Más información: Aprende sobre cómo configurar agentes en Copilot Agent Kit, incluyendo cómo configurar un nuevo agente para la sincronización de archivos.

Configuración del inventario del agente

Los pasos siguientes son opcionales y solo son necesarios si planea usar la característica Inventario del agente . Puede establecer estos valores en cualquier momento antes de usar la característica.

Las referencias de conexión en la solución controlan la visibilidad de los agentes. Aunque puede usar otras cuentas, use estos permisos para obtener visibilidad completa.

• Copilot Agent Kit - Power Platform for Admins recupera la lista de entornos en el tenant. Requiere permisos de nivel de administrador de Power Platform.
• Kit de Agente Copilot - Dataverse recopila la información del agente de los entornos. Requiere permisos de nivel de administrador del sistema para todos los entornos.

Puedes seguir estos pasos o usar el Asistente de Configuración para configurar las referencias de conexión del Inventario de Agentes.

Para usar la característica Inventario del agente:

1. Instala el Kit de Agente Copilot, descrito anteriormente en este artículo.
2. Inicie sesión en Power Apps.
3. Vaya a Soluciones.
4. Seleccione Solución predeterminada.
5. Seleccione Referencias de conexión.
6. Localiza la referencia de conexión del Kit de Agente Copilot - Power Platform for Admins y ábrela para editarla.
7. Asegúrese de que se rellenan todos los campos obligatorios y que la conexión seleccionada es válida.
8. Haga clic en Guardar.
9. Localiza la referencia de conexión Copilot Agent Kit - Dataverse y ábrela para editarla.
10. Asegúrese de que se rellenan todos los campos obligatorios y que la conexión seleccionada es válida.
11. Haga clic en Guardar.

Habilitación de flujos

Para habilitar los flujos de la nube incluidos en el Kit de Agente Copilot, sigue estos pasos o utiliza el Asistente de Configuración.

1. Instala el Kit de Agente Copilot, descrito anteriormente en este artículo.
2. Inicie sesión en Power Automate.
3. Asegúrate de seleccionar el entorno con el Kit de Agente Copilot.
4. Seleccione Soluciones.
5. Selecciona el kit de agente Copilot.
6. Seleccione Flujos de nube.
7. Asegúrese de que todos los flujos están habilitados (Estado = Activado).
8. Habilite los flujos que no estén habilitados, en el orden siguiente:
   1. Flujos que terminan con Grandchild.
   2. Flujos que terminan con Child.
   3. El resto de los flujos según sea necesario, en cualquier orden.

Establecer un Centro de Cumplimiento

Para configurar el Compliance Hub, sigue los pasos en Configurar y configurar el Compliance Hub del Copilot Agent Kit. El Compliance Hub requiere Inventario de Agentes.

Configurar el panel de control de KPI de conversación integrado

Siga estos pasos solo si tiene previsto usar el Panel KPI de Conversación incrustado.

Durante los pasos, anote los siguientes valores:

• Nombre del área de trabajo
• GUID de área de trabajo
• Nombre del informe
• GUID de informe

Publicar el informe

Para publicar el informe de KPI de conversación:

1. Instala el Kit de Agente Copilot, descrito anteriormente en este artículo.

2. Descárgate Conversation.KPIs.zip del repositorio Power CAT Copilot Agent Kit GitHub.

3. Extraiga el contenido del archivo .zip.

4. Abra el archivo Conversation KPIs.pbit en la aplicación Power BI Desktop.

5. Escriba la dirección URL de Dataverse como dirección URL del entorno en el cuadro de diálogo que aparece y seleccione Cargar (por ejemplo, org3c23948.crm.dynamics.com, sin el https:// prefijo).

   Si el cuadro de diálogo no aparece, ingrese la dirección URL del entorno en Inicio>Transformar datos>Editar parámetros.

6. Actualice los datos e inicie sesión según sea necesario.

7. Guarde y publique en un área de trabajo.

8. Anote el nombre del informe y el nombre del área de trabajo.

9. Inicie sesión en Power BI.

10. Abra el informe que publicó y anote el GUID del área de trabajo y el GUID del informe en la dirección URL.

    Si publica en "Mi Área de Trabajo", el GUID del área de trabajo es 00000000-0000-0000-0000-000000000000.

11. Selecciona los tres puntos (...) y luego Ver modelo semántico.

12. Abra Archivo>Configuración.

13. Compruebe que las credenciales del origen de datos no tienen ningún problema. Inicie sesión para corregir los problemas.

14. Vaya a Actualizar y establezca la programación de actualización.

Actualización de la variable de entorno del informe

Para configurar el panel de KPI de conversación insertados, actualice la variable de entorno relacionada con los identificadores correctos. Puedes seguir estos pasos o usar el Asistente de Configuración.

1. Inicia sesión en Power Apps y selecciona el entorno donde instalaste Copilot Agent Kit.
2. Seleccione Soluciones>Solución predeterminada.
3. Seleccione Variable de entorno.
4. Busque y seleccione Informe de KPI de conversación.
5. Reemplace los marcadores de posición del valor predeterminado por los valores nombre del área de trabajo, GUID del área de trabajo, Nombre del informe y GUID de informe que anotó durante el proceso de publicación.
6. Haga clic en Guardar.

Aprende sobre cómo configurar agentes en Copilot Agent Kit, incluyendo cómo configurar un nuevo agente para los KPIs de Conversación.

Accede a la aplicación Copilot Agent Kit

Para acceder a la aplicación Copilot Agent Kit:

1. Inicia sesión en Power Apps y selecciona el entorno donde instalaste Copilot Agent Kit.
2. Vaya a Aplicaciones.
3. Encuentra y selecciona el Kit de Agente Power CAT Copilot.
4. Haga clic en Reproducir.
5. (Opcional) Marque la aplicación.

Comparte la app Copilot Agent Kit

Tras verificar que la aplicación se inicia correctamente, el propietario (o administrador del sistema que instaló el kit) debe compartir la aplicación Copilot Agent Kit con el equipo.

1. Inicie sesión en Power Apps.
2. Seleccione Aplicaciones.
3. Busca "Copilot Agent Kit" y localiza el que tenga el tipo de código (no la app basada en modelos).
4. Seleccione los tres puntos (...) y, a continuación, seleccione Compartir junto al nombre de la aplicación.
5. Busque y agregue los usuarios o grupos de seguridad que necesitan acceso.
6. Seleccione Compartir para confirmar.

Para más información, consulte Compartir una aplicación de lienzo con su organización.

Paso siguiente