Sobre la revisión de código de GitHub Copilot

Presentación

Copilot code review revisa el código escrito en cualquier idioma y proporciona comentarios. Revisa el código desde varios ángulos para identificar problemas y sugerir correcciones. Puede aplicar cambios sugeridos con un par de clics.

En este artículo se proporciona información general sobre Copilot code review. Para obtener información sobre cómo solicitar una revisión de código desde Copilot, consulte Uso de GitHub Copilot para la revisión de código.

Disponibilidad

Copilot code review es compatible con:

• GitHub.com
• GitHub CLI
• GitHub Mobile
• VS Code
• Visual Studio
• XCode
• IDE de JetBrains
• Azure DevOps (versión preliminar pública)

Copilot code review sin una Copilot licencia

Los miembros de la organización sin Copilot licencia pueden usar Copilot code review en GitHub.com. Un administrador de empresa o propietario de la organización debe habilitarlo. Esta funcionalidad está disponible para las organizaciones en planes Copilot Business y Copilot Enterprise.

Habilitación de la revisión de código para usuarios sin licencia

Para permitir que los miembros de la organización sin una Copilot licencia usen Copilot code review, debe habilitar dos directivas:

1. ** AI credits uso de pago**. Habilite primero esta política. Permite a la empresa u organización incurrir en cargos por Copilot code reviewAI credits uso.
2. Permitir que los miembros sin una Copilot licencia usen Copilot code review en GitHub.com. Esta subpolítica habilita Copilot code review para usuarios sin licencia.

La segunda directiva tiene estas características:

• Esta opción está deshabilitada de manera predeterminada.
• Una vez establecida esta directiva en el nivel empresarial, se vuelve visible, pero no se puede editar en el nivel de organización.
• La directiva es más restrictiva. Copilot code review solo está disponible en repositorios que pertenezcan a una organización en la que se haya habilitado explícitamente esa directiva.

Cómo funciona para los usuarios sin una licencia

Cuando ambas directivas están habilitadas, los usuarios sin una licencia Copilot pueden solicitar una revisión de Copilot code review en sus solicitudes de incorporación de cambios en los repositorios de la organización.

En repositorios en los que está habilitada la revisión automática de código, Copilot revisa automáticamente todas las solicitudes de incorporación de cambios. Esto sucede independientemente de si el autor tiene una Copilot licencia. Para obtener más información sobre cómo configurar la revisión automática de código, consulte Configuración de la revisión automática de código mediante GitHub Copilot.

Copilot code review para los usuarios sin licencia no está disponible en los IDEs.

Archivos excluidos

Algunos tipos de archivo se excluyen de Copilot code review:

• Archivos de administración de dependencias, como package.json y Gemfile.lock
• Archivos de registro
• Archivos SVG

Si incluye estos tipos de archivo en una solicitud de incorporación de cambios, Copilot code review no revisará el archivo.

Para más información, consulta Archivos excluidos de GitHub Copilot code review.

Capacidades agentivas para Copilot code review

Copilot code review usa funcionalidades de agente para ampliar su funcionalidad.

• Recopilación completa del contexto del proyecto. Esto proporciona revisiones de código más específicas, precisas y contextuales. Esta funcionalidad analiza todo el repositorio para comprender mejor el contexto de los cambios de código.
• La capacidad de pasar sugerencias a Copilot cloud agent. Esto automatiza la creación de un nuevo pull request contra tu rama con las correcciones sugeridas aplicadas. Pasar sugerencias a Copilot cloud agent está en versión preliminar pública y sujeto a cambios.

Estas funcionalidades se habilitan automáticamente para todos los planes que incluyen Copilot code review. Consulte Revisar el nivel de esfuerzo más adelante en este artículo para obtener información sobre cómo elegir entre los niveles de análisis Lite y Equilibrado.

Si GitHub Actions no está disponible o si fallan los flujos de trabajo de Acciones usados por Copilot code review, las revisiones se seguirán generando. Sin embargo, no incluirán las características adicionales proporcionadas por las capacidades agenticas.

Uso de ejecutores de GitHub Actions para funcionalidades de agente en la revisión de código

Copilot code review usa GitHub Actions para ejecutar las funcionalidades de agente, incluida la recopilación completa del contexto del proyecto y pasar sugerencias a Copilot cloud agent. De forma predeterminada, Copilot code review utiliza utiliza ejecutores estándar hospedados en GitHub. También puede actualizar a ejecutores de mayor tamaño hospedados en GitHub para mejorar el rendimiento o recurrir a ejecutores autohospedados.

No es necesario que haya GitHub Actions habilitado en su organización o empresa para usar las funcionalidades agente en la revisión de código.

Si la organización ha deshabilitado los ejecutores hospedados de GitHub, las funcionalidades de agente no estarán disponibles. En este caso, las revisiones de código se revertirán a una revisión más limitada. Las organizaciones que se encuentren en esta situación pueden usar ejecutores autohospedados.

Para obtener más información sobre cómo configurar runners, consulte Configuración de ejecutores para la revisión de código de GitHub Copilot.

Puede consultar los minutos de GitHub Actions asociados a las ejecuciones de Copilot code review. Para obtener más información, consulte GitHub Actions.

Revisión del nivel de esfuerzo

Copilot code review admite varios niveles de esfuerzo de revisión, por lo que puede elegir el nivel de detalle que coincide con la importancia del código.

• Lite: Revisión estándar. Proporciona comentarios rápidos y dirigidos sobre problemas comunes, como errores, vulnerabilidades de seguridad e incoherencias de estilo (valor predeterminado).
• Equilibrado: dirige las pull requests a un modelo con mayor capacidad de razonamiento para un análisis más exhaustivo de lógica compleja, código crítico para la seguridad y cambios que afectan a varios servicios. Las revisiones equilibradas usan más AI credits y pueden consumir marginalmente más GitHub Actions minutos que las revisiones Lite.

Usa Balanced para código sensible en materia de seguridad, solicitudes de extracción de varios servicios o repositorios con estándares de calidad estrictos. Use Lite para los cambios rutinarios en los que los comentarios rápidos son más importantes que el análisis exhaustivo.

Puede seleccionar el nivel de esfuerzo de revisión al solicitar una revisión en la solicitud de incorporación de cambios, en la sección Revisores , donde Copilot aparece como revisor. Los propietarios de la organización pueden establecer un nivel de esfuerzo de revisión predeterminado para las revisiones automáticas de código de su organización. Los administradores del repositorio pueden invalidar el valor predeterminado de la organización para un repositorio específico.

Después de que Copilot code review revise una solicitud de incorporación de cambios, el comentario de resumen de la solicitud de incorporación de cambios muestra el nivel de esfuerzo utilizado para cada ejecución de revisión.

Consumo estimado

Una revisión suele consumir aproximadamente entre 0,05 y 1 USD en AI credits con el esfuerzo "Lite", y entre 0,25 y 5 USD en AI credits con el esfuerzo "Equilibrado".

El consumo generalmente aumenta con el tamaño de la pull request y las instrucciones personalizadas del repositorio, y los rangos pueden cambiar a medida que evolucionan los modelos. Estas estimaciones no incluyen los GitHub Actions minutos.

Los administradores de repositorios y organizaciones pueden establecer el nivel de esfuerzo de revisión predeterminado para las revisiones automáticas de código. Para conocer los pasos de configuración, consulte Configuración de la revisión automática de código mediante GitHub Copilot.

Uso de revisión de código

Cada vez que Copilot revisa una solicitud de incorporación de cambios o revisa el código del IDE, la interacción consume AI credits. La cantidad depende del modelo usado y del número de tokens procesados.

Las revisiones de código tienen dos componentes de costo: AI credits para la interacción del modelo (la propia revisión) y GitHub Actions minutos para las funcionalidades agente (recopilación de contextos y uso de herramientas). Para obtener más información sobre el uso de GitHub Actions, consulte Uso de los ejecutores de GitHub Actions para capacidades de agente en la revisión de código.

Si un repositorio está configurado para solicitar automáticamente una revisión de código de Copilot para todas las nuevas pull requests, el consumo de AI credits se atribuye al autor de la pull request. Si otro usuario solicita manualmente una revisión, el consumo se atribuye a ese usuario en su lugar.

Si una solicitud de incorporación de cambios es creada por GitHub Actions o por un bot, el uso se aplicará a:

• El usuario que desencadenó el flujo de trabajo, si ese usuario se puede identificar.
• Propietario de facturación designado.

¿Qué ocurre cuando se alcanza un presupuesto?

Para Copilot Business y Copilot Enterprise, el acceso de revisión de código se rige por controles presupuestarios. Si un usuario alcanza su presupuesto individual o si se agota el límite de gasto de la empresa o del centro de costes, las revisiones de código se bloquean, junto con otras funciones que consumen AI credits. Consulta Presupuestos para la facturación basada en el uso.

Usuarios sin licencia Copilot o plan que incluya Copilot code review

Los usuarios sin acceso a Copilot code review no tienen una asignación mensual de AI credits para esta función. Esto incluye a los usuarios que no tienen licencia Copilot ni usuarios en el Copilot Free plan, que no incluye Copilot code review.

Cuando Copilot code review está habilitado para estos usuarios, cualquier AI credits que consuman se factura directamente a la organización o la empresa como uso adicional de pago. Esto se aplica tanto a las revisiones solicitadas manualmente como a las revisiones automáticas de código.

AI credits Lo consumido por estos usuarios no se atribuye al presupuesto de ningún usuario individual. Aparecen como uso adicional en los informes de facturación. Los usuarios con una licencia Copilot que incluye revisión de código consumen AI credits del fondo común, según los presupuestos por usuario configurados por su administrador.

Uso del modelo

Copilot code review es un producto creado específicamente que usa una combinación cuidadosamente optimizada de modelos, mensajes y comportamientos del sistema para proporcionar comentarios coherentes y de alta calidad en una amplia gama de códigos base. No se admite el cambio de modelo, ya que es probable que el cambio del modelo ponga en peligro la confiabilidad, la experiencia del usuario y la calidad de los comentarios de revisión.

Servidores MCP y capacidades de agente para la revisión de código

Copilot code review puede usar aptitudes de agente de nivel de repositorio y servidores MCP cuando son relevantes para la revisión.

Copilot code review tendrá más probabilidades de usar habilidades y contexto de MCP cuando tu repositorio o pull request proporcionen señales claras, incluidos nombres de directorios de habilidades orientados a la revisión, instrucciones personalizadas que hagan referencia al contexto de MCP y descripciones de pull requests que incluyan identificadores que remitan a servidores MCP configurados, como claves de incidencias o identificadores de incidentes.

Aptitudes del agente

Si tu repositorio incluye habilidades del agente, Copilot code review puede usar automáticamente las habilidades pertinentes al revisar una pull request, ampliando las capacidades de Copilot más allá de su análisis incorporado.

Al revisar una solicitud de incorporación de cambios, Copilot lee las instrucciones personalizadas del repositorio, las instrucciones del agente y las capacidades del agente de la rama de origen (la rama con sus cambios), y no de la rama base. Por ejemplo, al combinar my-feature-branch en main, Copilot usa las instrucciones y aptitudes de my-feature-branch, por lo que puede probar los cambios en ellas en la misma solicitud de incorporación de cambios sin combinarlas primero.

Para obtener más información sobre la configuración, consulte Agregar aptitudes de agente para GitHub Copilot.

Servidores MCP

Copilot code review puede utilizar servidores MCP para incorporar contexto directamente a la revisión desde las plataformas de terceros y los sistemas internos que utiliza tu equipo, incluidos el seguimiento de incidencias, la documentación, los catálogos de servicios y las herramientas de gestión de incidentes.

El GitHub servidor MCP y el servidor MCP de Playwright están habilitados de forma predeterminada.

Puede configurar servidores MCP en la configuración del repositorio. La configuración de MCP del repositorio en GitHub se aplica a Copilot cloud agent y Copilot code review. Los cambios realizados en la configuración de MCP del repositorio afectan a ambas características. Para obtener más información sobre la configuración, consulte Configuración de servidores MCP para el repositorio.

En la configuración del repositorio, Allow Copilot usar herramientas de MCP al revisar las solicitudes de incorporación de cambios está habilitada de forma predeterminada. Deshabilite esta configuración si desea que los servidores MCP estén disponibles solo para Copilot cloud agenty no para Copilot code review. Para obtener instrucciones paso a paso, consulte Configuración de servidores MCP para el repositorio.

Validación de revisiones de Copilot código

Copilot no garantiza detectar todos los problemas o inconvenientes en un pull request. A veces cometerá errores. Valide siempre cuidadosamente las opiniones de Copilot. Complementar la retroalimentación de Copilot con una revisión humana.

Para más información, consulta Tarjeta de aplicación: agentes de GitHub Copilot.

Mejorar el conocimiento de Copilot sobre un repositorio.

Cuanto más Copilot sepa sobre el código del repositorio, las herramientas que usa y los estándares y prácticas de codificación, se convertirán en más precisos y útiles sus revisiones. Puede mejorar los conocimientos de Copilot sobre sus repositorios de dos maneras.

Instrucciones personalizadas

Estas son instrucciones breves de lenguaje natural que se escriben y almacenan como uno o varios archivos en un repositorio. Si es el propietario de una organización en GitHub, también puede definir instrucciones personalizadas en la configuración de su organización. Para más información, consulta Acerca de la personalización de las respuestas de GitHub Copilot.

Elección entre instrucciones personalizadas, AGENTS.md y aptitudes

Copilot code review puede recurrir a varias fuentes de personalización, y cada una tiene una finalidad distinta. Use .github/copilot-instructions.md para reglas a nivel de repositorio específicas para Copilot; use archivos *.instructions.md específicos de cada ruta en .github/instructions/ para reglas que solo se apliquen a determinados archivos o directorios; use AGENTS.md para reglas permanentes que desea compartir entre herramientas y agentes de IA; y use habilidades para flujos de trabajo específicos de tareas que Copilot ejecuta bajo demanda. En la tabla siguiente se resume cuándo usar cada una de ellas y cómo proporcionar reglas.

Use	copilot-instructions.md	Archivos *.instructions.md específicos de ruta	AGENTS.md	Habilidades
Más adecuado para	Reglas siempre activas a nivel de repositorio para Copilot	Reglas permanentes para rutas, tipos de archivo o directorios	Reglas permanentes compartidas entre agentes de IA	Flujos de trabajo de revisión específicos de la tarea
Almacenado en	.github/copilot-instructions.md	.github/instructions/**/*.instructions.md	Raíz del repositorio (AGENTS.md)	.github/skills/...
Examples	Estándares de codificación, valores predeterminados de arquitectura, expectativas de prueba
content/** escribir reglas, src/** convenciones de codificación, instrucciones específicas del lenguaje	Convenciones de repositorio compartido que deben aplicarse más allá de Copilot	Reseñas, lanzamientos, migraciones, análisis
Activation	Automatic	Automático cuando los archivos modificados coinciden con el ámbito de instrucción	Automático (lectura desde la raíz del repositorio)	Automático cuando corresponda (p. ej., habilidades orientadas a la revisión, como code-review) o bajo demanda
Ámbito	A nivel de repositorio y específicas para Copilot	Subrutas del repositorio y específicas para Copilot	Interherramientas / independiente del agente	Invocado por tarea
Rule
Copilot, ten siempre esto presente sobre este repositorio
Copilot, ten siempre esto presente al trabajar en estas rutas	Cualquier agente debe saber esto siempre	"Haz esto cuando sea necesario"

Para obtener más información, vea Agregar aptitudes de agente para GitHub Copilot y Agregar instrucciones personalizadas del repositorio para GitHub Copilot.

Copilot Memory (versión preliminar pública)

Si tiene un plan Copilot Pro, Copilot Pro+ o Copilot Max, puede activar Copilot Memory. Esto permite Copilot almacenar detalles útiles que ha aprendido sobre un repositorio. Copilot Después, puede usar esta información cuando revisa las solicitudes de incorporación de cambios en ese repositorio. Para más información, consulta Acerca de la memoria de GitHub Copilot.

Acerca de las revisiones automáticas de solicitudes de cambios

De forma predeterminada, Copilot solo revisa una solicitud de incorporación de cambios si se le asigna a dicha solicitud. Sin embargo, puede configurar revisiones automáticas.

• Los usuarios individuales del Copilot Pro plan o Copilot Pro+ pueden configurar Copilot para revisar automáticamente todos los pull requests que crean.
• Los propietarios del repositorio pueden configurar Copilot para revisar automáticamente todas las solicitudes de incorporación de cambios en el repositorio que crean los usuarios con acceso a Copilot.
• Los propietarios de la organización pueden configurar Copilot para revisar automáticamente todas las solicitudes de incorporación de cambios en algunos o todos los repositorios de la organización donde un usuario crea Copilot la solicitud de incorporación de cambios.

Si su organización ha habilitado Copilot code review sin una licencia Copilot, las revisiones automáticas también se aplican a las solicitudes de extracción creadas por miembros de la organización que no tienen licencia. Esto se aplica a los repositorios cubiertos por una directiva en la que se habilitan las revisiones automáticas. Para obtener más información, consulte Copilot code review sin licenciaCopilot.

Desencadenamiento de una revisión automática de solicitudes de incorporación de cambios

Los desencadenadores para la revisión automática de código dependen de los valores de configuración.

• Configuración básica:
  • Al crear una solicitud de incorporación de cambios como una "solicitud abierta".
  • La primera vez que cambie una solicitud de incorporación de cambios de "Borrador" a "Abierta".
• Revisa las nuevas inserciones:
  • Cada vez que inserta una nueva confirmación en la solicitud de incorporación de cambios.
• Revisión de borradores de solicitudes de incorporación de cambios:
  • Las solicitudes de incorporación de cambios se revisan automáticamente mientras siguen siendo borradores, antes de cambiarlas a "Abrir".

Para obtener instrucciones completas, consulte Configuración de la revisión automática de código mediante GitHub Copilot.

Obtención de comentarios detallados sobre la calidad del código en el repositorio

GitHub Copilot code review revisa los cambios en una solicitud de incorporación de cambios y sugiere correcciones. Para agregar comentarios sistemáticos sobre la confiabilidad y el mantenimiento del código, en las solicitudes de incorporación de cambios y en la rama predeterminada, habilite GitHub Code Quality.

GitHub Code Quality complementa a Copilot code review añadiendo:

• Análisis basado en reglas en CodeQL solicitudes de incorporación de cambios y en la rama predeterminada.
• Pruebe las métricas de cobertura sobre las solicitudes de incorporación de cambios, para poder ver si un cambio mantiene o reduce la cobertura.
• Correcciones en un clic, impulsadas por Copilot, incluida la posibilidad de delegar la remediación a Copilot cloud agent.
• Bloqueo opcional de la fusión con conjuntos de reglas, para impedir la fusión de solicitudes de incorporación de cambios que tengan incidencias no resueltas detectadas por las reglas (o que no alcancen un umbral de cobertura).

Para más información, consulta Calidad del código de GitHub.

Información adicional

• Uso de GitHub Copilot para la revisión de código