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 CLI
- GitHub Mobile
- VS Code
- Visual Studio
- XCode
- IDE de JetBrains
Nota:
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:
- ** AI credits uso de pago**. Habilite primero esta política. Permite a la empresa u organización incurrir en cargos por revisión de código CopilotAI credits uso.
- 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
Nota:
revisión de código Copilot tiene funcionalidades en versión preliminar pública y sujetas a cambios. El Términos de licencia de la versión preliminar de GitHub se aplica al uso de características de vista previa.
revisión de código Copilot 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 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 capacidades se habilitan automáticamente para los planes Copilot Pro, Copilot Pro+ y Copilot Max.
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 ejecutores de GitHub Actions para funcionalidades de agente en la revisión de código
revisión de código Copilot usa GitHub Actions para ejecutar las funcionalidades agenticas, 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 ejecutores hospedados estándar GitHub. También puede actualizar a ejecutores hospedados de mayor tamaño GitHubpara mejorar el rendimiento o usar ejecutores autohospedados.
Nota:
El uso de ejecutores de mayor tamaño hospedados en GitHub se factura a una tarifa superior por minuto. Los ejecutores autohospedados no consumen GitHub Actions minutos.
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 GitHub Actions minutos asociados a revisión de código Copilot ejecuciones. Para obtener más información, consulte GitHub Actions.
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 agénticas 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 revisión de código Copilot
Los usuarios sin acceso a revisión de código Copilot no tienen una asignación mensual de AI credits para este. 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, 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
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.
Nota:
revisión de código Copilot puede usar modelos que no están habilitados en la página de configuración "Modelos" de la organización. La página de configuración "Modelos" solo controla Chat de Copiloto.
Dado que revisión de código Copilot está disponible de forma general, cualquier uso del modelo estará sujeto a los términos generales. Consulta Administración de directivas y características para GitHub Copilot en su organizació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, Copilot Pro+ o Copilot Max, puede activar 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 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.
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.
Nota:
A menos que Copilot se haya configurado para revisar cada inserción en una solicitud de incorporación de cambios, solo revisará una solicitud de incorporación de cambios una vez. Si realiza cambios en la solicitud de incorporación de cambios después de que haya sido revisada automáticamente y desea que Copilot la revise de nuevo, puede solicitarlo manualmente. Haga clic en el botón situado junto al Copilot nombre en el menú Revisores.
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 Acerca de la calidad del código de GitHub.