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

Presentación

          revisión de código Copilot 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 revisión de código Copilot. 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

          revisión de código Copilot es compatible con:

• GitHub.com

• GitHub Mobile

• VS Code

• Visual Studio

• XCode

• IDE de JetBrains

          revisión de código Copilot es una característica premium disponible con estos planes:
  

• Copilot Pro

• Copilot Pro+

• Copilot Business

• Copilot Enterprise

Consulte Copilot planes.

Si recibe Copilot de una organización, la organización debe habilitar la revisión de código Copilot opción en la configuración de directiva Copilot . Esto se aplica a las revisiones en GitHub.com o en GitHub Mobile. Consulta Administración de directivas y características para GitHub Copilot en su organización.

          revisión de código Copilot sin una Copilot licencia

Los miembros de la organización sin Copilot licencia pueden usar revisión de código Copilot 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 revisión de código Copilot, debe habilitar dos directivas:

1.        **Uso de pago de solicitud Premium**. Habilite primero esta política. Permite a la empresa u organización incurrir en cargos por revisión de código Copilot uso de solicitudes Premium.
   

2.        **Permitir que los miembros sin una Copilot licencia usen revisión de código Copilot en GitHub.com**. Esta subpolítica habilita revisión de código Copilot 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. revisión de código Copilot solo está disponible en repositorios en los que se habilita explícitamente la 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 revisión de código Copilot 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.

          revisión de código Copilot para los usuarios sin licencia no está disponible en los IDEs.

Archivos excluidos

Algunos tipos de archivo se excluyen de revisión de código Copilot:

• 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, revisión de código Copilot no revisará el archivo.

Para más información, consulta Archivos excluidos de revisión de código GitHub Copilot.

Capacidades agentivas para revisión de código Copilot

          revisión de código Copilot tiene funcionalidades en versión preliminar pública y sujetas a cambios. El [AUTOTITLE](/free-pro-team@latest/site-policy/github-terms/github-pre-release-license-terms) se aplica al uso de características de vista previa.

          revisión de código Copilot utiliza funcionalidades agenteicas 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 recopilación completa del contexto del proyecto está disponible con carácter general. * La capacidad de pasar sugerencias a agente en la nube de Copilot. Esto automatiza la creación de un nuevo pull request contra tu rama con las correcciones sugeridas aplicadas. Pasar sugerencias a agente en la nube de Copilot está en versión preliminar pública y sujeto a cambios.

Estas funcionalidades se habilitan automáticamente para planes Copilot Pro o Copilot Pro+.

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

Uso de GitHub Actions runners para capacidades de agentes en la revisión de código

          revisión de código Copilot usa minutos gratuitos para GitHub Actions ejecutar las funcionalidades agente, incluida la recopilación completa de contextos del proyecto y todas las funcionalidades de versión preliminar pública. De forma predeterminada, revisión de código Copilot usa GitHub ejecutores hospedados. También puede actualizarse a runners más grandes hospedados en GitHub para mejorar el rendimiento.

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 GitHub, las funcionalidades 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 Configuring runners for GitHub Copilot code review.

Cuota mensual de revisión de código

Cada vez que Copilot revisa una solicitud de incorporación de cambios o revisa el código en tu IDE, la cuota mensual de Copilot solicitudes premium se reduce en una.

Si un repositorio está configurado para solicitar automáticamente una revisión de código de Copilot para todas las nuevas solicitudes de incorporación de cambios Copilot, el uso de la solicitud premium se aplica a la cuota del autor de la solicitud de incorporación de cambios. Si otro usuario solicita manualmente una revisión, el uso se aplica a la cuota de 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 alcanza la cuota?

Cuando llegue a la cuota mensual, no podrá obtener una revisión de código desde Copilot hasta que se restablezca la cuota. Para poder seguir usando las revisiones de código antes de que se reinicie la cuota, deberá actualizar su plan Copilot o habilitar solicitudes premium adicionales.

Usuarios sin licencia Copilot o plan que incluya revisión de código Copilot

Los usuarios sin acceso a revisión de código Copilot no tienen una cuota de solicitud premium mensual. Esto incluye a los usuarios que no tienen licencia Copilot ni usuarios en el Copilot gratis plan, que no incluye revisión de código Copilot.

Cuando revisión de código Copilot está habilitado para estos usuarios, las solicitudes premium que generen se facturan directamente a la organización o a la empresa según el uso por encima del límite de pago. Esto se aplica tanto a las revisiones solicitadas manualmente como a las revisiones automáticas de código.

Las solicitudes Premium generadas por estos usuarios no se atribuyen a ninguna Copilot cuota del plan. Aparecen como uso por encima del límite en los informes de facturación y el análisis de solicitudes Premium. Los usuarios con una Copilot licencia que incluye la revisión de código continúan consumiendo solicitudes premium de su cuota de plan asignada.

Uso del modelo

revisión de código Copilot 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.

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 Uso responsable de la revisión de código 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.

          Memoria de Copilot (versión preliminar pública)

Si tiene un plan Copilot Pro o Copilot Pro+, puede habilitar Memoria de Copilot. 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 agente para GitHub Copilot.

Acerca de las revisiones automáticas de solicitudes de cambios

De forma predeterminada, Copilot solo revisa un pull request si lo asigna al mismo. 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.
  

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 Configuring automatic code review by GitHub Copilot.

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

          revisión de código GitHub Copilot revisa el código en las solicitudes de incorporación de cambios y proporciona comentarios. Si desea recibir comentarios accionables sobre la confiabilidad y la mantenibilidad de todo su repositorio, habilite GitHub Code Quality. Consulta [AUTOTITLE](/code-security/code-quality/concepts/about-code-quality).

Información adicional

•         [AUTOTITLE](/copilot/how-tos/agents/copilot-code-review/using-copilot-code-review)