Crear y compartir colecciones de componentes reutilizables

Las colecciones de componentes permiten a los creadores crear y compartir componentes reutilizables entre agentes.

Cuando usa colecciones, puede:

• Puedes gestionar, buscar y crear colecciones de componentes desde la barra lateral de Copilot Studio, sin necesidad de abrir un agente, lo que facilita encontrar y reutilizar bloques de construcción compartidos.
• Utilice la exportación con un solo clic y la importación simplificada. Copilot Studio empaqueta colecciones en soluciones gestionadas versionadas y te permite importar directamente desde la configuración del agente, optimizando la experiencia del creador.
• Comparta colecciones con compañeros de equipo mientras controla el acceso de edición, lo que permite una colaboración segura y protege los activos principales.
• Restrinja una colección para que solo pueda ser utilizada por su agente previsto (el agente principal), lo que ayuda a los equipos a modularizar copilots grandes o confidenciales sin reutilización involuntaria.
• Pruebe cómo se comporta una colección en diferentes agentes directamente desde el espacio de trabajo Colecciones de componentes, acelerando la iteración y asegurando resultados consistentes.
• Recopile y comparta tipos de conectores más recientes, incluidos agentes secundarios, protocolos de contexto de modelos, conectores y flujos.
• Elimine o ajuste las dependencias para desacoplar los activos y admitir ciclos de lanzamiento independientes en todos los equipos.

Los componentes del agente incluyen:

• topics
• Conocimiento
• herramientas
• Agentes secundarios
• Modelar protocolos de contexto
• connectors
• flows
• entidades

Para editar una colección de componentes o agregar una colección de componentes a un agente, debe ser la persona que creó la colección o un usuario con el rol de personalizador del sistema o administrador del sistema. Una vez que una colección de componentes está disponible para un agente, todos los autores de agentes pueden ver y usar la colección, pero no pueden cambiar los componentes dentro de la colección. Más información sobre Configuración de la seguridad del usuario en un entorno.

Crear colecciones de componentes

Las colecciones de componentes se crean directamente desde la página Configuración de un agente o desde la página Colecciones de componentes . Cuando se agregan componentes de un agente a una colección, los componentes se mueven a la colección y el agente hace referencia a los componentes de la colección.

Puede compartir la colección con otros agentes de su entorno o exportarla para importarla a otros entornos.

Crear una colección de componentes a partir de un agente

1. Abra el agente que contiene los componentes que desea que estén disponibles como una colección de componentes.

2. Vaya a Configuración y seleccione Colecciones de componentes.

3. Si está a punto de crear la primera colección de componentes de su entorno, seleccione Crear. De lo contrario, seleccione No.

4. Escriba un nombre y una descripción para su colección de componentes.

5. Seleccione Siguiente.

6. Seleccione los componentes que desee agregar a la colección de componentes. Puede utilizar las categorías y el campo de búsqueda para reducir la lista de componentes. Puede conectar agentes secundarios al revisar la colección.

   Las dependencias de los componentes se seleccionan automáticamente y se agregan a la colección. Solo puede excluir dependencias si ha establecido un agente principal para la colección de componentes.

   El agente principal es el agente propietario de los componentes de la colección. Si no establece un agente principal, la colección de componentes es propiedad del entorno y, por lo tanto, debe tener acceso a las dependencias.

   Sugerencia

   Si cargó archivos como orígenes de conocimiento para un agente, al agregar dichos archivos a una colección de componentes, se quitan del agente de origen.
   Como solución alternativa, puede mover estos archivos de la colección de componentes de vuelta a su agente de origen.

7. Seleccione Siguiente.

8. Revise el contenido de la colección y seleccione Crear.

Crear una colección de componentes a nivel de entorno

1. En la barra lateral, selecciona los tres puntos (...), luego selecciona Colecciones de componentes.

2. Seleccione Agregar nuevo y después Colección de componentes.

3. Escriba un nombre y una descripción para su colección de componentes.

4. Seleccione Finalizar.

5. Conecte el agente que contiene los componentes que desea compartir a su nueva colección de componentes.

6. Agregar componentes del agente seleccionado a la colección.

Conectar un agente a una colección de componentes

1. En la barra lateral, selecciona los tres puntos (...), luego selecciona Colecciones de componentes.

2. Seleccione la colección que desea conectar a un agente.

3. En la sección Agentes conectados , seleccione Agregar agente. Seleccione el agente que desea conectar y, a continuación, Agregar.

   Puede agregar cualquier componente de los agentes conectados a su colección de componentes. Todos los agentes conectados también pueden usar cualquier componente de esa colección.

Agregar componentes de un agente a una colección

1. En la barra lateral, selecciona los tres puntos (...), luego selecciona Colecciones de componentes.

2. Seleccione la colección en la que desea agregar componentes.

3. Conecte el agente que contiene los componentes que desea reutilizar en la colección, si aún no lo está.

4. En la sección Agregar componentes , seleccione Agregar desde un agente.

   Nota:

   Si no ha conectado ningún agente a la colección de componentes, la opción para agregar componentes desde un agente no estará disponible.

5. Seleccione el agente deseado y elija Siguiente.

6. Seleccione los componentes que desee agregar a la colección de componentes. Puede utilizar las etiquetas de categoría y el campo Buscar componentes para reducir la lista de componentes.

7. Seleccione Siguiente.

8. Revise el contenido de la colección y seleccione Agregar a colección.

Establecer un agente principal para una colección de componentes y excluir dependencias

Puede establecer un único agente como agente principal para una colección de componentes. Los creadores tienen la opción de seleccionar un agente principal si solo quieren que un agente específico use la colección de componentes.

Si la colección tiene varios agentes conectados, no puede establecer un agente principal. Primero debe desconectar a todos los demás agentes.

Cuando se establece un agente principal, también se pueden excluir dependencias al agregar componentes de ese agente. Esto le permite crear colecciones de componentes más pequeñas que no incluyen todas las dependencias, lo que puede ser útil cuando desea compartir solo componentes específicos.

1. En la barra lateral, selecciona los tres puntos (...), luego selecciona Colecciones de componentes.

2. Seleccione la colección para la que desea establecer un agente principal.

3. En la sección Agentes conectados , selecciona los tres puntos (...) junto al agente y luego selecciona Establecer agente principal.

   

   Importante

   Si la colección tiene varios agentes conectados, la opción para establecer un agente principal no está disponible. Para cada agente que no sea el que desea establecer como principal, seleccione Desconectar del agente.

Para excluir dependencias al agregar componentes del agente principal:

1. Seleccione Agregar desde un agente en la colección de componentes.

2. Seleccione el agente principal y seleccione Siguiente.

3. Seleccione los componentes que desee agregar a la colección de componentes. Desactive Incluir dependencias de componentes.

4. Seleccione Siguiente.

5. Revise el contenido de la colección y seleccione Agregar a colección.

Compartir una colección de componentes

Puede compartir una colección de componentes con otros usuarios de su organización y especificar si tienen permisos de Visor o Editor . Para obtener más información sobre las funciones de permisos para los usuarios de Copilot Studio, consulte Controlar cómo se comparten los agentes.

1. En la barra lateral, selecciona los tres puntos (...), luego selecciona Colecciones de componentes.

2. Selecciona la colección que quieres compartir.

3. En la barra de menús superior, selecciona Compartir.

4. En el panel de uso compartido, introduzca los nombres o direcciones de correo electrónico de otras personas con las que desee compartir la colección de componentes. Para cada usuario, especifique los roles de permisos (Visor o Editor).

Importar y exportar colecciones

Puede exportar colecciones para poder importarlas a otros entornos. Cuando exporta una colección, se administra. Para exportar una colección sin que se gestione, consulte Uso de soluciones para colecciones complejas.

Para exportar una colección:

1. En la barra lateral, selecciona los tres puntos (...), luego selecciona Colecciones de componentes.

2. Abra la colección que desea exportar.

3. En la barra de menús superior, selecciona Exportar.

Comienza la exportación y aparece una barra de notificaciones. Cuando la exportación está lista, la notificación cambia para incluir un vínculo para descargar la colección como un archivo .zip.

Para importar una colección:

1. En Copilot Studio, asegúrese de que el entorno en el que desea importar su colección esté seleccionado:

   

2. Abra el agente que desea conectar a la colección y, a continuación, seleccione Configuración en la barra superior.

3. Seleccione Colecciones de componentes en el menú lateral y, a continuación, seleccione Importar solución.

4. En el panel que aparece, seleccione Examinar archivos y, a continuación, elija la colección exportada.

5. Se muestran los detalles de la colección. Puede excluir los pasos y flujos del complemento en la sección Configuración avanzada .

   Sugerencia

   Si intenta importar una colección en el mismo entorno desde el que la exportó, verá un mensaje de error. Confirme que se encuentra en el entorno de destino que no contiene la colección.

6. Seleccione Siguiente. El panel de importación se cierra y aparece un mensaje que muestra que la colección se ha importado correctamente.

Utilice soluciones para colecciones complejas

También puede usar soluciones para exportar componentes de agente de un entorno e importarlos a otro. La solución actúa como soporte de los componentes. Puede exportar e importar varios componentes de agente en una solución.

Generalmente, use soluciones para colecciones de componentes complejos. Por ejemplo, si la colección tiene conectores o variables de entorno.

Creación de una solución

1. Vaya a la página Soluciones.

2. Seleccione Nueva solución.

3. Escriba la siguiente información para la nueva solución:

   • Nombre para mostrar: nombre que se muestra en la lista de soluciones. Puede cambiarlo más tarde.
   • Nombre: el nombre único de la solución, generado a partir del Nombre a mostrar. Solo puede cambiarlo antes de guardar la solución.
   • Editor: seleccione el editor predeterminado o crear uno nuevo. Considere la posibilidad de crear un único editor y utilizarlo de forma coherente en todos los entornos de su solución. Más información sobre editores de soluciones.
   • Versión: escriba un número para la versión de la solución. El número de versión se incluye en el nombre de archivo cuando se exporta la solución.

4. Seleccione Crear.

Agregar colecciones de componentes a una solución

1. Vaya a la página Soluciones y abra la solución deseada, si aún no lo está.

2. Seleccione Agregar existente, apunte a Agente y seleccione Colección de componentes.

   Aparece un panel que muestra todas las colecciones de componentes disponibles.

3. Seleccione las colecciones de componentes que desea exportar y, a continuación, seleccione Agregar en la parte inferior del panel.

Exportar una solución para compartir colecciones de componentes en otros entornos

Exporta e importa colecciones de componentes exportando e importando sus soluciones que las contienen de un entorno a otro.

1. Vaya a la página Soluciones.

2. Selecciona los tres puntos (⋮) de la solución que contiene las colecciones de componentes que quieres exportar y luego selecciona Exportar solución.

3. Introduzca o seleccione las siguientes opciones:

   • Número de versión: Copilot Studio incrementa automáticamente la versión de su solución. Puede aceptar la predeterminada o introducir la suya.
   • Exportar como: seleccione el tipo de paquete, Administrado o No administrado. Más información acerca de soluciones administradas y no administradas.

4. Seleccione Exportar. La exportación puede tardar varios minutos en completarse. Mire el mensaje de estado en la parte superior de la página Soluciones.

5. Cuando finalice la exportación, seleccione el botón Descargar para descargar un archivo .zip.

   El nombre del archivo tiene este formato: SolutionName_Version_SolutionType.zip, por ejemplo, ContosoSolution_1_0_0_1_managed.zip.

Importar una solución para agregar colecciones de componentes a un entorno

1. Vaya a la página Soluciones.

2. Vaya al entorno donde desee importar su colección de componentes.

3. Seleccione Importar solución.

4. En el panel Importar, seleccione Examinar, elija el archivo .zip que contiene la solución con la colección de componentes y, a continuación, seleccione Siguiente.

5. Seleccione Importar. La importación puede tardar varios minutos en completarse. Mire el mensaje de estado en la parte superior de la página Soluciones.

6. Espere un momento mientras se completa la importación de la solución.

Si la importación no se realiza correctamente, seleccione Descargar archivo de registro para descargar un archivo XML que contenga detalles sobre la causa del error en la importación. La causa más común para que una importación falle es que la solución no contenía algunos componentes requeridos.

Agregar colecciones de componentes importados a su agente

Después de importar una colección de componentes, puede usarla en sus agentes.

1. Abra el agente donde desea utilizar la colección componente.

2. Vaya a Configuración y seleccione Colecciones de componentes.

3. Junto a la colección de componentes importados, seleccione los tres puntos (...) y elija Agregar al agente.

   Aparecerá un mensaje que le pedirá que confirme.

4. Seleccione Agregar a agente.

   El nombre del agente aparece en Activo para esta colección de componentes.

5. Revise los componentes de la colección importada y publique el agente para que los cambios estén disponibles para sus clientes.

Agregar componentes a una colección de componentes en una solución personalizada

Si agrega nuevos componentes de agente a una colección de componentes en Copilot Studio, también debe agregarlos a cualquier solución no administrada que haga referencia a esta colección de componentes.

1. Vaya a la página Soluciones y abra la solución no administrada que contiene la colección de componentes que se va a actualizar.

2. En el panel Objetos, seleccione Colecciones decomponentes del agente.

3. Selecciona los tres puntos (⋮) de la colección que quieres actualizar, apunta a Avanzado y selecciona Añadir objetos requeridos.

4. Seleccione Aceptar.

   En el panel Objetos, puede seleccionar Componentes del agente para verificar que ahora aparecen los componentes esperados.

Abrir el explorador de soluciones

En Copilot Studio, selecciona los tres puntos (...) en la barra lateral y luego selecciona Soluciones.

Se abre la página Soluciones en una nueva pestaña de explorador.