Tu primer flujo de trabajo basado en agentes

Obtenga la primera automatización con tecnología de inteligencia artificial que se ejecuta mediante un flujo de trabajo pregenerado y la CLI de GitHub.

En este artículo

Nota:

Flujos de trabajo basados en agentes de GitHub are in versión preliminar pública and subject to change.

Introducción

Flujos de trabajo basados en agentes de GitHub permiten automatizar las tareas del repositorio mediante flujos de trabajo con tecnología de IA. Para obtener información general sobre Flujos de trabajo basados en agentes de GitHub, consulte Acerca de los flujos de trabajo agente de GitHub.

En esta guía, añadirás un flujo de trabajo agéntico predefinido —un informe diario del estado del repositorio— a un repositorio existente. Esto tarda unos 10 minutos y proporciona un ejemplo de trabajo de los agentes automatizados que se ejecutan en GitHub Actions.

Este inicio rápido se centra en la ejecución del primer flujo de trabajo. Para obtener instrucciones más detalladas sobre la configuración y la solución de problemas, consulte el sitio deFlujos de trabajo basados en agentes de GitHub documentación.

Prerrequisitos

Antes de comenzar, asegúrese de que tiene:

  • Una cuenta de IA: GitHub Copilot, Anthropic Claude, OpenAI Codexo Google Gemini

  • Un repositorio GitHub en el que tiene permisos de escritura

  • GitHub Actions activado para el repositorio

  • GitHub CLI (gh) v2.0.0 o posterior instalado y autenticado

    Para comprobar la versión, ejecute gh --version. Para autenticarse, ejecute:

    gh auth login --scopes repo,workflow

Puede completar este inicio rápido con cualquier motor compatible. GitHub Copilot es el motor predeterminado y solo se requiere un GitHub Copilot plan al elegirlo.

Los sistemas operativos compatibles son Linux, macOS y Windows con WSL.

Paso 1: Instalar 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

Paso 2: Agregar un flujo de trabajo y desencadenar una ejecución

Desde la raíz del repositorio, ejecute:

gh aw add-wizard githubnext/agentics/daily-repo-status

El add-wizard comando acepta referencias de flujo de trabajo en OWNER/REPO/WORKFLOW-NAME formato. Este proceso interactivo hará lo siguiente:

  1. Compruebe los requisitos previos del repositorio.
  2. Pida que seleccione un motor de IA (Copilot es el valor predeterminado o elija entre otros motores).
  3. Le guía en la configuración del secreto y la autenticación para el motor elegido. Según el motor que elija, el asistente puede solicitarle que configure COPILOT_GITHUB_TOKEN, ANTHROPIC_API_KEY, OPENAI_API_KEYo GEMINI_API_KEY. Consulte el artículo de referencia de autenticación para obtener instrucciones de configuración.
  4. Generar el archivo Markdown del flujo de trabajo y compilar el archivo correspondiente .lock.yml.
  5. Abra una solicitud de incorporación de cambios que agregue ambos archivos generados en .github/workflows/.
  6. Le permite revisar y combinar la solicitud de incorporación de cambios usted mismo o elegir un flujo que lo combine.

Una vez creado el flujo de trabajo, se le preguntará si desea ejecutarlo inmediatamente. Seleccione Sí para desencadenar el flujo de trabajo.

Paso 3: Esperar a que se complete el flujo de trabajo

Normalmente, una ejecución de flujo de trabajo automatizada tarda entre 2 y 3 minutos. Una vez completado, aparece un nuevo problema en el repositorio con un informe de estado diario que analiza:

  • Actividad reciente del repositorio (problemas, solicitudes de incorporación de cambios, discusiones, versiones)
  • Seguimiento del progreso y aspectos destacados
  • Pasos siguientes que requieren acción para los mantenedores

Paso 4: Personalizar el flujo de trabajo (opcional)

Puede editar el flujo de trabajo para que coincida con sus prioridades:

  1. Abra .github/workflows/daily-repo-status.md en su repositorio.

  2. Edite el cuerpo de Markdown para describir lo que desea que cubra el informe: el trabajo pendiente del problema, la configuración de CI, las pruebas, el rendimiento o la hoja de ruta.

  3. Si ha cambiado la configuración de frontmatter, vuelva a compilar el flujo de trabajo:

    gh aw compile

  4. Confirme e inserte los cambios.

  5. Opcionalmente, desencadene otra ejecución:

    gh aw run daily-repo-status

Pasos siguientes