Configurar el entorno del laboratorio de Copilot SDK

Copilot SDK integra un entorno de ejecución de agentes en tu aplicación. No es una biblioteca para enviar sugerencias de autocompletado de código al editor de VS Code. La identidad de la aplicación, las herramientas, los permisos y el ciclo de vida son tu responsabilidad.

Resumen del laboratorio

[!NOTE] El acceso del editor y la autenticación del runtime del SDK son límites separados.

Conceptos · Primera tarea · Lista de evidencias · Restablecer

Objetivos de aprendizaje

• Prepara pruebas locales sin invocar un modelo.
• Identifica las versiones del entorno de ejecución y los paquetes para el lenguaje seleccionado.
• Separa la autenticación de VS Code, la CLI y la aplicación.

Antes de empezar

Usa la configuración de la unidad de trabajo y habilita Copilot. El ejercicio integrado usa Node 24. Una adaptación a .NET es opcional; no se requieren LocalDB, SQL Server, Blazor, recursos en la nube ni migraciones de bases de datos.

Conceptos y casos de uso

Escenario del ejercicio

Vas a preparar un pequeño asistente de soporte. Solo puede leer registros sintéticos de estado de pedidos propiedad del actor de fixture de confianza. No debe ejecutar comandos de shell, leer archivos arbitrarios, hacer compras ni fingir que una herramienta fallida tuvo éxito.

Tarea 1 - Preparar el fixture seleccionado

1. Desde la raíz del contenido formativo:

   node scripts/prepare-hands-on.js --lab 16-sdk --destination /Volumes/T9/Dev/oss/workshop-runs/16-sdk
   

2. Abre el directorio mostrado como raíz del espacio de trabajo.

3. Inspecciona su README, el manifiesto de paquetes, el límite de la aplicación y las pruebas.

4. Ejecuta el comando sin conexión documentado allí antes de instalar el paquete opcional del SDK. Registra tanto las pruebas descubiertas como su código de salida.

5. No instales paquetes globalmente para resolver un error de importación local.

Tarea 2 - Planificar una ejecución real del SDK

1. Lee las páginas oficiales de configuración y autenticación del SDK enlazadas más abajo.
2. Registra la versión del paquete declarada por el fixture; no la sustituyas silenciosamente por latest ni por otro SDK.
3. Si eliges el ejercicio real opcional, instala ese paquete en la copia desechable, usando la caché de la unidad de trabajo.
4. Verifica la autenticación mediante el flujo documentado de CLI/SDK. Con la CLI interactiva, inicia copilot y usa /login cuando se solicite; registra solo el éxito o el fallo.
5. Confirma los modelos disponibles en lugar de dar por disponible uno que aparezca en una captura.
6. Revisa el controlador de permisos antes de realizar una solicitud. No uses aprobaciones sin restricciones para hacer que un ejemplo parezca funcional.

Punto de control: indica si validaste la lógica de la aplicación sin conexión, el inicio del SDK, la autenticación o la inferencia real. Son cuatro resultados diferentes.

Verifica tu trabajo

• Las pruebas sin conexión pueden ejecutarse sin credenciales ni red.
• Las dependencias y los registros permanecen dentro del espacio desechable o la unidad de trabajo.
• Los datos y las operaciones permitidos de la aplicación son explícitos.
• El acceso real, si se intenta, usa la cuenta prevista y registra los fallos.
• No aparece ninguna clave de API ni token de acceso en archivos, prompts, capturas o commits.

Solución de problemas

Práctica independiente

Diseña el mismo límite para .NET: duración de la sesión, cancelación, argumentos de herramientas, decisiones de permisos y propagación de errores. Registra las diferencias respecto a la API de Node; no afirmes que las firmas de API de un lenguaje sean portables.

Restablecimiento

Detén la aplicación en su propio terminal, cierra su sesión y revoca cualquier credencial exclusiva del ejercicio. Mantén intacto el contenido formativo original. Elimina la copia desechable solo después de guardar la evidencia con los datos sensibles ocultos.

Referencias oficiales

• Primeros pasos con Copilot SDK
• Configuración del SDK
• Autenticación del SDK
• Instalar Copilot CLI