Creación de automatizaciones con Copilot agente en la nube

Introducción

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.

Puede crear y administrar automations desde la pestaña Agentes de un repositorio en GitHub.

También puede crear y administrar automations desde:

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

Para obtener información general sobre automations, incluidos desencadenadores, herramientas, visibilidad y seguridad, consulte automatizaciones de Copilot.

Prerequisites

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.

Habilitación de la nube automations en VS Code

Para usar cloud automations desde VS Code, complete los requisitos previos del repositorio anteriores y, a continuación, haga lo siguiente:

1. Actualice a VS Code la versión 1.144 o posterior.
2. En el editor configuración, habilite chat.automations.cloud.enabled.
3. Abra la ventana Agentes y seleccione la Automations pestaña .

Para obtener instrucciones de creación y administración, consulte Crear y gestionar automatizaciones de agentes en VS Code la documentación.

Creación de una automation

1. En GitHub, navegue hasta la página principal del repositorio.
2. Debajo del nombre de tu repositorio, haz clic en Agentes.
3. En la barra lateral, haga clic en Automations.
4. Haga clic en Crear automation.
5. Haga clic en Crear con agente para trabajar con Copilot para crear automations, o Crear manualmente para configurarlo automations con un formulario.

Creación de un automation con Copilot

Después de hacer clic en Crear con agente, aparecerá una ventana de chat y Copilot le preguntará qué desea automatizar.

Puede trabajar con Copilot para diseñar automation, configurando los desencadenadores, las herramientas y el prompt.

Copilot incluso puede ayudarle a crear grupos auto-mejorables de automations que aprenden de los resultados y sugieren mejoras a sí mismos.

Crear manualmente automation

1. Escriba un nombre para automation.

2. En Tipo, elija el tipo de automation que desea crear:

   • Personal: solo tú puedes ver el automation. AI credits se le cobra y las acciones realizadas en GitHub usan su identidad.
   • Compartido: todos los usuarios con acceso al repositorio pueden ver el automation. AI credits se cobran a la organización o al usuario que posee el repositorio, y las acciones realizadas en GitHub usan la identidad de Copilot.

   No se puede cambiar el tipo después de crear el automation. Consulte automatizaciones de Copilot.

3. Seleccione uno o varios desencadenadores que determinen cuándo se automation ejecuta. Opcionalmente, puede configurar filtros para los desencadenadores para controlar cuándo se activan.

   Para problemas y desencadenadores de pull requests, puede elegir:

   • Qué recursos GitHub se pueden actualizar durante la ejecución. En la lista desplegable Las herramientas configuradas pueden cambiar, elija Cualquier elemento de este repositorio para permitir que las herramientas creen y actualicen GitHub cualquier recurso del repositorio. Elija Solo esta incidencia para limitar las escrituras de esas herramientas a la incidencia o al pull request que desencadenó la ejecución y a los recursos creados durante la ejecución. Esta configuración no limita las herramientas de los servidores MCP, que pueden acceder a los recursos permitidos por su configuración de servidor y sus credenciales. En función de la configuración del repositorio, es posible que la opción Cualquier elemento de este repositorio no esté disponible.
   • Si la actividad de Copilot en la nube puede desencadenarlo automation: desde la lista desplegable Puede desencadenarse mediante , elija Cualquiera excepto Copilot en la nube para omitir los eventos desencadenados por Copilot, incluido automations. Seleccione Cualquiera para escuchar todos los eventos, incluidos los eventos desencadenados por Copilot.
   • Si los usuarios con acceso de solo lectura al repositorio pueden desencadenar esto automation: de forma predeterminada, automations se ignora la actividad de los usuarios que no tienen acceso de escritura al repositorio. Desactive el cuadro Omitir eventos desencadenados por los usuarios sin acceso de escritura a este repositorio para escuchar estos eventos. En función de la configuración del repositorio, es posible que la opción Ignorar eventos activados por usuarios sin acceso de escritura a este repositorio esté bloqueada en un estado habilitado.

4. En el campo prompt, describa la tarea que quiere que Copilot realice cada vez que se ejecute automation.

   Por ejemplo: Label this issue as a bug, an enhancement, or other, based on its content.

5. Opcionalmente, seleccione el modelo y el nivel de razonamiento que desea Copilot usar. Consulte Cambio del modelo de IA para GitHub Copilot agente en la nube.

6. Seleccione las herramientasCopilot que se pueden usar cuando se ejecuta la automation, como insertar cambios, actualizar etiquetas de problemas o crear una solicitud de incorporación de cambios.

   Puede seleccionar GitHub herramientas y herramientas de cualquier servidor MCP configurado en la configuración de MCP del repositorio. Para que las herramientas de un sistema externo estén disponibles, un administrador del repositorio primero debe configurar su servidor MCP para el repositorio. Consulte Configuración de servidores MCP para el repositorio.

   Seleccione solo las herramientas que requiere la tarea. Las herramientas que seleccione controlan qué acciones Copilot pueden realizar en el repositorio. Opcionalmente, puede usar el botón Sugerir herramientas para pedir Copilot que sugiera herramientas en función del mensaje. Consulte automatizaciones de Copilot.

7. Opcionalmente, en los límites de crédito de IA, establezca límites en cuántos AI credits puede consumir el automation. Consulte Establecer AI credits límites.

8. Guarde el/la automation haciendo clic en Crear automatización.

Establecer límites AI credits

Cada vez que se ejecuta automation, consume AI credits, que se te facturan por una cuenta personal automation o al propietario del repositorio por un automation compartido. Para controlar los costos, puede establecer límites en la sección límites de crédito de IA al crear o editar un recurso automation.

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.

Para quitar un límite, edite el automation y borre el valor.

Prueba de un automation

Puede ejecutar un automation inmediatamente, sin esperar a que se active su desencadenador, para comprobar que se comporta según lo esperado.

1. Abra el automation que desea probar desde el panel Automations.

2. Haga clic en el botón Ejecutar.

3. En la lista desplegable Desencadenador , elija el desencadenador que desea simular.

4. Si ha seleccionado el desencadenador Manual , escriba contexto que se incluirá en el mensaje del agente. Puede usarlo para simular la activación de automation a través de la API.

   Si ha seleccionado otro desencadenador, rellene la URL del recurso correspondiente, por ejemplo, la dirección URL del problema que se abrió o el comentario de solicitud de incorporación de cambios que se creó.

5. Haga clic en Ejecutar ahora.

Copilot inicia una sesión de Copilot cloud agent y ejecuta la indicación de automation con las herramientas seleccionadas. Puede abrir la sesión para seguir su progreso y revisar los cambios que realice.

Administración de su Automations

Tus datos personales automations son privados para ti. Los automations compartidos son visibles para todos los usuarios con acceso de lectura al repositorio y cualquier persona con acceso de escritura puede editarlos.

Las sesiones iniciadas desde cualquier automation son visibles para todos los usuarios con acceso de lectura al repositorio.

En el Automations panel de un repositorio, puede hacer lo siguiente:

• Vea sus automations personales y los automations compartidos del repositorio, las sesiones que han iniciado y las AI credits que han consumido.
• Edite un automation para cambiar su nombre, prompt, desencadenadores, herramientas, modelo, esfuerzo de razonamiento o límites de AI credits, y realizar un seguimiento del historial de revisiones del automation.
• Revise las mejoras propuestas en las herramientas, desencadenadores o prompt de un automation, propuestas por el propio automation u otros automations.
• Deshabilite un automation para detenerlo en ejecución o vuelva a habilitarlo más adelante.
• Elimine un elemento automation que ya no necesite.

Para ver todas sus automations en todos los repositorios y tener acceso a la administración de cada una, utilice la vista Automations en el nivel de usuario.

Lectura adicional

• automatizaciones de Copilot
• Inicio de sesiones de GitHub Copilot
• Riesgos y mitigaciones para el agente en la nube de GitHub Copilot