Desarrollo de flujos de trabajo agente en Acciones de GitHub

Introducción

Flujos de trabajo basados en agentes de GitHub permiten definir automatizaciones de repositorios en Markdown y elegir el agente de codificación de IA que los ejecuta. La gh aw extensión compila cada flujo de trabajo agente en un GitHub Actions flujo de trabajo.

Todo el ciclo de vida del flujo de trabajo (creación, depuración y optimización) es en sí mismo agente. Describe lo que desea en lenguaje natural y un agente de codificación crea, refina y soluciona problemas del flujo de trabajo automáticamente.

En este tutorial se usa un agente de codificación para crear un revisor de solicitudes de incorporación de cambios automatizado que comprueba si los cambios se prueban adecuadamente.

Requisitos previos

Antes de empezar, asegúrese de que tiene lo siguiente:

• Repositorio en GitHub Actions el que está habilitado y tiene acceso de escritura
• GitHub CLI versión 2.0.0 o posterior instalada y autenticada
• Acceso a un agente de codificación compatible, como Claude Code, OpenAI Codexo la CLI de Google Gemini, o CLI de Copiloty sus credenciales necesarias

Para autenticar GitHub CLI, ejecute:

gh auth login --scopes repo,workflow

Instalación de la gh aw extensión

Instale la Flujos de trabajo basados en agentes de GitHub extensión para GitHub CLI:

gh extension install github/gh-aw

Elección de un agente y configuración de la autenticación

Elija la CLI del agente que mejor se adapte al flujo de trabajo. Claude Code, OpenAI Codexo la CLI de Google Gemini, y CLI de Copilot pueden ejecutar Flujos de trabajo basados en agentes de GitHub.

En este artículo se explica una configuración sencilla que agrega la credencial del agente como secreto de repositorio. Si usa Claude Code, OpenAI Codexo la CLI de Google Gemini, almacene la clave de API del agente como secreto de repositorio.

| CLI del agente | engine valor | Secreto del repositorio | | --- | --- | --- | | Claude Code | claude | ANTHROPIC_API_KEYque contiene una clave de API de Anthropic | | OpenAI Codex | codex | OPENAI_API_KEY que contiene una clave de API de OpenAI | | CLI de Google Gemini | gemini | GEMINI_API_KEY que contiene una clave de API de Google AI Studio | | CLI de Copilot (valor predeterminado) | copilot | No se necesita ningún secreto para los repositorios de la organización (consulte a continuación). En el caso de los repositorios personales, COPILOT_GITHUB_TOKEN que contiene un personal access token específico con Copilot Solicitudes establecidas en Lectura. |

También se admiten otros motores como Pi (experimental). Para obtener la lista completa, consulte la referencia de Flujos de trabajo basados en agentes de GitHub autenticación.

Facturación de la organización para GitHub Copilot

Si usa GitHub Copilot en un repositorio propiedad de la organización, puede usar GitHub Actions" integrado en GITHUB_TOKEN lugar de .personal access token Agregue copilot-requests: write a la instancia de frontmatter permissions del flujo de trabajo y no se requiera ningún secreto independiente. Para conocer los pasos de configuración, consulte Creación de flujos de trabajo agente de GitHub.

Almacenamiento de un secreto en la interfaz de usuario de GitHub

Para agregar un secreto para Claude Code, OpenAI Codexo la CLI de Google Geminilos repositorios personales o GitHub Copilot :

1. En GitHub, vaya al repositorio.
2. En el nombre del repositorio, haga clic en Configuración.
3. En la barra lateral, haga clic en Secretos y variables y, a continuación, haga clic en Acciones.
4. Haga clic en Nueva contraseña del repositorio.
5. En el campo Nombre , escriba el nombre del secreto de la tabla anterior.
6. En el campo Secreto , escriba el valor .
7. Haga clic en Añadir secreto.

Crear un flujo de trabajo

Use un agente de codificación para crear el flujo de trabajo a partir de una descripción del lenguaje natural.

1. Desde la raíz del repositorio, inicialice el repositorio para la creación agente. Esto agrega aptitudes e instrucciones que ayudan al agente de codificación a crear y editar flujos de trabajo:

   gh aw init
   

2. Inicie una sesión del agente de codificación en el contexto del repositorio( por ejemplo, mediante Claude Code, OpenAI Codexo la CLI de Google Geminiel modo agente de VS Code o , CLI de Copiloto .

3. Use la agentic-workflows aptitud y describa el flujo de trabajo que desea:

   Copilot prompt

   /agentic-workflows create a pr reviewer that ensure the changes are tested.
   

   El agente crea un archivo Markdown de flujo de trabajo en .github/workflows/, compila el archivo de flujo de trabajo correspondiente .lock.ymlGitHub Actions y le pide que revise y confirme ambos archivos.

4. Revise el flujo de trabajo generado y pida al agente que confirme e inserte los archivos.

Ejecución del flujo de trabajo

El flujo de trabajo generado se desencadena automáticamente en las solicitudes de incorporación de cambios, por lo que se ejecuta la próxima vez que abra o actualice una solicitud de incorporación de cambios en el repositorio.

1. Abra una solicitud de incorporación de cambios en tu repositorio.
2. En GitHub, vaya al repositorio y haga clic en la pestaña Acciones .
3. En la barra lateral izquierda, seleccione el flujo de trabajo que creó el agente.
4. Una vez completada la ejecución, el flujo de trabajo deja una revisión de la solicitud de incorporación de cambios que indica si los cambios incluyen suficientes pruebas.

Pasos siguientes

• Para crear un flujo de trabajo que genere un informe de actividad de problemas semanal, consulte Creación de flujos de trabajo agente de GitHub.
• Para obtener una configuración avanzada del motor, salidas seguras y más ejemplos de flujo de trabajo, consulte el Flujos de trabajo basados en agentes de GitHub sitio de documentación.