Como automatizar tarefas de repositório com GitHub Agentic Workflows

Quando usar GitHub Agentic Workflows

A ferramenta é voltada a tarefas de repositório que exigem interpretação: resumir novas issues, investigar uma falha de integração contínua ou propor atualizações de documentação. Ela roda dentro do GitHub Actions; não substitui testes determinísticos, builds ou pipelines de deploy. O workflow com IA pode complementar essas etapas, mas o resultado ainda precisa passar pelas verificações do projeto.

O anúncio de disponibilidade geral do GitHub explica que o fluxo é descrito em arquivos Markdown com frontmatter YAML e compilado para Actions. A documentação de início rápido orienta a instalar uma extensão da GitHub CLI e acrescentar um workflow de exemplo.

Pré-requisitos

Antes de começar, confirme que você tem:

• A GitHub CLI (gh) instalada; a documentação do quickstart pede a versão 2.0 ou mais recente.
• Um repositório em que você tenha permissão para adicionar workflows e GitHub Actions habilitado.
• Uma conta ou credencial para o mecanismo de IA escolhido. A documentação lista GitHub Copilot, Claude Code, OpenAI Codex, Google Gemini e Pi, com requisitos de autenticação diferentes.
• Acesso para revisar os dados que o workflow poderá ler, os logs produzidos e as integrações habilitadas.

Para conferir a instalação e o login da CLI:

$ gh --version
$ gh auth status

Instale e adicione um workflow de exemplo

No diretório do repositório, instale a extensão:

$ gh extension install github/gh-aw

O quickstart usa o relatório diário do repositório como exemplo. Adicione-o com o assistente interativo:

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

O assistente verifica permissões, pede a escolha do mecanismo de IA e orienta a configuração de autenticação. Ele acrescenta o arquivo Markdown do workflow e o arquivo compilado de lock ao diretório .github/workflows/; dependendo das escolhas, também pode iniciar uma execução. Esse exemplo consulta atividade recente de issues, pull requests, discussões, releases e alterações de código e abre uma issue com um resumo.

Antes de permitir a execução, abra o arquivo .md gerado e confira os eventos que o acionam, as permissões, a configuração do mecanismo e os dados que serão enviados. Não copie tokens para o arquivo do workflow; siga o método de autenticação documentado para o provedor escolhido.

Personalize, compile e acompanhe

Para mudar as instruções ou o frontmatter, edite o arquivo Markdown. Depois gere novamente o workflow compilado e confira os arquivos alterados:

$ gh aw compile
$ git status

Revise e versione tanto o Markdown quanto o arquivo .lock.yml gerado — o lock é parte necessária da execução no Actions. Depois de enviar a alteração ao branch padrão, acompanhe a execução na aba Actions ou use:

$ gh aw status
$ gh run watch

Para iniciar manualmente o workflow de exemplo, a documentação também oferece gh aw run repo-status, respeitando os requisitos do GitHub Actions para que o workflow esteja registrado no branch padrão.

Se preferir criar um fluxo próprio, use gh aw new e descreva uma tarefa pequena, como resumir issues abertas sem aplicar rótulos automaticamente. Comece com uma ação de leitura e só amplie permissões quando a equipe tiver revisado os efeitos e os controles.

Segurança: salvaguardas não dispensam revisão

O GitHub informa que os agentes começam com permissões de leitura, executam em ambiente isolado e usam o processo de safe outputs para operações de escrita; há também um job de detecção de ameaças. Isso reduz a superfície de risco, mas não torna qualquer workflow automaticamente seguro. Reveja a sensibilidade do repositório, o que o agente pode enviar a serviços externos, os segredos acessíveis, os artefatos e a configuração de rede. Prefira gerar uma proposta ou uma pull request revisável a permitir alterações sem supervisão.

Este tutorial foca em automação de repositório no Actions. Para comparar com a coordenação de papéis entre agentes, veja nosso guia de workflows multiagente no BridgeCode. Para conectar ferramentas externas a um agente no VS Code, confira também como configurar MCP no VS Code.