{"meta":{"title":"Sobre os fluxos de trabalho agênticos do GitHub","intro":"Automatize tarefas repetitivas do repositório com instruções em linguagem natural executadas por agentes de programação com IA em GitHub Actions.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/concepts","title":"Conceitos"},{"href":"/pt/copilot/concepts/agents","title":"Agentes"},{"href":"/pt/copilot/concepts/agents/about-github-agentic-workflows","title":"Fluxos de trabalho agênticos"}],"documentType":"article"},"body":"# Sobre os fluxos de trabalho agênticos do GitHub\n\nAutomatize tarefas repetitivas do repositório com instruções em linguagem natural executadas por agentes de programação com IA em GitHub Actions.\n\n> \\[!NOTE]\n> Fluxos de trabalho agênticos do GitHub are in prévia pública and subject to change.\n\n## Sobre o fluxos de trabalho baseados em agentes\n\nFluxos de trabalho agênticos do GitHub são automações de repositório alimentadas por IA que você define no markdown e executa como GitHub Actions fluxos de trabalho. Ao contrário da automação tradicional com regras fixas if-then, fluxos de trabalho baseados em agentes use agentes de codificação para entender o contexto, tomar decisões e tomar ações significativas, tudo a partir de instruções de linguagem natural.\n\nNa prática, em comparação com fluxos de trabalho tradicionais que executam etapas predefinidas:\n\n* Fluxos de trabalho de agentes execute instruções de linguagem natural com raciocínio contextual.\n* Você ainda define restrições no frontmatter, como gatilhos, permissões e saídas seguras.\n\nCom fluxos de trabalho baseados em agentes, você pode automatizar tarefas como:\n\n* Triando problemas recebidos e classificando-os por tipo e prioridade\n* Investigando falhas de CI e sugerindo correções\n* Gerando relatórios diários ou semanais sobre a situação do repositório\n* Manter a documentação atualizada com alterações de código\n* Melhorando a cobertura do teste\n\n## Benefícios de usar fluxos de trabalho baseados em agentes\n\n* **Automatize o trabalho repetitivo do repositório**. Definir triagem de problemas, investigação de CI, atualizações de documentação e relatórios em linguagem natural.\n* **Reduza a complexidade do fluxo de trabalho**. Escreva instruções de markdown em vez de criar scripts de procedimento complexos para cada cenário.\n* **Mantenha a revisão humana envolvida no processo**.\n  Fluxos de trabalho de agentes pode gerar saídas prontas para revisão, como problemas, comentários e solicitações de pull, enquanto você controla aprovações e mesclagens.\n* **Execute agentes com segurança em camadas**. Os agentes são executados em contêineres protegidos por firewall com tokens somente de leitura por padrão. As ações de escrita são limitadas a \"saídas seguras\" declaradas, que você definiu e que foram verificadas pela detecção agentiva de ameaças.\n\n## Requisitos\n\nPara criar e usar fluxos de trabalho baseados em agentes, você precisa:\n\n* GitHub Actions habilitado para seu repositório.\n* Uma conta com um mecanismo de IA (agente), comoGitHub Copilot, , Anthropic ClaudeOpenAI Codexou Google Gemini.\n* GitHub CLI instalado e autenticado\n\n## Como fluxos de trabalho baseados em agentes funcionam\n\nCada arquivo markdown de fluxo de trabalho tem duas partes:\n\n* **Frontmatter** (YAML entre `---` marcadores): configura quando o fluxo de trabalho é executado, quais permissões ele tem e quais operações de gravação são permitidas.\n* **Corpo em Markdown**: Contém instruções em linguagem natural que o agente de IA segue.\n\nEm um alto nível, o processo para criar e usar fluxos de trabalho baseados em agentes é:\n\n1. Defina o arquivo de fluxo `.md` de trabalho agente, incluindo instruções de frontmatter e markdown do YAML.\n2. Compile o arquivo de fluxo de trabalho Markdown para um arquivo de fluxo de trabalho reforçado `.lock.yml`GitHub Actions.\n3. Confirme e envie os dois arquivos por push para o branch padrão do repositório.\n4. Execute o fluxo de trabalho como qualquer outro GitHub Actions fluxo de trabalho, por um gatilho ou na interface web do seu GitHub repositório. Você também pode executá-lo do GitHub CLI.\n\nAqui está um exemplo de fluxo de trabalho para criar uma issue de relatório diário de status para um repositório:\n\n```markdown\n---\non: daily\n\npermissions:\n  contents: read\n  issues: read\n  pull-requests: read\n  copilot-requests: write\n\nnetwork: defaults\n\ntools:\n  github:\n    toolsets: [default]\n\nsafe-outputs:\n  create-issue:\n\n---\n\n# Daily Repo Status Report\n\nReview recent activity in the repository, including issues, pull requests, discussions, and code changes.\n\nCreate a GitHub issue summarizing what changed in the last 24 hours (merged pull requests, closed issues, and new discussions), any blockers or open questions mentioned in comments, progress toward visible goals, and recommended next steps for maintainers.\n\nKeep the summary concise. Adjust the level of detail based on how much activity occurred.\n```\n\nPara obter etapas detalhadas sobre como criar e atualizar fluxos de trabalho baseados em agentes, consulte [Criando fluxos de trabalho agênticos do GitHub](/pt/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows).\n\n## Agentes de codificação com suporte\n\nFluxos de trabalho agênticos do GitHub dão suporte a vários agentes de codificação, incluindo:\n\n* GitHub Copilot (requer um GitHub Copilot plano)\n* Anthropic Claude\n* OpenAI Codex\n* Google Gemini: Um projeto de inteligência artificial do Google.\n\nVocê especifica qual agente usar na propriedade `engine`frontmatter do fluxo de trabalho. Cada mecanismo requer seu próprio segredo de autenticação configurado em seu repositório.\nGitHub Copilot será o mecanismo padrão se nenhum for especificado.\n\nPara obter mais informações, consulte a [referência do mecanismo](https://github.github.com/gh-aw/reference/engines/).\n\n## Barreiras de segurança\n\nFluxos de trabalho agênticos do GitHub são projetados com segurança como prioridade:\n\n* **Somente leitura por padrão**: os fluxos de trabalho têm permissões de repositório somente leitura, a menos que você conceda explicitamente mais.\n* **Saídas seguras**: operações de gravação (como criar problemas, adicionar comentários ou abrir solicitações de pull) só são permitidas por meio de operações de gravação declaradas `safe-outputs` no frontmatter.\n* **Os segredos permanecem fora do ambiente de execução do agente**: credenciais confidenciais são mantidas em tarefas downstream isoladas, em vez de serem expostas diretamente ao agente.\n* **Detecção de ameaças**: as saídas propostas são verificadas quanto a alterações suspeitas ou não seguras antes que as ações de gravação sejam aplicadas.\n* **Execução com firewall**: agentes são executados em ambientes isolados GitHub Actions .\n* **Acesso baseado em** função: você pode restringir quem pode disparar ou modificar fluxos de trabalho baseados em agentes usando controles de acesso baseados em função.\n\nPara obter um passo a passo completo da arquitetura, consulte a [documentação de segurança](https://github.github.com/gh-aw/introduction/architecture/).\n\n## Uso e cobrança\n\nO custo total de fluxos de trabalho baseados em agentes tem duas partes:\n\n* GitHub Actions minutos consumidos por trabalhos de fluxo de trabalho.\n* Custos de inferência do mecanismo de IA configurado.\n\nPara inferência, Fluxos de trabalho agênticos do GitHub use Créditos de IA (AIC) como métrica geral para monitorar e controlar o orçamento em diferentes mecanismos.\n`1 AIC = $0.01 USD`.\n\nA forma como a cobrança se aplica depende do mecanismo:\n\n* Mecanismo padrão GitHub Copilot: o uso de AIC é mapeado para AI credits no faturamento de GitHub Copilot.\n* Mecanismo de terceiros: a inferência é cobrada por esse provedor.\n\nVocê pode usar o GitHub CLI para revisar o uso e o custo estimado de fluxos de trabalho baseados em agentes. Use `gh aw logs` para visualizar execuções recentes de fluxos de trabalho, incluindo duração, uso de tokens e estimativas de AIC em diferentes execuções. Use `gh aw audit RUN-ID` para inspecionar uma única execução com mais detalhes, incluindo o uso de token e o custo estimado de inferência. Os valores AIC são estimativas de melhor esforço e podem não corresponder exatamente às faturas do provedor, portanto, verifique os encargos finais no painel de cobrança do provedor.\n\nVocê também pode definir `max-ai-credits` no frontmatter do fluxo de trabalho para restringir o uso de inferência a uma única execução. O limite padrão é 1.000 AIC por execução.\n\nPara uma visão geral da cobrança do Fluxos de trabalho agênticos do GitHub e orientações sobre otimização de custos, consulte [Gerenciamento de custos](https://github.github.com/gh-aw/reference/cost-management/) no site de documentação do Fluxos de trabalho agênticos do GitHub.\n\n### Ativar a cobrança da organização para Fluxos de trabalho agênticos do GitHub\n\nPara GitHub Copilot fluxos de trabalho agênticos em repositórios pertencentes à organização, se a organização tiver o plano GitHub Copilot, recomendamos enfaticamente usar o `GITHUB_TOKEN` integrado do GitHub Actions. Essa abordagem cobra da organização e evita o uso de uma personal access token.\n\nPara cobrar da organização, você precisa:\n\n1. Um administrador da organização para habilitar as opções \"Copilot CLI\" e \"Permitir o uso do Copilot CLI cobrado da organização\" nas configurações de política de GitHub Copilot. Se \"Copilot CLI\" já estiver habilitada, a política de cobrança será habilitada por padrão.\n2. No frontmatter de cada fluxo de trabalho, inclua `copilot-requests: write` sob o objeto `permissions`.\n\nQuando `copilot-requests: write` é definido nas permissões de frontmatter do fluxo de trabalho, o token 'GitHub Actions' é usado para solicitações do Copilot, portanto você não precisa de um `COPILOT_GITHUB_TOKEN`. Se o token GitHub Actions não tiver acesso GitHub Copilot da organização, o fluxo de trabalho falhará ao enviar solicitações Copilot e você deverá configurar `COPILOT_GITHUB_TOKEN` em vez disso.\n\nPara obter instruções detalhadas de configuração, consulte [Como usar o integrado `GITHUB_TOKEN`](/pt/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows#using-the-built-in-github_token).\n\n## Próximas Etapas \n\n* Para adicionar seu primeiro fluxo de trabalho agente, consulte [Seu primeiro fluxo de trabalho agente](/pt/copilot/how-tos/github-agentic-workflows/quickstart).\n* Para obter mais informações sobre como criar e usar fluxos de trabalho baseados em agentes, consulte [Criando fluxos de trabalho agênticos do GitHub](/pt/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows).\n* Para obter a documentação de referência completa, incluindo padrões avançados e exemplos, consulte o [Fluxos de trabalho agênticos do GitHubsite de documentação](https://github.github.com/gh-aw/)."}