FUNDAMENTOS · AGENT INFRASTRUCTURE · 03
Orquestração
A camada que coordena o que acontece entre objetivo, modelo, tools, estado e resultado.
8 min de leituraAgentes precisam de um runtime, não apenas de prompts.
Orquestração controla como tarefas avançam ao longo do tempo. Ela gerencia estado, seleção de ações, retries, timeouts, handoffs, aprovação humana e encerramento.
Em sistemas simples, essa lógica pode estar em código. Em sistemas mais complexos, frameworks ou plataformas ajudam a estruturar workflows e execução agêntica.
RUNTIME
Estado e continuidade
Execuções reais não acontecem sempre em uma única chamada. Elas podem esperar uma API, uma pessoa, outro agente ou um evento externo.
Mantém contexto operacional entre etapas.
Repete operações quando falhas recuperáveis acontecem.
Transfere responsabilidade para outro agente ou humano.
Define quando a execução terminou, falhou ou deve ser interrompida.
DESIGN
Determinístico e agêntico podem coexistir
Parte do fluxo pode ser explícita e outra parte delegada ao agente. Isso permite controlar etapas críticas sem perder capacidade de adaptação.
Boa orquestração maximiza clareza, não autonomia.
RESILIÊNCIA
Falhas são parte do fluxo
APIs podem ficar indisponíveis, modelos podem retornar saídas inválidas e pessoas podem não responder. A arquitetura precisa prever compensação, fallback e recuperação.
Orquestração madura trata exceções como comportamento esperado.
NA PRÁTICA
Processo com várias etapas
Exemplos de tecnologias: LangGraph, Amazon Bedrock Agents, CrewAI e workflows/código próprio. Elas têm escopos diferentes e não são equivalentes.
ARQUITETURA DE REFERÊNCIA
Arquitetura de execução resiliente
Exemplo ilustrativo: um agente de contas a pagar recebe uma solicitação, consulta o ERP, verifica limites e duplicidades e prepara a operação. A liberação financeira ocorre somente após validação determinística e aprovação humana, quando exigida pela política.
DECISÕES DE ARQUITETURA
Workflow determinístico ou agente?
Use código e regras explícitas para cálculos, limites, autorizações e etapas reguladas. Use decisões assistidas por modelo quando houver interpretação de linguagem, seleção contextual de ferramentas ou investigação aberta. Combine os dois com contratos de entrada e saída.
OPERAÇÃO E GOVERNANÇA
Resiliência e observabilidade
Defina idempotência, retries com backoff, timeouts, filas de falha, checkpoints e compensações para operações irreversíveis. Registre trace por execução, versão de prompts, chamadas de ferramentas, custo, latência e motivo de intervenção.
CONTINUE APRENDENDO
Conceitos relacionados
PRINCÍPIO
Orquestração transforma decisões isoladas em execução confiável ao longo do tempo.
FONTES E LEITURAS
Referências técnicas
Documentação e publicações para aprofundar os conceitos apresentados. Links externos são oferecidos como referência, não como endosso de fornecedores.