Instalación del kit de Copilot Studio

Copilot Studio Kit es un kit de herramientas de código abierto para probar y evaluar agentes de Copilot Studio. Por ejemplo, permite definir casos de prueba, simular consultas de usuario y validar las respuestas del agente. En este artículo se proporcionan instrucciones paso a paso para instalar el kit desde AppSourceoGitHub, junto con los pasos posteriores a la implementación y las opciones de configuración.

Instalación del kit de Copilot Studio desde AppSource

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

Implementación desde AppSource

Para implementar Copilot Studio Kit desde AppSource, siga estos pasos:

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

Comienza la instalación del Kit de Copilot Studio.

Pasos posteriores a la implementación (AppSource)

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. Localice Copilot Studio Kit - Dataverse y ábralo para editar.
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.

Instalación del kit de Copilot Studio desde GitHub

Siga estos pasos para instalar Copilot Studio Kit desde GitHub. Si prefiere instalar desde AppSource, vaya a Instale el kit de Copilot Studio desde AppSource.

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

Descargue la versión más reciente de la solución administrada para power CAT Copilot Studio Kit.

Instalación del archivo ZIP administrado de CopilotStudioKit

Para instalar la solución administrada Copilot Studio Kit:

1. Inicie sesión en Power Apps.
2. Seleccione el entorno en el que desea instalar Copilot Studio Kit.
3. Vaya a Soluciones.
4. Seleccione Importar solución.
5. Selecciona 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)

Si instaló una versión anterior del Kit de Copilot Studio y quiere actualizar a la versión más reciente, siga estos pasos:

1. Inicie sesión en Power Apps.
2. Seleccione el entorno en el que desea actualizar el Kit de Copilot Studio.
3. Vaya a Soluciones.
4. Seleccione Importar solución.
5. Selecciona 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 si ha instalado el Kit de Copilot Studio desde AppSource o 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.

Puedes seguir estos pasos o usar el Asistente de Configuración para configurar la referencia de conexión a SharePoint.

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

1. Instale Copilot Studio 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. Busque la referencia de conexión de Copilot Studio Kit - SharePoint y ábrala para su edición.
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: Obtenga información sobre cómo configurar agentes en Copilot Studio Kit, incluido 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.

• Kit de Copilot Studio: Power Platform for Admins captura la lista de entornos del inquilino. Requiere permisos de nivel de administrador de Power Platform.
• Copilot Studio Kit - Dataverse recopila la información sobre el 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. Instale Copilot Studio 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. Busque la referencia de conexión Copilot Studio Kit - Power Platform for Admins y ábrala para su edición.
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. Busque la referencia de conexión Copilot Studio Kit - Dataverse y ábrala para su edición.
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 métricas de uso

Para habilitar las métricas de uso opcionales en el inventario del agente, complete los pasos siguientes:

1. Asegúrese de que el conector HTTP con el identificador de Entra de Microsoft (autenticado previamente) está permitido en su entorno.
2. Importe el archivo AgentInventoryUsage*_managed.zip desde el repositorio de GitHub del Kit de Studio Copilot de Power CAT.
3. Durante el proceso de importación, cree una conexión mediante la dirección URL del host de licencias: https://licensing.powerplatform.microsoft.com/

Habilitación de flujos

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

1. Instale Copilot Studio 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 Kit de Copilot Studio haya sido seleccionado.
4. Seleccione Soluciones.
5. Seleccione Copilot Studio 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 Compliance Hub, sigue los pasos en Configurar y configurar el Copilot Studio Kit Compliance Hub. El Compliance Hub requiere Inventario de Agentes.

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

Estos pasos solo son necesarios si planea usar el dashboard de KPIs de conversación integrado.

Durante los pasos, anote los siguientes valores:

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

Publicación del informe

Para publicar el informe de KPI de conversación:

1. Instale Copilot Studio Kit, como se describió anteriormente en este artículo.

2. Descargue Conversation.KPIs.zip desde el repositorio de GitHub Power CAT Copilot Studio Kit.

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 donde instaló Copilot Studio 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.

Más información: Obtenga información sobre cómo configurar agentes en Copilot Studio Kit, incluido cómo configurar un nuevo agente para KPI de conversación.

Acceso a la aplicación Copilot Studio Kit

Para acceder a la aplicación Copilot Studio Kit:

1. Inicie sesión en Power Apps y seleccione el entorno donde instaló Copilot Studio Kit.
2. Vaya a Aplicaciones.
3. Busque y seleccione Power CAT Copilot Studio Kit.
4. Seleccione Iniciar.
5. (Opcional) Marque la aplicación.

Paso siguiente