Clonación del agente de Microsoft Copilot Studio en Microsoft Visual Studio Code

Al clonar un agente de Microsoft Copilot Studio mediante la extensión, descargue la definición del agente y las definiciones de componentes relacionadas de Copilot Studio a la máquina local. Puede editar estos archivos mediante Microsoft Visual Studio Code. La operación de clonación crea un espacio de trabajo local con todos los archivos agente en formato de directorio estructurado.

Requisitos previos

Antes de empezar a clonar agentes, hay algunos requisitos y consideraciones importantes.

Elige una ubicación para el espacio de trabajo

Selecciona una carpeta local adecuada para los archivos de tu agente. Esta ubicación es donde la extensión guarda los archivos agente. Aquí tienes algunos consejos importantes para elegir una ubicación:

  • Asegúrate de tener suficiente espacio en disco. Un agente típico puede variar en tamaño dependiendo del número de componentes.
  • Utiliza una ruta sin espacios si es posible, aunque los espacios son compatibles.
  • Considera usar una ubicación que ya esté rastreada por Git.

Entiende qué se clona

Al clonar un agente, los archivos del agente se clonan localmente en la ubicación que elija, creando una definición de estructura como la siguiente en el explorador de Visual Studio Code:

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

Métodos de clonación

Si usa la extensión por primera vez o incluso no está familiarizado con Visual Studio Code, la manera más sencilla de clonar un agente es seleccionar Clone Agent cuando se abre el panel Extension. Sin embargo, esta opción no está disponible cuando ya tienes un Agente clonado y abierto localmente. Se pueden utilizar los siguientes métodos en su lugar:

Este es el método más sencillo y recomendable para clonar un agente.

  1. Abra la extensión Copilot Studio seleccionando el icono de Copilot Studio en la barra de actividades. También puede presionar Ctrl+Shift+P y escribir "Copilot Studio: Focus on Agents View". El panel Copilot Studio se abre en la barra lateral.

  2. En el panel de Agentes , selecciona tu entorno objetivo en la lista desplegable (por ejemplo, "Entorno 1") para ver una lista de los agentes en el entorno.

    > Environment 1
  Environment 2
  Environment 3

  3. Selecciona el agente para clonar de la lista. Los agentes muestran su última fecha de modificación. Haz clic derecho en el nombre del agente y selecciona Clonar agente.

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    Se abre un cuadro de diálogo para selector de archivos.

  4. Navega hasta la ubicación deseada en el cuadro de diálogo del selector de archivos o crea una nueva carpeta y selecciona Seleccionar carpeta. Comienza el proceso de clonación.

  5. Espera a que termine el proceso de clonación. Aparece una notificación de progreso que muestra "Cloning agent: Customer Support Bot", seguida de un mensaje de éxito "Agente clonado con éxito." Este proceso suele durar entre 10 y 30 segundos.

  6. Verifica que la clonación se haya completado con éxito. La carpeta del agente se abre en Visual Studio Code explorador, el panel de control de código fuente muestra un árbol de trabajo limpio y la ventana de archivos muestra el nombre de la carpeta.

Método 3: Clonar usando la paleta de comandos

Utiliza este método si prefieres flujos de trabajo centrados en el teclado.

  1. Abre la paleta de comandos pulsando Ctrl+Shift+P.

  2. Escriba "Copilot Studio: Clone Agent" y presione Enter. El comando se ejecuta y aparecen los avisos.

  3. Sigue las indicaciones para seleccionar tu entorno, selecciona el agente, elige la carpeta de destino y espera a que termine la clonación. El agente se clona en la ubicación que seleccionaste.

Método 3: Clonar usando la URL del agente

Este método es útil cuando alguien comparte una URL de agente contigo.

  1. Abra el agente en el portal web de Copilot Studio.

  2. Selecciona Configuración>Detalles del agente y copia la URL del agente. La URL debe tener el formato: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. La URL ahora está en tu portapapeles.

  3. Vuelva a Visual Studio Code y abra la extensión Copilot Studio.

  4. Selecciona Clonar el agente. La extensión detecta la URL en tu portapapeles y muestra el agente marcado como "(desde el portapapeles)."

  5. Selecciona el agente marcado "(desde la tabla de papeles)", selecciona una carpeta de destino y espera a que termine la clonación. El agente se clona en la ubicación que seleccionaste.

Escenarios comunes de clonación

Aquí tienes algunos escenarios comunes en los que clonar agentes es útil, con detalles generales sobre el flujo de trabajo sugerido.

Escenario 1: Clon para desarrollo en solitario

Objetivo: Trabaja en un agente por tu cuenta

  1. Clona el agente en una carpeta local.

  2. Inicializa un repositorio Git desde el Control de versiones en el panel de navegación.

  3. Realice cambios localmente.

  4. Haz tus compromisos.

  5. Aplique los cambios a Copilot Studio cuando esté listo.

Escenario 2: Clon para la colaboración en equipo

Objetivo: Varios desarrolladores trabajando en el mismo agente

  1. El primer desarrollador clona al agente.

  2. El primer desarrollador inicializa Git e inserta el contenido en un repositorio compartido (GitHub, Azure DevOps).

  3. Otros desarrolladores clonan desde el repositorio compartido de Git.

  4. Cada desarrollador ejecuta Copilot Studio: Reattach Agent para conectar su carpeta local a Copilot Studio.

  5. El equipo usa Git para la colaboración y realizar un seguimiento de los cambios, y usa la extensión Visual Studio Code para trabajar en el agente.

  6. A continuación, cada desarrollador realiza cambios en Copilot Studio para probar o desplegar en otro entorno descendente, según su ciclo de vida de desarrollo de software o las canalizaciones automatizadas.

Escenario 3: Clonar múltiples entornos

Gol: Gestionar el desarrollo, las pruebas y las versiones de producción

El enfoque recomendado para desplegar en múltiples entornos es utilizar soluciones. Consideremos un proceso de despliegue automatizado con procesos organizativos que sean auditables y escalables, como las canalizaciones. Para los usuarios que eligen no trabajar con soluciones, la extensión de Copilot Studio proporciona la capacidad de sincronizar una definición de agente de Copilot Studio desde una máquina local a otro entorno. Aún deberías considerar el proceso organizativo para trasladar activos técnicos a entornos posteriores para proporcionar auditoría, telemetría y otros componentes críticos dentro del ciclo de vida del desarrollo de software al enviar software a tus clientes y usuarios finales.

  1. Clona el agente desde el entorno de desarrollo a una carpeta local de desarrollo.

  2. Haz cambios en la carpeta de desarrollo.

  3. Aplica esos cambios y prueba los cambios en el mismo entorno.

  4. Use Copilot Studio: Reattach Agent para conectar el agente al entorno alternativo.

  5. Pruebe el agente en el panel de pruebas de Copilot Studio.

procedimientos recomendados

Qué hacer

  • Clona a todos los agentes en una ubicación consistente.
  • Inicializa Git justo después de clonar.
  • Usa un nombre de carpeta con significado.
  • Comprueba que el clon funcione antes de hacer cambios.
  • Mantenga la copia de seguridad de la ubicación del clon (por ejemplo, en GitHub o Azure DevOps).
  • Documenta la ubicación de tu clon en la wiki interna del equipo o en la documentación.

Qué no hacer

  • No clones en directorios temporales.
  • No clones varias veces a diferentes ubicaciones. Hacerlo puede causar confusión.

Pasos siguientes

Después de clonar a tu agente:

  • Last updated on