Revise las características de "explicación" y "documento" de GitHub Copilot

  • 5 minutos

GitHub Copilot facilita a los desarrolladores trabajar con código complejo o desconocido. En Visual Studio Code, los desarrolladores tienen acceso directo a las características de GitHub Copilot que analizan, explican o documentan código.

Análisis y explicación del código mediante GitHub Copilot

Las siguientes características de GitHub Copilot se pueden usar para analizar y explicar el código:

  • Modo de preguntas: use la vista Chat en modo de preguntas para analizar todo el área de trabajo y formular preguntas sobre temas de codificación, conceptos tecnológicos y prácticas generales de programación.

  • Chat en línea: inicie una sesión de chat en línea directamente desde el editor para preguntar sobre secciones de código específicas.

  • Acciones inteligentes: ejecute la acción inteligente de explicar para explicar el código seleccionado sin siquiera tener que escribir un mensaje.

  • Chat rápido: Haz una pregunta rápida y sigue con lo que estabas haciendo.

Generación de documentación de código insertado mediante GitHub Copilot

Las siguientes características de GitHub Copilot se pueden utilizar para generar documentación de código en línea:

  • Modo de Preguntar: Utilice el modo Preguntar al agente para sugerir documentación de código en línea para un archivo de código, una clase o un método. Revise la documentación sugerida en línea en la vista de chat. Solicite actualizaciones según sea necesario en la conversación de chat. Una vez que esté satisfecho con la documentación propuesta, puede insertar la documentación sugerida en el archivo de código correspondiente.

  • Modo de plan: use el modo Plan para crear un plan de implementación detallado para las tareas de documentación. El modo Plan se puede usar para analizar el código base, identificar los requisitos de documentación y generar un plan paso a paso. Una vez aprobado el plan, puede entregarlo al modo agente para su ejecución.

  • Modo Agente: Use el modo Agente para generar de forma autónoma documentación de código en línea para proyectos de código, archivos, clases o métodos especificados. Haga que el agente realice otras tareas durante o después del proceso de documentación. Acepte o rechace las actualizaciones cuando el agente haya completado las tareas asignadas.

  • Chat en línea: use una sesión de chat en línea para trabajar directamente en el editor de código. El chat en línea es útil cuando desea documentar código específico (clases, métodos o bloques de código) sin salir del editor. Puede proporcionar instrucciones específicas en la indicación o usar el comando de barra oblicua /doc sin información específica si lo desea. Las actualizaciones se muestran en el editor de código y se pueden aceptar o rechazar. También puede elegir la opción para volver a ejecutar el comando con o sin actualizaciones.

  • Acción inteligente 'Generar Docs': utilice la acción inteligente 'Generar Docs' para crear documentación de código en línea para una clase, un método o un bloque de código seleccionado. La acción inteligente Generar documentos es útil cuando no tiene requisitos específicos que requerirían una solicitud. Las actualizaciones se muestran en el editor de código y se pueden aceptar o rechazar. También puede volver a ejecutar la acción inteligente.

Generación de documentación del proyecto mediante GitHub Copilot

Las siguientes características de GitHub Copilot se pueden usar para generar documentación del proyecto:

  • Vista de chat en modo Ask agent (Preguntar al agente): use ask agent para analizar el código base y comprender los proyectos de código, los archivos y las clases. El agente Ask se puede usar para obtener una vista previa de la documentación del proyecto sugerido. Revise las sugerencias y solicite actualizaciones u otros detalles según sea necesario. Inserte la documentación sugerida en un archivo de documentación del proyecto (README.md).

  • Vista de chat en modo Plan del agente: cree un plan de implementación detallado para la documentación del proyecto y, a continuación, entregar al modo de agente para su ejecución.

  • Vista de chat en modo agente: genere una colección de archivos de documentación del proyecto: cree o actualice el README.md, cree o actualice el UsageExamples.md y cree o actualice el ChangeLog.md. Incluya vínculos entre los archivos de documentación, referencie clases y métodos, y garantice la coherencia en toda la documentación.

Importante

Al usar la vista Chat en el modo de agente, cada mensaje que escriba cuenta como una solicitud Premium, multiplicada por el multiplicador del modelo. GitHub Copilot puede realizar varias acciones de seguimiento para completar la tarea, pero estas acciones de seguimiento no cuentan para el uso de la solicitud Premium. Solo se facturan las indicaciones que escriba. El total de solicitudes premium usadas depende del número de mensajes que escriba y del modelo seleccionado. El Plan gratis para GitHub Copilot obtiene 50 solicitudes premium al mes. Consulte las descripciones del plan para obtener más detalles sobre los límites de solicitudes premium para cada suscripción de GitHub Copilot.

Resumen

GitHub Copilot le ayuda a analizar y documentar el código de forma rápida y precisa. Las características de la vista de chat, chat en línea, chat rápido y acción inteligente proporcionan varios niveles de interacción directamente dentro del entorno de Visual Studio Code.