Introdução

Os sistemas agentivos estão a mudar a forma como o software é construído e mantido. Em vez de depender apenas dos programadores para escrever e atualizar código, as equipas estão a adotar sistemas que conseguem interpretar objetivos, propor soluções e agir dentro dos repositórios. No GitHub, um agente pode criar uma ramificação, modificar ficheiros, abrir um pull request e depois iterar com base no feedback de testes, análises de segurança e revisões de código.

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

Desenhar um sistema de agentes no GitHub não é dar mais liberdade ao agente. Trata-se de definir como o trabalho flui no sistema usando funções aplicáveis do GitHub, como pull requests, fluxos de trabalho e regras de repositório. Uma arquitetura bem desenhada garante que cada ação do agente deixa um registo visível, é validada por sinais objetivos e só é aceite quando cumpre os requisitos da política.

Glossary

Termos-chave e definições

Este módulo utiliza um pequeno conjunto de termos recorrentes. As definições abaixo esclarecem como são usadas ao longo do conteúdo.

• Plano (artefacto) Uma descrição estruturada das alterações pretendidas, normalmente incluída numa descrição de pull request. Descreve o objetivo, o âmbito, os passos, os riscos e os critérios de validação do trabalho.

• Planeamento (capacidade de agente) O processo pelo qual um agente gera ou refina um plano com base numa tarefa, problema ou input do utilizador. Isto pode ocorrer em diferentes pontos de entrada, como um problema no GitHub ou na interface dos Agentes.