Introdução

Os sistemas agente estão alterando a forma como o software é criado e mantido. Em vez de depender apenas de desenvolvedores para escrever e atualizar código, as equipes estão adotando sistemas que podem interpretar metas, propor soluções e tomar medidas dentro de repositórios. Em GitHub, um agente pode criar uma ramificação, modificar arquivos, abrir uma solicitação de pull e iterar com base em comentários de testes, verificações de segurança e revisões de código.

No entanto, a funcionalidade por si só não torna um agente confiável. Sem uma arquitetura bem definida, os agentes podem agir muito cedo, produzir alterações não claras ou operar sem validação suficiente. Em ambientes de produção, essas falhas criam riscos reais para a qualidade do código, a segurança e a estabilidade operacional.

Projetar um sistema de agentes em GitHub não é dar mais liberdade ao agente. Trata-se de definir como o trabalho flui pelo sistema usando funções aplicáveis do GitHub, como pull requests, fluxos de trabalho e regras de repositório. Uma arquitetura bem projetada garante que cada ação do agente saia de um registro visível, seja validada por sinais objetivos e seja aceita somente quando atender aos requisitos de política.

Glossário

Termos e definições principais

Este módulo usa um pequeno conjunto de termos recorrentes. As definições a seguir esclarecem como elas são usadas em todo o conteúdo.

• Plano (artefato) Uma descrição estruturada das alterações pretendidas, normalmente incluída na descrição de uma solicitação de pull. Ele descreve a meta, o escopo, as etapas, os riscos e os critérios de validação para o trabalho.

• Planejamento (funcionalidade do agente) O processo pelo qual um agente gera ou refina um plano com base em uma tarefa, problema ou entrada do usuário. Isso pode ocorrer em diferentes pontos de entrada, como um problema de GitHub ou a interface Agentes.