Uso de un modelo de código MAI para generar código

Completados

Tip

Consulte la pestaña Texto e imágenes para obtener más detalles.

Las herramientas de codificación asistida por IA proporcionan una experiencia de chat o agente que conecta un modelo al entorno de desarrollo. Cuando haya disponible un modelo MAI-Code, puede seleccionarlo para las tareas que se benefician del razonamiento y el uso de herramientas específicos de la codificación.

Nota

Los nombres de modelo, la disponibilidad y las interfaces de usuario evolucionan. Consulte la documentación actual de la herramienta de codificación asistida por IA que usa.

Selección de un modelo de MAI-Code

La interfaz exacta varía entre productos y versiones, pero el proceso general en herramientas de codificación asistida por IA, como Microsoft Copilot Code y GitHub Copilot es:

1. Abra el chat o la interfaz de agente del asistente de codificación.
2. Abra el selector de modelos.
3. Seleccione el modelo disponible más reciente cuyo nombre comienza por MAI-Code.
4. Seleccione el modo de interacción de la tarea. Use un modo conversacional para formular preguntas o planear y un modo de agente cuando desee que la herramienta edite archivos y ejecute herramientas de desarrollo.
5. Confirme el modelo seleccionado antes de enviar el mensaje.

Si no ve un modelo de MAI-Code, compruebe los modelos admitidos por la herramienta y la suscripción. El acceso al modelo también puede depender de la implementación de productos, la directiva de la organización y la configuración del administrador.

Definición de la tarea de codificación

Comience con un mensaje que haga que el resultado deseado sea probable. Inclusión:

• Objetivo: lo que desea crear, cambiar o corregir.
• Contexto: archivos pertinentes, comportamiento existente, arquitectura y convenciones de repositorio.
• Restricciones: lenguajes, marcos, versiones, dependencias, reglas de seguridad y requisitos de accesibilidad necesarios.
• Criterios de aceptación: comportamiento observable que define el éxito.
• Validación: el resultado debe superar las pruebas, los linters, las compilaciones o las comprobaciones manuales.

Por ejemplo:

Create a world clock web app that shows the cirret time in three selected cities.
Include user interface controls to enable users to select the cities, and ensure the controls are keyboard accessible with an approprate tab order.
Ensure the user interface meets accessibility standards and validates all user input to mitigate errors or malicious misuse attempts.
Add focused unit tests, then run the relevant test and lint commands.

Este mensaje proporciona al modelo un objetivo limitado y le indica cómo comprobar el resultado.

Guía al modelo durante el proceso

Para una tarea pequeña y bien definida, puede pedir al modelo que implemente y valide el cambio directamente. Para una tarea mayor, trabaje en fases:

1. Pida al modelo que inspeccione el código pertinente y resuma el diseño existente.
2. Solicite un plan de implementación y repase antes de empezar la edición.
3. Genere una parte coherente de la solución a la vez.
4. Examine los archivos modificados y la salida del comando.
5. Refinar la solicitud cuando los requisitos o errores revelan el contexto que falta.

Proporcione los mensajes de error del modelo y la salida de la prueba con errores en lugar de preguntarlo para adivinar por qué se produjo un error. No incluya secretos, credenciales, datos personales u otra información que su organización no le permita compartir con la herramienta de codificación.

Validación del código generado

Antes de aceptar una aplicación generada o cambiar:

• Lea el código y compruebe que cumple los requisitos.
• Ejecute la compilación, las pruebas, el linter y el comprobador de tipos pertinentes.
• Revise las dependencias y la configuración generada.
• Compruebe la autenticación, la autorización, la validación de entrada, el control de errores y la protección de datos.
• Pruebe la accesibilidad y la experiencia del usuario cuando corresponda.
• Inspeccione la diferencia final para asegurarse de que el modelo no ha realizado cambios no relacionados.

Use una revisión humana adicional para el código de alto impacto, incluidos los controles de seguridad, la infraestructura de producción, los cálculos financieros y los flujos de trabajo que procesan datos confidenciales.