# Desarrollo de flujos de trabajo agénticos en Acciones de GitHub Usa GitHub Agentic Workflows para convertir las instrucciones de Markdown en automatizaciones con tecnología de agentes de codificación de terceros. ## Introducción GitHub Agentic Workflows permite definir automatizaciones de repositorios en Markdown y elegir el agente de codificación de IA que las ejecuta. La `gh aw` extensión compila cada flujo de trabajo agéntico 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 basado en agentes. Usted describe lo que desea en lenguaje natural y un agente de codificación crea, refina y soluciona problemas del flujo de trabajo para usted. En este tutorial se usa un agente de codificación para crear un revisor automatizado de pull requests que comprueba si los cambios se prueban adecuadamente. ## Requisitos previos Antes de empezar, asegúrese de que tiene lo siguiente: * Repositorio en el que GitHub Actions 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 Copilot CLI, y la credencial necesaria Para autenticar GitHub CLI, ejecute: ```shell gh auth login --scopes repo,workflow ``` ## Instalación de la `gh aw` extensión Instale la GitHub Agentic Workflows extensión para GitHub CLI: ```shell 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 Copilot CLI pueden ejecutar GitHub Agentic Workflows. 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_KEY`que 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 | \| Copilot CLI (valor predeterminado) | `copilot` | No se necesita ningún secreto para los repositorios de la organización (consulte a continuación). Para los repositorios personales, `COPILOT_GITHUB_TOKEN` con un personal access token específico con **Solicitudes de Copilot** establecidas en **Lectura**. | También se admiten otros motores como Pi (experimental). Para obtener la lista completa, consulte la [GitHub Agentic Workflowsreferencia de autenticación](https://github.github.com/gh-aw/reference/auth/?utm_source=agentic-workflow-actions-docs-linking-gh-aw-auth-reference\&utm_medium=docs\&utm_campaign=universe-2026). ### Facturación de la organización para GitHub Copilot Si usa GitHub Copilot en un repositorio propiedad de la organización, puede usar `GITHUB_TOKEN` integrado de GitHub Actions en lugar de un personal access token. Agregue `copilot-requests: write` al frontmatter del flujo de trabajo `permissions` y no se requiere ningún secreto independiente. Para conocer los pasos de configuración, consulte [Creación de flujos de trabajo agente de GitHub](/es/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows#using-the-built-in-github_token). ### Almacenamiento de un secreto en la interfaz de usuario de GitHub Para agregar un secreto para los repositorios personales de Claude Code, OpenAI Codexo la CLI de Google Gemini o GitHub Copilot: 1. En GitHub, vaya a su repositorio. 2. En el nombre del repositorio, haga clic en ** Configuración**. 3. En la barra lateral, haga clic en **Secretos y variables de Actions** 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 Usa 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 redacción asistida por agentes. Esto agrega aptitudes e instrucciones que ayudan al agente de codificación a crear y editar flujos de trabajo: ```shell gh aw init ``` 2. Inicie una sesión de agente de codificación en el contexto de su repositorio; por ejemplo, con Claude Code, OpenAI Codexo la CLI de Google Gemini, Copilot CLI o el modo agente de VS Code. 3. Use la `agentic-workflows` habilidad y describa el flujo de trabajo que desea: ```copilot copy /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.yml`GitHub Actions y le pide que revise y confirme ambos archivos. 4. Revise el flujo de trabajo generado y pida al agente que confirme y suba los archivos. > [!TIP] > Puede usar el mismo enfoque agéntico para actualizar y mejorar el flujo de trabajo después de que se ejecute. Pida al agente que afine los criterios de revisión, agregue más comprobaciones o depure una ejecución con errores, todo en lenguaje natural. Si edita la frontmatter de flujo de trabajo más adelante, ejecute `gh aw compile` antes de confirmar los cambios. ## Ejecutar el flujo de trabajo El flujo de trabajo generado se desencadena automáticamente en las solicitudes de extracción, por lo que se ejecuta la próxima vez que abra o actualice una solicitud de extracción 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 semanal de actividad de incidencias, consulte [Creación de flujos de trabajo agente de GitHub](/es/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows). * Para obtener una configuración avanzada del motor, salidas seguras y más ejemplos de flujo de trabajo, consulte el [GitHub Agentic Workflows sitio de documentación](https://github.github.com/gh-aw/?utm_source=linking-agentic-workflows-actions-docs-gh-aw-repo\&utm_medium=docs\&utm_campaign=universe-2026).