Uso de Copilot agente en la nube en GitHub

Inicie agente en la nube de Copilot las sesiones directamente en GitHuby, a continuación, itere en los resultados sin salir del explorador.

¿Quién puede utilizar esta característica?

agente en la nube de Copilot está disponible con los planes Copilot Pro de GitHub, GitHub Copilot Pro+, GitHub Copilot para empresas y GitHub Copilot para grandes empresas. El agente está disponible en todos los repositorios almacenados en GitHub, excepto los repositorios propiedad de cuentas de usuario administradas y donde se ha deshabilitado explícitamente.
Sign up for Copilot

En este artículo

Introducción

Puede iniciar agente en la nube de Copilot sesiones desde varios lugares en GitHub. Una vez que se ejecuta una sesión, puede supervisar su progreso, dirigirlo con avisos de seguimiento e iterar en la solicitud de incorporación de cambios resultante, todo ello sin salir del explorador.

Para obtener más información sobre agente en la nube de Copilot, consulta Acerca de GitHub Copilot agente en la nube.

Iniciar una sesión desde la pestaña o el panel de agentes

Puede iniciar sesiones desde la pestaña agentes y el panel agentes. La única diferencia es el punto de entrada: una vez que vea el formulario "Nueva tarea del agente", los pasos son los mismos.

  1. Abra el panel o la pestaña agentes:

    • Abre la pestaña Agentes en un repositorio.
    • Ve a la página agentes: Ve a github.com/copilot/agents. También puedes llegar aquí abriendo el panel agentes y haciendo clic en Ver todo.
    • Abre el panel agentes: haz clic en en la barra de navegación situada en la parte superior derecha de GitHub.

  2. Con el menú desplegable del campo del aviso, seleccione el repositorio en el que desea trabajar Copilot.

  3. Escribe una indicación que describa la solicitud. También puede agregar entradas visuales como capturas de pantalla o bocetos de interfaz de usuario pegando, arrastrando o cargando una imagen. Archivos admitidos: image/png, image/jpeg, image/gif, image/webp.

    Por ejemplo: Implement a user friendly message for common errors.

    Si desea que Copilot abra una solicitud de extracción, puede solicitarlo en la línea de comandos, por ejemplo Open a pull request to implement a user friendly message for common errors.

  4. Opcionalmente, seleccione una rama base para los cambios de Copilot. Copilot creará una nueva rama basada en esta rama.

  5. Opcionalmente, puede hacer clic para abrir el menú desplegable del agente, si desea asignar un agente o un agente personalizado con un comportamiento y herramientas especializados. Puede seleccionar un agente personalizado existente del repositorio, la organización o la empresa. También puede hacer clic en Crear un agente para crear un nuevo perfil de agente en el repositorio y la rama seleccionados. Para más información, consulta Creación de agentes personalizados para agente en la nube de Copilot.

    Nota:

    Los agentes de terceros están disponibles en los planes Copilot Pro de GitHub, GitHub Copilot Pro+, GitHub Copilot para empresasy GitHub Copilot para grandes empresas .

  6. Opcionalmente, puede usar el menú desplegable para seleccionar el modelo que Copilot usará. Para obtener más información, vea Cambio del modelo de IA para GitHub Copilot agente en la nube.

  7. Haga clic o presione Entrar.

Copilot iniciará una nueva sesión, que aparecerá en la lista debajo del cuadro de aviso. Copilot trabajará en la tarea y subirá los cambios de código.

Puede realizar un seguimiento del trabajo de Copilot y abrir un pull request con un solo clic desde los registros de la sesión. Para obtener más información, vea [AUTOTITLE](/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents).

Inicio de una sesión desde el panel

Puede pedir que Copilot inicie el trabajo desde el cuadro de solicitud en el panel. El panel de control es su resumen personalizado de la actividad en GitHub, visible cuando visita https://github.com mientras haya iniciado sesión.

  1. Vaya al tablero de control en https://github.com.

  2. Haga clic en el botón Tarea .

  3. Con el menú desplegable del campo del aviso, seleccione el repositorio en el que desea trabajar Copilot.

  4. Escribe una indicación que describa la solicitud.

    Por ejemplo: Implement a user friendly message for common errors.

    Si desea abrir una solicitud de incorporación de cambios, puede pedirlo en su solicitud, por ejemplo

  5. Seleccione una rama base para el pull request de Copilot. Copilot creará una nueva rama basada en esta rama.

  6. Opcionalmente, puede hacer clic para abrir el menú desplegable del agente, si desea asignar un agente o un agente personalizado con un comportamiento y herramientas especializados. Puede seleccionar un agente personalizado existente del repositorio, la organización o la empresa. También puede hacer clic en Crear un agente para crear un nuevo perfil de agente en el repositorio y la rama seleccionados. Para más información, consulta Creación de agentes personalizados para agente en la nube de Copilot.

    Nota:

    Los agentes de terceros están disponibles en los planes Copilot Pro de GitHub, GitHub Copilot Pro+, GitHub Copilot para empresasy GitHub Copilot para grandes empresas .

  7. Haga clic en Enviar ahora o presione Devolver.

    Se le llevará a la pestaña de agentes y Copilot iniciará una nueva sesión, que aparecerá en la lista "Sesiones recientes" debajo del cuadro de solicitud. Copilot trabajará en la tarea y subirá los cambios de código.

    Nota:

    Si ha habilitado la Nueva Experiencia de Panel en la vista previa de funciones, la nueva sesión aparecerá en "Sesiones del agente" en el cuadro de aviso del panel de control. Para obtener más información, vea Tablero personal.

A partir de Copilot Chat

  1. Abra Copilot Chat de GitHub en GitHub.com.

  2. Escriba /task para pedir Copilot que cree una solicitud de incorporación de cambios y proporcione detalles de lo que desea Copilot cambiar.

    Por ejemplo: /task Create a pull request to put backticks around file names and variables in output.

  3. Seleccione una rama base para el pull request de Copilot. Copilot creará una nueva rama basada en esta rama y, a continuación, insertará los cambios en una solicitud de incorporación de cambios que tenga como destino esa rama.

  4. Opcionalmente, puede hacer clic para abrir el menú desplegable del agente, si desea asignar un agente o un agente personalizado con un comportamiento y herramientas especializados. Puede seleccionar un agente personalizado existente del repositorio, la organización o la empresa. También puede hacer clic en Crear un agente para crear un nuevo perfil de agente en el repositorio y la rama seleccionados. Para más información, consulta Creación de agentes personalizados para agente en la nube de Copilot.

    Nota:

    Los agentes de terceros están disponibles en los planes Copilot Pro de GitHub, GitHub Copilot Pro+, GitHub Copilot para empresasy GitHub Copilot para grandes empresas .

  5. Haga clic o presione Entrar.

Copilot iniciará una nueva sesión, que aparecerá en la lista debajo del cuadro de aviso. Copilot trabajará en la tarea y enviará los cambios a su pull request, luego te añadirá como revisor al terminar, lo que desencadenará una notificación.

Asignación de un problema a Copilot

Puede pedir que Copilot empiece a trabajar en un problema asignando el problema a Copilot. Copilot comenzará a trabajar en la tarea, generará una solicitud de incorporación de cambios y, a continuación, solicitará una revisión de usted cuando haya terminado.

Nota:

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

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Debajo del nombre del repositorio, haz clic en Issues.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, una pestaña, con la etiqueta "Problemas", se destaca en naranja oscuro.

  3. Abra el problema que desea asignar a Copilot.

  4. En el menú de la derecha, haga clic en Assignees.

    Captura de pantalla de la barra lateral derecha de un problema. Un encabezado etiquetado como "Usuarios asignados", resaltado en naranja oscuro.

  5. Haga clic en Copilot en la lista de asignados.

    Captura de pantalla de la ventana "Assignees" en una incidencia. Copilot está disponible en la lista.

    De este modo se muestran más opciones.

    Captura de pantalla del cuadro de diálogo "Asignar a Copilot" en el que se muestran las opciones del repositorio de destino, la rama inicial, agente personalizado y instrucciones adicionales.

  6. En el campo Aviso opcional , puede agregar instrucciones específicas para Copilot. Agregue cualquier contexto, restricciones o requisitos específicos que le ayudarán Copilot a comprender y completar la tarea.

    Por ejemplo, puedes incluir instrucciones sobre patrones o marcos de codificación específicos para usar, requisitos de prueba, preferencias de estilo de código, archivos o directorios que deben o no modificarse.

    Además de los detalles que proporcione aquí, Copilot usará las instrucciones personalizadas que se hayan configurado para el repositorio de destino. Consulte Agregar instrucciones personalizadas del repositorio para GitHub Copilot.

  7. Puede usar los menús desplegables en el cuadro de diálogo para cambiar el repositorio en el que Copilot funcionará y la rama desde la que se bifurcará.

    Todos los repositorios en los que tenga al menos acceso de lectura se mostrarán en el menú desplegable del repositorio. Sin embargo, solo puede seleccionar un repositorio si tiene acceso de escritura a él y si agente en la nube de Copilot está habilitado para ese repositorio.

    Si selecciona un repositorio en una organización diferente de la organización de origen del problema, o si selecciona un repositorio público cuando el problema se encuentra en un repositorio privado, se mostrará una advertencia.

    Si no especifica un repositorio, Copilot funcionará en el mismo repositorio que el problema. Si no especifica una rama, Copilot funcionará desde la rama predeterminada del repositorio seleccionado.

    Sugerencia

    Cuando asigna un problema a Copilot, se envía el título del problema, la descripción, los comentarios que existen actualmente y las instrucciones adicionales que proporcione. Después de asignar el problema, Copilot no será consciente y, por lo tanto, no reaccionará a ningún comentario adicional que se agregue al problema. Si tiene más información o cambios en el requisito original, agréguelo como comentario en la solicitud de incorporación de cambios que Copilot genera.

  8. Opcionalmente, puede hacer clic para abrir el menú desplegable del agente, si desea asignar un agente o un agente personalizado con un comportamiento y herramientas especializados. Puede seleccionar un agente personalizado existente del repositorio, la organización o la empresa. También puede hacer clic en Crear un agente para crear un nuevo perfil de agente en el repositorio y la rama seleccionados. Para más información, consulta Creación de agentes personalizados para agente en la nube de Copilot.

    Nota:

    Los agentes de terceros están disponibles en los planes Copilot Pro de GitHub, GitHub Copilot Pro+, GitHub Copilot para empresasy GitHub Copilot para grandes empresas .

  9. Opcionalmente, puede usar el menú desplegable para seleccionar el modelo que Copilot usará. Para obtener más información, vea Cambio del modelo de IA para GitHub Copilot agente en la nube.

También puede asignar problemas a Copilot desde otros lugares en GitHub.com:

  • En la lista de incidencias en la página de Incidencias de un repositorio.
  • Cuando se visualiza un problema en GitHubProyectos.

Propagación de un nuevo repositorio

Al crear un nuevo repositorio, puede pedir a Copilot que inicialice el nuevo repositorio ingresando un mensaje de solicitud.

  1. En la esquina superior derecha de cualquier página, selecciona y luego haz clic en Nuevo repositorio.

    Captura de pantalla del menú desplegable GitHub que muestra las opciones para crear nuevos elementos. El elemento de menú "New repository" está resaltado en naranja oscuro.

  2. Usa el menú desplegable Propietario para seleccionar la cuenta que quieres que sea propietaria del repositorio.

    Captura de pantalla del menú del propietario de un repositorio de GitHub nuevo. El menú muestra dos opciones, octocat y github.

  3. En el campo Solicitud, escriba una instrucción que describa lo que desea Copilot crear.

    Por ejemplo, Create a Rust CLI for converting CSV spreadsheets to Markdown1. Haga clic en Create repository (Crear repositorio).

Copilot abrirá inmediatamente una solicitud de incorporación de cambios de borrador. Copilot trabajará en la tarea y enviará los cambios a su pull request, luego te añadirá como revisor al terminar, lo que desencadenará una notificación.

Corrección de una ejecución de flujo de trabajo con errores GitHub Actions

Nota:

Esta función solo está disponible para usuarios de Copilot Business y Copilot Enterprise.

Cuando se produce un error en una GitHub Actions ejecución de flujo de trabajo en una rama de solicitud de incorporación de cambios, puede pedir que Copilot investigue y corrija el error.

  1. En GitHub, vaya a la página de trabajo de ejecución de flujo de trabajo con errores.

  2. Haga clic en el botón Corregir con Copilot.

Copilot iniciará una nueva sesión, investigará la causa del error e insertará una corrección en la rama.

Seguir trabajando en una pull request

Puede mencionar @copilot en un comentario de cualquier solicitud de cambios para pedirle a Copilot que realice cambios. Esto funciona en las solicitudes de incorporación de cambios creadas por Copilot y en las solicitudes de incorporación de cambios creadas por usted u otros usuarios.

De forma predeterminada, Copilot inserta confirmaciones directamente en la rama de solicitud de incorporación de cambios. Para crear en su lugar una solicitud de incorporación de cambios independiente, describa la solicitud en el comentario. También puede consultar la rama e insertar los cambios usted mismo.

Revise por lotes los comentarios en lugar de enviarlos individualmente. Al enviar un comentario de solicitud de incorporación de cambios (no un comentario de revisión escrita o revisión general) a través de la GitHub interfaz web, seleccione un modelo con el selector de modelos. Copilot usa el modelo de la solicitud de incorporación de cambios original de forma predeterminada.

Copilot solo responde a los comentarios de personas que tienen acceso de escritura al repositorio.

Cuando Copilot inicia una nueva sesión en respuesta a su comentario, aparece una reacción emoji de ojos abiertos (👀) en el comentario. Aparece un evento "Copilot ha iniciado el trabajo" en la escala de tiempo de la solicitud de incorporación de cambios.

Captura de pantalla de una línea de tiempo de una solicitud de incorporación de cambios con un comentario de revisión con el emoticono de ojos y un evento en la línea de tiempo de "Copilot comenzó a trabajar".

Copilot recuerda el contexto de las sesiones anteriores en el mismo pull request, por lo que las solicitudes de seguimiento son más rápidas y confiables. Si la solicitud de incorporación de cambios fue creada por un agente personalizado, al mencionar @copilot, se continúa usando ese mismo agente.

Resolución de conflictos de combinación

Puede pedir que Copilot resuelva conflictos de combinación en una solicitud de extracción de dos maneras:

  • Con el botón "Corregir con Copilot": Si una pull request tiene conflictos de merge, haga clic en el botón Corregir con Copilot que aparece en el cuadro de merge.
  • Uso de una @copilot mención: Mencione @copilot en un comentario sobre el pull request y pídale que corrija los conflictos, por ejemplo, "@copilot resuelva los conflictos de fusión en este pull request".

Copilot analiza los cambios en conflicto, los resuelve y comprueba que la compilación, las pruebas y el linter siguen siendo satisfactorios. A continuación, solicita tu revisión para que puedas confirmar la resolución antes de fusionarlas.

Administración de ejecuciones de flujo de GitHub Actions trabajo

De forma predeterminada, los flujos de trabajo GitHub Actions no se ejecutarán automáticamente cuando Copilot se insertan cambios en una solicitud de incorporación de cambios.

GitHub Actions los flujos de trabajo pueden tener privilegios y tener acceso a secretos confidenciales. Inspecciona los cambios propuestos en la solicitud de cambios y asegúrate de que estés de acuerdo para ejecutar tus flujos de trabajo en la rama de la solicitud de cambios. Debe estar especialmente alerta de los cambios propuestos en el directorio .github/workflows/ que afecten a los archivos de flujo de trabajo.

Para permitir que GitHub Actions los flujos de trabajo se ejecuten, haga clic en el botón Aprobar y ejecutar flujos de trabajo en el cuadro de fusión del pull request.

Captura de pantalla del cuadro de combinación en una solicitud de incorporación de cambios de Copilot con el botón "Aprobar y ejecutar flujos de trabajo".

Opcionalmente, puede configurar agente en la nube de Copilot para permitir que GitHub Actions los flujos de trabajo se ejecuten sin intervención humana. Para obtener más información, consulte Configuración de opciones para GitHub Copilot agente en la nube.

Dar comentarios sobre el trabajo de Copilot

Utiliza los botones de comentarios en los pull requests y comentarios de Copilot para evaluar la salida. Sus comentarios ayudan a mejorar la calidad de Copilot.

  1. En una solicitud de incorporación de cambios o comentario de Copilot, haga clic en el botón pulgar hacia arriba (👍) o hacia abajo (👎).
  2. Si hace clic en el botón pulgar hacia abajo, opcionalmente selecciona un motivo y deja un comentario y, a continuación, haz clic en Enviar comentarios.

Lectura adicional