Seu primeiro fluxo de trabalho agente

Obtenha sua primeira automação alimentada por IA em execução usando um fluxo de trabalho predefinido e a CLI GitHub.

Neste artigo

Observação

Fluxos de trabalho agênticos do GitHub are in prévia pública and subject to change.

Introdução

Fluxos de trabalho agênticos do GitHub permite automatizar tarefas de repositório usando fluxos de trabalho alimentados por IA. Para obter uma visão geral de Fluxos de trabalho agênticos do GitHub, consulte Sobre os fluxos de trabalho agênticos do GitHub.

Neste guia, você adicionará um fluxo de trabalho agente predefinido , um relatório diário de status do repositório, a um repositório existente. Isso leva cerca de 10 minutos e fornece um exemplo funcional de agentes automatizados em execução.GitHub Actions

Este início rápido se concentra em executar seu primeiro fluxo de trabalho. Para obter diretrizes mais profundas de configuração e solução de problemas, consulte o site de Fluxos de trabalho agênticos do GitHub documentação.

Pré-requisitos

Antes de começar, verifique se você tem:

  • Uma conta de IA: GitHub Copilot, , Anthropic ClaudeOpenAI Codexou Google Gemini

  • Um GitHub repositório no qual você tem permissão de gravação

  • GitHub Actions habilitado para o repositório

  • GitHub CLI (gh) v2.0.0 ou posterior instalado e autenticado

    Para verificar sua versão, execute gh --version. Para autenticar, execute:

    gh auth login --scopes repo,workflow

Você pode concluir este início rápido com qualquer mecanismo com suporte. GitHub Copilot é o mecanismo padrão e um GitHub Copilot plano só é necessário quando você o escolhe.

Os sistemas operacionais com suporte são Linux, macOS e Windows com WSL.

Etapa 1: Instalar a gh aw extensão

Instale a extensão Fluxos de trabalho agênticos do GitHub para o GitHub CLI:

gh extension install github/gh-aw

Etapa 2: Adicionar um fluxo de trabalho e disparar uma execução

Na raiz do repositório, execute:

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

O add-wizard comando aceita referências de fluxo de trabalho no OWNER/REPO/WORKFLOW-NAME formato. Este processo interativo será:

  1. Verifique os pré-requisitos do repositório.
  2. Solicite que você selecione um mecanismo de IA (Copilot é o padrão ou escolha entre outros mecanismos).
  3. Orienta você na configuração de segredo e autenticação para o mecanismo selecionado. Dependendo do mecanismo escolhido, o assistente pode solicitar que você configure COPILOT_GITHUB_TOKEN, ANTHROPIC_API_KEY, OPENAI_API_KEY ou GEMINI_API_KEY. Consulte o artigo de referência de autenticação para obter instruções de instalação.
  4. Gere o arquivo markdown do fluxo de trabalho e compile o arquivo correspondente .lock.yml .
  5. Abra um pull request adicionando os dois arquivos gerados em .github/workflows/.
  6. Permite que você revise e mescle o pull request você mesmo ou escolha um fluxo que faz isso para você.

Depois que o fluxo de trabalho for criado, você será perguntado se deseja executá-lo imediatamente. Selecione Sim para disparar o fluxo de trabalho.

Etapa 3: Aguardar a conclusão do fluxo de trabalho

Uma execução de fluxo de trabalho automatizada normalmente leva de 2 a 3 minutos. Quando estiver concluído, uma nova issue aparece no seu repositório com um relatório diário de status que analisa:

  • Atividade de repositório recente (problemas, solicitações de pull, discussões, versões)
  • Acompanhamento de progresso e realces
  • Próximas etapas práticas para mantenedores

Etapa 4: Personalizar o fluxo de trabalho (opcional)

Você pode editar o fluxo de trabalho para corresponder às suas prioridades:

  1. Abra .github/workflows/daily-repo-status.md no repositório.

  2. Edite o corpo do markdown para descrever o que você deseja que o relatório cubra: sua lista de pendências de problema, configuração de CI, teste, desempenho ou roteiro.

  3. Se você alterou a configuração do frontmatter, recompile o fluxo de trabalho:

    gh aw compile

  4. Confirme e envie suas alterações por push.

  5. Opcionalmente, inicie outra execução:

    gh aw run daily-repo-status

Próximas Etapas