Instalación de la extensión de Microsoft Copilot Studio para Microsoft Visual Studio Code

Prerrequisitos

Antes de instalar la extensión de Microsoft Copilot Studio para Microsoft Visual Studio Code, asegúrese de cumplir los siguientes requisitos:

Requisitos del sistema

• Sistema operativo:
  • Windows (arquitectura x64)
    • Windows 10, versión 1809 o posterior
    • Windows 11 (cualquier versión)
  • macOS
• Visual Studio Code: versión 1.80 o posterior (se recomienda la versión estable más reciente)
• Conexión a Internet: Necesario para la instalación y autenticación

Requisitos de la cuenta

• Cuenta de Microsoft: Cuenta de Microsoft activa con licencia o acceso a Copilot Studio
• Copilot Studio license: Licencia adecuada asignada a su cuenta
• Acceso al entorno: Permisos para acceder a al menos un entorno de Copilot Studio
• Permisos de agente: Acceso de lectura y escritura a todos los agentes que planees editar

Pasos de instalación

Hay dos maneras de instalar la extensión de Copilot Studio en Visual Studio Code:

• Instalación desde dentro de Visual Studio Code
• Instalación desde el sitio web de Visual Studio Code Marketplace

Método 1: Instalar desde Visual Studio Code

1. Selecciona el icono de Extensiones en la barra de actividades o pulsa Ctrl+Shift+X. El panel Extensions se abre en Visual Studio Code.

2. En la barra de búsqueda, escriba "Copilot Studio". Busque la extensión oficial de Copilot Studio en la lista de resultados. Verifica que el editor sea "Microsoft".

3. Una vez que encuentres la extensión correcta, selecciónala para abrir la página de detalles de la extensión.

4. Selecciona Instalar para comenzar la instalación.

5. Espere a que finalice la instalación. Es posible que vea un mensaje para volver a cargar Visual Studio Code, en cuyo caso, seleccione Reload cuando se le solicite.

6. Verifica la instalación. Busque el icono de Copilot Studio en la barra de actividad. El icono aparece con la marca de Copilot Studio.

Método 2: Instalar desde el sitio web de Marketplace de Visual Studio Code

1. Vaya a https://marketplace.visualstudio.com/ y busque "Copilot Studio". También puede usar el vínculo directo: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio.

2. Selecciona Instalar en la página del mercado. Es posible que los mensajes del explorador le pidan que descargue Visual Studio Code antes de que le pida que abra Visual Studio Code.

3. Permita que el explorador abra Visual Studio Code y confirme la instalación buscando el icono de extensión en la barra de actividad.

Configuración inicial

Primer lanzamiento

1. Seleccione el icono de Copilot Studio en la barra de actividades. La extensión se abre como un panel de aplicación. Se muestra una notificación emergente, que indica que la extensión Copilot Studio necesita iniciar sesión.

2. Selecciona Iniciar sesión en la ventana emergente y luego selecciona Permitir. Tu navegador predeterminado se abre a una página de autenticación de Microsoft.

3. Introduce tus credenciales de autenticación y completa cualquier autenticación multifactor si es necesario.

4. Revisa los permisos solicitados:

   • Leer y escribir módulos de Copilot Studio
   • Acceder a información ambiental
   • Sincronizar archivos a la nube

   Selecciona Aceptar o Permitir. El explorador le pide que pueda cerrar la ventana y volver a Visual Studio Code.

5. Vuelva a Visual Studio Code. El panel de extensión carga los entornos a los que tienes acceso y los agentes en esos entornos.

Verificar la configuración exitosa

Después de la autenticación, debería ver una estructura en el panel Agents dentro de la extensión de Copilot Studio en Visual Studio Code. Deberías ver una lista de grupos de entorno, con entornos anidados y agentes, similar a la siguiente estructura:

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

Solucionar problemas de instalación

A continuación se indican los pasos para solucionar algunos problemas que pueden producirse al instalar o configurar la extensión Visual Studio Code de Copilot Studio.

No aparece la extensión

Problem: El icono de Copilot Studio no aparece en la barra de actividades.

Solution:

1. Volver a cargar Visual Studio Code
2. Selecciona Extensiones y busca la extensión en la lista de Instalados. Asegúrate de que la extensión no esté desactivada.
3. Actualice Visual Studio Code a la versión más reciente.
4. Reinstale la extensión.

Errores de autenticación

Problema: La autenticación falla o se repite en bucles.

Solution:

1. Borra la caché y las cookies de tu navegador para microsoft.com.

2. Prueba a iniciar sesión usando otro navegador. Configura temporalmente este navegador como predeterminado.

3. Desactiva las extensiones del navegador que puedan bloquear la autenticación.

4. Revisa la configuración del firewall y proxy corporativo.

5. Asegúrate de usar un tipo de cuenta compatible.

No se encuentra la extensión en Visual Studio Code Marketplace

Problem: No se encuentra la extensión de Copilot Studio al buscar.

Solution:

1. Asegúrate de buscar en el panel de Extensiones , no en la búsqueda web.

2. Compruebe la ortografía: "Copilot Studio".

3. Póngase en contacto con el administrador para ver si su organización restringe el acceso al Marketplace de Visual Studio Code.

Desinstalación de la extensión

Para eliminar la extensión:

1. Abre el panel de Extensiones.

2. Busque Copilot Studio en las extensiones instaladas.

3. En la entrada de la lista, selecciona laopción Gestionar (icono de engranaje) >Desinstalar.

4. Vuelva a cargar Visual Studio Code cuando se le solicite.

Pasos siguientes

Después de instalar la extensión y autenticarse con Copilot Studio, está listo para:

• Clona a tu primer agente
• Aprende sobre los componentes del agente de edición