automatizaciones de Copilot

Overview

Con automations, puede configurar Copilot cloud agent para que se ejecute automáticamente, ya sea según una programación, en respuesta a un evento de un repositorio o desencadenado a través de la API. Automations puede realizar acciones dentro del repositorio donde están configurados, como abrir una solicitud de incorporación de cambios o etiquetar un problema.

Defina su prompt una vez, seleccione los desencadenadores y decida qué herramientas Copilot deben poder usar. Copilot ejecuta la automatización automáticamente cada vez que se activa el automationdesencadenador.

Por ejemplo, puede usar automations para:

• Reproducir bugs: intente reproducir un bug notificado cuando se abre una incidencia.
• Capture capturas de pantalla para su revisión: capture capturas de pantalla de los cambios y adjúntelas a una solicitud de incorporación de cambios cuando esté marcada como lista para su revisión.
• Investigar incidentes de producción: empiece a investigar un incidente cuando la herramienta de supervisión lo detecte.

También puede crear y administrar automations desde:

• Pestaña Agentes de un repositorio en GitHub
• La pestaña Automations en GitHub Copilot app
• La ventana Agentes en VS Code
• La API de la REST

Al crear un automation, se define lo siguiente:

• Un nombre para identificar el automation.
• Un tipo, ya sea personal o compartido, que determina quién puede ver y editar automation, a quién se factura y cuya identidad usa. Consulte Personal y compartido automations.
• Una instrucción que describe la tarea que quieres que Copilot realice.
• Desencadenadores que determinan cuándo automation se ejecuta.
• Las herramientas queCopilot puede usar, que controlan qué acciones puede realizar en su repositorio.
• Opcionalmente, se usan el modelo y el nivelCopilot de razonamiento.
• Opcionalmente, AI credits límites que controlan cuántos AI credits puede consumir el automation.

Puede agregar automations a automation groups que comparten contexto y pueden sugerir mejoras en función de los resultados.

Para obtener instrucciones sobre cómo crear y administrar automations, consulte Creación de automatizaciones con Copilot agente en la nube.

Disponibilidad y permisos

Para que automations esté disponible en un repositorio, deben cumplirse todas las condiciones siguientes:

• El repositorio debe ser privado o interno. Automations no están disponibles en repositorios públicos.
• Copilot cloud agent debe estar habilitado para el repositorio. Si tiene Copilot Business o Copilot Enterprise, un administrador debe habilitar la Copilot cloud agent directiva. Consulte Administración de GitHub Copilot en la nube para su empresa u organización.
• La organización debe permitir tanto Copilot cloud agent como automations en el repositorio (ambos están habilitados de forma predeterminada). Consulte Administración de GitHub Copilot en la nube para su organización.

Automations están disponibles con los planes GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Max, GitHub Copilot Business y GitHub Copilot Enterprise.

Cualquier usuario con acceso de escritura a un repositorio puede crear automations en ese repositorio.

Puede crear y administrar automations desde:

• La pestaña Agentes en un repositorio de GitHub, en el panel Automations.
• La pestaña Automations en GitHub Copilot app.
• La pestaña Automations en la ventana Agentes de VS Code.

La nube automations en VS Code requieren la versión 1.144 o posterior y la configuración chat.automations.cloud.enabled habilitada.

Personal y compartido automations

Al crear un automation, elija su tipo, que no se puede cambiar más adelante.

• Personales automations son útiles para automatizar el trabajo para uno mismo, como preparar las actualizaciones para una reunión diaria.
• Compartidos automations permiten que el equipo cree y mantenga automations, para automatizar los flujos de trabajo de todo el equipo.

Dado que un recurso compartido automation pertenece al repositorio en lugar de a la persona que lo creó, sigue funcionando si esa persona deja el equipo o pierde el acceso al repositorio.

Para que un flujo de trabajo compartido automation se ejecute en un repositorio propiedad de la organización, la organización debe permitir el uso de Copilot cloud agent facturado a la organización. Un administrador puede habilitarlo con la directiva "Permitir el uso de Copilot cloud agent, facturado a la organización".

Desencadenadores

Una automation se ejecuta cuando se activa uno de sus desencadenadores. Hay una amplia gama de desencadenadores disponibles, entre los que se incluyen:

• Programado: automation se ejecuta a intervalos recurrentes: cada hora, cada día o cada semana.
• Cuando se crea un problema: se automation ejecuta cada vez que se abre un problema en el repositorio.
• Cuando se abre una solicitud de extracción: automation se ejecuta cada vez que se abre una solicitud de extracción en el repositorio.
• Cuando se sincroniza una solicitud de extracción: automation se ejecuta cada vez que se envían nuevas confirmaciones a una solicitud de extracción en el repositorio.

Opcionalmente, puede configurar filtros para desencadenadores basados en eventos, por ejemplo:

• Para cuando se crea un problema, agregue un filtro de consulta de búsqueda.
• Para cuando se abre una solicitud de incorporación de cambios y cuando se sincroniza una solicitud de incorporación de cambios, agregue un filtro de consulta de búsqueda y un filtro para los archivos modificados en la solicitud de incorporación de cambios.

Para reducir el riesgo de inyección de prompts, automations omita GitHub los eventos desencadenados por los usuarios que no tienen acceso de escritura al repositorio de forma predeterminada. Esto ayuda a evitar que los usuarios que no son de confianza hagan que Copilot realice una acción, por ejemplo, cuando un colaborador externo abre un problema. Puede optar por permitir estos eventos si es necesario. Para obtener más información, consulte Seguridad y seguridad.

Todos automations se pueden desencadenar a través de la API, lo que permite conectar automations a sistemas y herramientas externos. Al iniciar una automation a través de la API, puede incluir contexto adicional que se pasa al prompt.

Herramientas y acciones

Las herramientas que seleccionas al crear un automation determinan qué Copilot puede hacer cuando se ejecuta el automation.

Por ejemplo, puede permitir Copilot insertar cambios, actualizar etiquetas de problemas o crear una solicitud de incorporación de cambios.

Puede elegir entre dos tipos de herramientas:

• GitHub herramientas, que permiten Copilot trabajar con el repositorio en GitHub. Por ejemplo, las herramientas GitHub permiten Copilot:

  • Cargar archivos adjuntos
  • Ocultar y mostrar comentarios y revisiones
  • Agregar y quitar reacciones
  • Leer discusiones y sus comentarios, y comentar discusiones

• Herramientas de servidores MCP, que permiten Copilot trabajar con sistemas externos. Un automation puede usar herramientas de los servidores MCP configurados en la configuración de MCP del repositorio. Usted elige qué herramientas de cada servidor puede usar el automation. Consulte Configuración de servidores MCP para el repositorio.

Seleccionar herramientas es la forma principal de controlar el ámbito de un automation. Conceda solo las herramientas que necesita la tarea, de modo que Copilot no pueda realizar acciones que no haya previsto.

Puede seleccionar manualmente las herramientas que desea habilitar o puede usar el botón Sugerir herramientas en GitHub para que Copilot sugiera herramientas en función de su mensaje.

GitHub las herramientas solo pueden tomar medidas en el único repositorio al que automation se limita. Las herramientas de los servidores MCP no se limitan a ese repositorio: pueden acceder a todo lo que permitan la configuración y las credenciales del servidor, lo que puede incluir otros repositorios y sistemas externos. Revise a qué puede acceder cada servidor MCP antes de seleccionar sus herramientas.

Configuración heredada del repositorio

Automations usan la configuración de Copilot cloud agent para el repositorio al que están asociados, incluyendo:

• Instrucciones personalizadas. Consulte Agregar instrucciones personalizadas del repositorio para GitHub Copilot.
• Aptitudes del agente. Consulte Agregar aptitudes de agente para GitHub Copilot.
• Reglas de firewall. Consulte Personalización o deshabilitación del firewall para GitHub Copilot.
• Secretos y variables. Consulte Configurar secretos y variables para el agente de Copilot en la nube.

Automations se almacenan por separado del contenido del repositorio. No se guardan en Git, por lo que no se versionan junto con tu código ni se gestionan mediante pull requests.

Billing

Cada vez que automation se ejecuta, inicia una sesión de Copilot cloud agent que usa GitHub AI Credits y GitHub Actions minutos.

Para una cuenta personalautomation, el uso de AI credits se factura al usuario que creó la automation.

Para un automation compartido, el uso de AI credits se factura a la organización que posee el repositorio o a la suscripción Copilot del propietario del repositorio si una cuenta personal posee el repositorio. Para obtener más información, vea licencias de GitHub Copilot y facturación de Acciones de GitHub.

GitHub Actions los minutos se facturan por separado al propietario del repositorio.

Control de costes con AI credits límites

Puede establecer límites sobre cuántos AI credits recursos automation puede consumir. Esto le permite automatizar el trabajo periódico mientras mantiene el control del uso.

Puede establecer los siguientes límites opcionales, AI credits. Deje un límite vacío si no desea establecerlo.

• Por ejecución: detiene una ejecución en cuanto alcanza el límite. El mínimo es 30 AI credits.
• Diario: impide que se inicien nuevas ejecuciones una vez alcanzado el límite. Se restablece todos los días a las 00:00 UTC.
• Semanal: impide que se inicien nuevas ejecuciones una vez alcanzado el límite. Se restablece cada lunes a las 00:00 UTC.
• Mensual: impide que se inicien nuevas ejecuciones una vez alcanzado el límite. Se restablece el primer día de cada mes a las 00:00 UTC.

Los límites diarios, semanales y mensuales no detienen una ejecución que ya está en curso. Para limitar el costo de cada ejecución individual, establezca un límite por ejecución.

Puede establecer límites al crear o actualizar un automation. Consulte Creación de automatizaciones con Copilot agente en la nube.

Mejoras propuestas

Automations puede proponer mejoras en sus propias herramientas, desencadenadores y prompts, y en las de otros automations.

Automations puede sugerir mejoras cuando se produzcan problemas mientras trabajan, como las herramientas que faltan.

Al crear automations con Copilot, Copilot puede ayudarle a crear automation groups que se mejoran a sí mismos, en la que algunos automations realizan trabajo y otros evalúan los resultados, proponiendo continuamente mejoras.

Cuando automation tenga una mejora propuesta, recibirá una notificación y verá la propuesta al ver el/la automation.

Verá una descripción de la mejora propuesta y los cambios que se aplicarán a automation group. Puede decidir si desea aplicar la mejora propuesta o descartarla.

Seguridad y seguridad

Automations ejecutar Copilot sin que una persona inicie cada tarea, por lo que conlleva algunos riesgos adicionales. GitHub proporciona protecciones integradas para ayudar a mitigar estos riesgos.

• Atribución.
  • Las acciones realizadas en GitHub por un automation compartido se atribuyen a Copilot. Si el repositorio requiere al menos una aprobación de solicitud de incorporación de cambios, se requiere una aprobación adicional de forma predeterminada para las solicitudes de incorporación de cambios creadas por una cuenta compartida automation. Los administradores pueden deshabilitar este requisito adicional en los conjuntos de reglas, pero no en las reglas de protección de rama.
  • Las acciones realizadas por un usuario personal automation se atribuyen al usuario que creó el automation. Al igual que con las solicitudes de incorporación de cambios que crea el usuario, no pueden aprobar esas solicitudes de incorporación de cambios, lo que conserva los controles de revisión esperados.
• Herramientas con privilegios mínimos. Elija exactamente qué herramientas automation puede usar, por lo que puede limitarla solo a las acciones que requiere la tarea.
• Entrada no confiable. De forma predeterminada, automations omite los eventos activados por usuarios sin acceso de escritura al repositorio para reducir el riesgo de inyección de instrucciones por parte de usuarios no confiables.
• Ejecuciones de flujo de trabajo. De forma predeterminada, como con todo el trabajo Copilot cloud agent, GitHub Actions los flujos de trabajo no se ejecutan en una solicitud de incorporación de cambios hasta que un usuario con acceso de escritura los aprueba. Esto mitiga el riesgo de que una pull request abierta por un automation active flujos de trabajo automáticamente.
• Ejecuciones en segundo plano. Las Copilot cloud agent sesiones iniciadas por cualquier automation, personal o compartido, son visibles para todos los usuarios con acceso de lectura al repositorio. Cualquier persona que pueda ver estas sesiones puede ver el prompt, los registros de la sesión y cualquier solicitud de extracción u otros cambios que cree Copilot.

Para obtener más información sobre cómo GitHub mitiga los riesgos de Copilot cloud agent, vea Riesgos y mitigaciones para el agente en la nube de GitHub Copilot.

Lectura adicional

• Creación de automatizaciones con Copilot agente en la nube
• GitHub Copilot en GitHub.com y GitHub Mobile
• Para obtener información sobre cómo almacenar la automatización como código, revisarla a través de solicitudes de incorporación de cambios o ejecutarla con un agente de codificación diferente, consulte Flujos de trabajo basados en agentes de GitHub.