Instalar el Copilot Agent Kit

Copilot Agent Kit es un conjunto 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 los pasos posteriores al despliegue y las opciones de configuración.

Note

Antes de descargar e instalar el Copilot Agent Kit, asegúrese de cumplir con todos los requisitos previos.

Instalar Copilot Agent Kit desde Marketplace

Si prefiere instalar Copilot Agent Kit desde GitHub, salte a Instalar Copilot Agent Kit desde GitHub.

Despliegue desde el Marketplace

Para implementar Copilot Agent Kit desde Marketplace, siga estos pasos:

  1. Acceda al Copilot Agent Kit en Marketplace.
  2. Seleccione Instálelo ahora.
  3. Inicie sesión si es necesario.
  4. En la vista Instalar Copilot Agent Kit, seleccione el entorno donde desea implementar el Copilot Agent Kit.
  5. Revise los términos y las declaraciones. Si está de acuerdo, active las casillas y seleccione Instalar.

Comienza la instalación del Copilot Agent 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.

Instalar Copilot Agent Kit desde GitHub

Siga estos pasos para instalar Copilot Agent Kit desde GitHub. Si prefiere instalar desde Marketplace, vaya a Instalar Copilot Agent Kit desde 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 administrado de Copilot Agent Kit

Para instalar la solución administrada de Copilot Agent Kit:

  1. Inicie sesión en Power Apps.
  2. Seleccione el entorno en el que quiere instalar Copilot Agent Kit.
  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 Copilot Agent Kit, sigue estos pasos:

  1. Inicie sesión en Power Apps.
  2. Seleccione el entorno en el que quiere actualizar el Copilot Agent Kit.
  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.

Note

Al actualizar el Copilot Agent Kit, podrías encontrarte con el siguiente error: La solución "Power CAT Copilot Agent Kit" no se ha importado: ImportAsHolding falló con excepción: No se puede eliminar el atributo: cat_copilottestrunid de Entity: cat_CopilotTestRun ya que el atributo no es un campo personalizado.

Este problema se conoce y está bajo investigación. Como solución alternativa, preconfigurar la actualización antes de aplicarla. Obtenga más información en Actualización o actualización de una solución.

Pasos de configuración adicionales y opcionales

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

Tip

Copilot Agent Kit incluye un asistente de configuración para establecer referencias de conexión, configurar variables de entorno y flujos de nubes. Aprenda más sobre cómo usar el Asistente para instalación.

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 a 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. Instale Copilot Agent Kit, como se describió 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: Obtén información sobre la configuración de 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 de Copilot - Dataverse recopila la información de los agentes 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.

Una vez configuradas las referencias de conexión, configuras el alcance del entorno, los tipos de agentes, los grupos de entorno, las opciones de inventario y el calendario de sincronización desde dentro del Inventario de Agentes. Obtenga más información en Configuración del inventario del agente.

Para usar la característica Inventario del agente:

  1. Instale Copilot Agent Kit, como se describió 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 de Copilot - Power Platform para administradores 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

Note

Si tiene previsto usar la sincronización de SharePoint, configure la sincronización de SharePoint antes de habilitar los flujos relacionados (los nombres comienzan con la sincronización de SharePoint).

Para habilitar los flujos de nubes incluidos en el Copilot Agent Kit, siga estos pasos o utilice el Asistente de Configuración.

  1. Instale Copilot Agent Kit, como se describió anteriormente en este artículo.
  2. Inicie sesión en Power Automate.
  3. Asegúrese de que el entorno con el Copilot Agent Kit esté seleccionado.
  4. Seleccione Soluciones.
  5. Seleccione Copilot Agent Kit.
  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 Centro de cumplimiento, siga los pasos en Instalar y configurar el Centro de cumplimiento 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 del espacio de trabajo
  • Nombre del informe
  • GUID de informe

Publicar el informe

Para publicar el informe de KPI de conversación:

  1. Instale Copilot Agent Kit, como se describió 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. Inicie sesión en Power Apps y seleccione el entorno en el que instaló 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.

Consulta cómo configurar agentes en Copilot Agent Kit, incluyendo cómo configurar un nuevo agente para KPI de Conversación.

Accede a la aplicación Copilot Agent Kit

Para acceder a la aplicación Copilot Agent Kit:

  1. Inicie sesión en Power Apps y seleccione el entorno en el que instaló 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.

Compartir la aplicación Copilot Agent Kit

Tras verificar que la aplicación se inicia correctamente, el propietario (o el 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. Busque "Kit del Agente de Copilot" y localice el tipo Código (no la aplicación basada en modelo).
  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

Configuración de usuarios y equipos

  • Last updated on