Uso de GitHub Copilot para crear propuestas

Usa Copilot para generar rápidamente propuestas estructuradas y de alta calidad a partir de lenguaje natural o imágenes, sin rellenar todos los campos manualmente.

¿Quién puede utilizar esta característica?

Anyone with a Copilot license can use Copilot to create issues.
Try Copilot for free

En este artículo

Nota:

Esta característica e versión preliminar pública y está sujeta a cambios.

La creación de incidencias manualmente puede ser repetitivo y lento. Con Copilot, puedes crear incidencias más rápido si usas mensajes en lenguaje natural o incluso cargas una captura de pantalla. Copilot rellena el título, el cuerpo, las etiquetas, los usuarios asignados, etc., mediante las plantillas o formularios de incidencias del repositorio.

Tienes el control del proceso. Puedes revisar y refinar lo que sugiere Copilot antes de enviar la nueva incidencia.

Crear una propuesta con Copilot

Puedes crear propuestas a partir de la vista envolvente de Copilot Chat.

  1. Ve a la vista envolvente de Copilot Chat (https://github.com/copilot).

  2. En el cuadro de mensaje, describe la incidencia que quieres crear.

    Si contribuyes a incidencias en varios repositorios, usa el formato repo-owner/repo-name para especificar el repositorio de destino para esta incidencia. Si no especificas un repositorio, Copilot lo deducirá en función del repositorio en el que hayas creado una incidencia por última vez.

    Por ejemplo:

    • En PROPIETARIO/REPOSITORIO, crea una solicitud de característica para agregar coincidencia aproximada a la búsqueda.

    • Registrar un error para un error 500. Esto sucede de forma coherente cuando intento iniciar sesión en el sitio.

    • Crea una tarea para cambiar el fondo del logotipo de la aplicación a rojo y agrega la etiqueta "necesita revisión de diseño".

    Nota:

    Solo puedes usar Copilot para crear propuestas en repositorios en los que ya tienes permiso para crear propuestas. Esta característica no cambia el acceso ni omite los permisos del repositorio.

  3. Como alternativa, puedes usar uno de los métodos siguientes para incluir una imagen en el mensaje:

    • Copia una imagen y pégala en el cuadro de indicaciones situado en la parte inferior de la página.
    • Haz clic en en el cuadro de indicaciones y, a continuación, haz clic en Imagen. Ve al archivo de imagen que deseas adjuntar, selecciónalo y haz clic en Abrir.
    • Arrastra y coloca un archivo de imagen desde el explorador de archivos del sistema operativo en el cuadro de indicaciones.

    Después de pegar o cargar la imagen, puedes agregar texto al mensaje, por ejemplo: Create an issue because this error appears when trying to reset a password.

  4. Copilot redactará una incidencia que incluye lo siguiente:

    • Título sugerido.

    • Detalles de los cambios necesarios.

      Si el repositorio tiene formularios o plantillas de incidencias, Copilot elegirá un formulario o plantilla adecuado en función del mensaje. Si no hay formularios o plantillas, Copilot creará un cuerpo de incidencia básico para los detalles de la incidencia.

      Si Copilot usa un formulario de incidencia, dividirá la información del mensaje en los campos pertinentes del formulario, sin perder datos. Copilot te pedirá que proporciones contexto adicional si hay campos que no tienen suficiente información para rellenar.

    En función del mensaje, Copilot también sugerirá metadatos como etiquetas, destinatarios y tipo de incidencia.

  5. Revisa el borrador. Puede:

    • Edita manualmente cualquier parte de la propuesta.
    • Elige otro formulario o plantilla de incidencia sin perder la entrada. Copilot vuelve a aplicar formato al contenido según el formulario o plantilla que elijas.
    • Pide a Copilot que realice cambios con una solicitud de seguimiento.

  6. Una vez que la propuesta tenga buena pinta, haz clic en Crear.

Creación de varias propuestas a la vez

Si la propuesta incluye varias tareas o errores, Copilot puede redactar más de una propuesta a la vez.

Por ejemplo: En PROPIETARIO/REPOSITORIO, crea 3 propuestas: 1) DETALLES DE UNA TAREA, 2) DETALLES DE OTRA TAREA, 3) DETALLES DE UNA TERCERA TAREA

Cada borrador aparece por separado y puedes revisarlos y editarlos individualmente. Para publicar las propuestas, haz clic en Crear en cada una que quieras enviar.

Creación de subpropuestas

Puedes usar Copilot para crear borradores de varias subpropuestas.

Por ejemplo:

In octo-org/octo-repo, plan a new user dashboard. Break it down into an epic, and create sub-issues for each main feature and task.

Copilotgenera un borrador de árbol de propuestas, con una propuesta primaria en el nivel superior y subpropuestas debajo.

Puedes revisar el árbol de propuestas, expandir o contraer las subpropuestas y editar los detalles de cada propuesta.

Haz clic en la propuesta primaria para ver sus detalles en el área de trabajo. La propuesta principal muestra una lista de propuestas secundarias y puedes hacer clic en cada una de ellas para ver y editar sus detalles en el área de trabajo. En una subpropuesta, usa la lista desplegable "Principal" para navegar por el árbol de propuestas. También puedes hacer clic en Revisar y crear en la parte superior del área de trabajo para ver el árbol de propuestas completo y navegar directamente a cualquier propuesta.

Copilot puede modificar el árbol, desvinculando propuestas o adjuntando nuevos borradores.

Por ejemplo, puede hacer lo siguiente:

  • Quitar una subpropuesta del árbol de propuestas:
    Remove sub-issue NAME_OF_ISSUE from the issue tree
  • Agregar una subpropuesta adicional al árbol de propuestas: Add an additional sub-issue with ISSUE_DETAILS to the issue tree

Una vez que hayas terminado de editar los borradores y estés listo para publicar las propuestas, haz clic en Revisar y crear y, a continuación, haz clic en Crear propuestas.

Trabajar con propuestas existentes

Puedes usar Copilot para conectar nuevas propuestas con propuestas que ya existen en el repositorio.

Por ejemplo, puede hacer lo siguiente:

  • Agregar una subpropuesta a una propuesta principal existente:
    Create a sub-issue for octo-org/octo-repo issue #456.
  • Agregar una propuesta principal a una propuesta existente: Create a parent issue for octo-org/octo-repo issue #456.
  • Agregar una propuesta principal a varias propuestas existentes: Create a parent issue for octo-org/octo-repo issues #456, #457, and #458.

El borrador aparece en el área de trabajo, donde puedes revisarlo y editarlo. Para publicar la propuesta, haz clic en Revisar y crear y, a continuación, haz clic en Crear propuestas.

Asignación de propuestas a Copilot

Para asignar una propuesta a Copilot, debes tener Agente de codificación de Copilot habilitado. Consulta Acerca del agente de codificación de GitHub Copilot para empresas y empresas.

Puedes asignar la propuesta durante la creación de una de estas dos maneras:

  • Lenguaje natural: preguntar a Copilot con algo parecido a Assign this issue to Copilot.
  • Manualmente: selecciona "Copilot" en la lista de personas asignadas.

Una vez asignada y creada la propuesta, Copilot comenzará a trabajar en ella automáticamente. Verás un emoticono de reacción 👀 sobre la propuesta para indicar que Copilot está trabajando en ella.

Información adicional