ANATOMIA DE UMA EXECUÇÃO

Veja como um sistema agêntico trabalha.

Um agente não recebe uma pergunta e simplesmente gera uma resposta. Em produção, uma execução envolve identidade, contexto, planejamento, skills, ferramentas, políticas, aprovações, tratamento de falhas, avaliações, evidências e monitoramento.

Acompanhe uma execução completa, do pedido ao resultado.

DO PEDIDO À ENTREGA

Menos de 20% da execução acontece dentro do modelo.

Selecione uma etapa para ver o que acontece nela, ou execute a sequência completa. O diagrama mostra as camadas envolvidas; o trace à direita registra a execução conforme ela avança.

CASO DEMONSTRATIVO Exemplo ilustrativo

OBJETIVO

Comparar propostas e preparar uma recomendação de compra

ENTRADA

Três propostas, requisitos da contratação e políticas da empresa

ENTREGA

Comparativo estruturado, riscos, should cost e recomendação pronta para aprovação

Exemplo demonstrativo. Tempos, valores e resultados exibidos nesta página são ilustrativos.

DO PEDIDO À ENTREGA

EXECUÇÃO PROC-2847 · COMPARAR PROPOSTAS

1 Entrada2 Identidade3 Planejamento4 Especialistas5 Execução6 Controle7 Validação8 Entrega

A entrada é validada antes de qualquer raciocínio.

01EXPERIÊNCIACanal · Web · APIpedido, documento ou eventoEntrega validadaartefato com evidência citada
02ORQUESTRAÇÃOIdentidade + contextopermissões e estado · contexto autorizadoPlannerplano e dependências · critérios de conclusãoOrquestradordelega e acompanha · contrato por delegaçãoEstado + checkpointretoma do ponto exato · sem repetir etapas
03ESPECIALISTASCASCATA DE AGENTES E SKILLSAgente documental · extrai campos e cita a fonteAgente financeiro · normaliza preços e should costAgente de risco · fornecedor, condições e lacunasTool Use · MCPA2A · Computer Usestructured output validadoEvaluator + revisorqualidade e evidência · aprova ou devolve etapa
04CONTROLEFila de exceçõesmotivo · SLA · responsável · retoma do checkpointMotor de políticasautoriza · limita · bloqueia · guardrails e alçadasAprovação humanaacima da alçada do agente · decisão registrada
05SISTEMAS DO CLIENTEAMBIENTE DO CLIENTE · FRONTEIRA DE CONFIANÇAERPCRMSAPAPIs internasLegadosBancos de dados
06CAMADAS PERMANENTES · ATUAM EM TODAS AS ETAPASObservabilidade · Evaluations · FinOps · Auditoria · Segurança e identidade do agente · Governança · Multi-tenancy

ETAPA 01 DE 08

A entrada é validada antes de qualquer raciocínio.

O pedido, documento ou evento é recebido, verificado e convertido em uma estrutura que pode ser processada. Nada é enviado ao modelo antes disso.

O QUE ACONTECE

  • Receber pedido, documento ou evento
  • Criar identificador da execução
  • Verificar arquivos e formatos
  • Identificar empresa e ambiente
  • Verificar dados obrigatórios
  • Registrar a entrada e iniciar o estado

ETAPA 01 DE 08

Exemplo ilustrativo

ESTADO DA EXECUÇÃO

EXECUÇÃO

PROC-2847

STATUS

Preparando

OBJETIVO

Comparar propostas

DOCUMENTOS

3 recebidos

POLÍTICA

Compras de tecnologia

PRÓXIMA ETAPA

Identidade
TRACE DA EXECUÇÃO
10:02:01 Caso recebido — 3 documentos
FLUXO DE EXECUÇÃOFLUXO DE DADOSAPROVAÇÃO E RETOMADAEXCEÇÃOFRONTEIRA DE CONFIANÇAETAPA ATIVACONTROLE

VISÃO COMPLETA

Dez movimentos em uma única execução.

01

Entrada

Canal, interface web, API ou evento inicia o trabalho.

02

Identidade

Usuário, agente, empresa, permissões e contexto autorizado.

03

Planejamento

Objetivo dividido em etapas, dependências e critérios.

04

Especialização

Skills e agentes assumem responsabilidades delimitadas.

05

Execução

Ferramentas consultam dados, processam documentos e atuam.

06

Controle

Políticas e guardrails autorizam, bloqueiam ou escalam.

07

Exceções

Falhas, ausência de dados e baixa confiança têm caminho definido.

08

Validação

Evaluators e revisores verificam qualidade e conclusão.

VISÃO COMPLETA

09

Entrega

Resultado publicado, registrado e encaminhado ao responsável.

10

Evolução

Feedback, correções e métricas alimentam melhoria governada.

Camadas permanentes: Segurança · Observabilidade · Evaluations · FinOps · Auditoria · Governança

ONDE A EXECUÇÃO COMEÇA

O agente pode trabalhar onde o processo já acontece.

Interface conversacionalO usuário descreve o que precisa, responde perguntas e acompanha a execução por chat."Compare estas três propostas com os requisitos da contratação e prepare uma recomendação para aprovação."
Interface webUma aplicação estruturada recebe dados, documentos, parâmetros e aprovações.Formulário e uploadFila de processosExecução em andamentoAnálise pronta e revisão humanaHistórico e indicadores

ONDE A EXECUÇÃO COMEÇA

APIOutro sistema inicia e acompanha a execução programaticamente."case_id": "PROC-2847", "objective": "compare_proposals", "documents": ["proposal_a", "proposal_b", "proposal_c"], "policy_set": "technology_procurement", "requested_by": "user_184"
EventoUma mudança em outro sistema inicia automaticamente o trabalho.Documento recebidoOportunidade criadaContrato próximo do vencimentoExame disponibilizadoFornecedor atualizadoEtapa de processo concluída
TeamsSlackWhatsAppE-mailPortalAplicação própria

O canal muda. A identidade, o controle e a execução permanecem.

ETAPA 02

O sistema determina quem pode acessar, decidir e executar.

Antes de consultar qualquer dado ou utilizar uma ferramenta, a execução estabelece identidade e autorização.

Identidade do usuárioQuem solicitouQual função exerceQual unidade representaQuais dados pode consultarQuais ações pode aprovar
Identidade do agenteNome técnico e finalidadeProprietário e versãoCredenciais em VaultFerramentas autorizadasLimite de autonomia
Contexto autorizadoDocumentos permitidosMemória visívelPolíticas aplicáveisHistórico relacionadoDados do processo
SUJEITOPODENÃO PODE
Usuário (comprador)Consultar, comparar e recomendarAprovar contratação acima da sua alçada
Agente de procurementLer propostas e consultar benchmarksCriar pedido no ERP sem aprovação

Permissão não é uma instrução no prompt. É um controle externo ao modelo.

ETAPA 03

Um objetivo é transformado em um plano verificável.

Estágio 1 · PrepararValidar documentosIdentificar requisitosCarregar políticaRecuperar benchmark
Estágio 2 · ExtrairExtrair escopoExtrair preçosExtrair condiçõesIdentificar premissas
Estágio 3 · NormalizarPadronizar unidadesAjustar impostosEqualizar perfisTratar itens ausentes

ETAPA 03

Estágio 4 · AnalisarMedir aderênciaCalcular cost breakdownExecutar should costIdentificar riscos
Estágio 5 · RevisarConfrontar evidênciasVerificar consistênciaAvaliar completudeTratar exceções
Estágio 6 · EntregarConstruir comparativoPreparar recomendaçãoSolicitar aprovaçãoRegistrar resultado
O planner defineEtapas e dependênciasParalelismoAgente ou skill responsávelFerramenta necessáriaPolítica aplicávelCritérios de sucessoLimite de tempoLimite de custoCaminho de exceção
PendenteEm execuçãoAguardandoBloqueadoEm revisãoConcluídoFalhou

ETAPA 04

Cada responsabilidade vai para o recurso adequado.

Nem toda atividade precisa de um novo agente. Essa é uma das decisões de arquitetura que mais afeta custo, latência e rastreabilidade.

Quando usar uma skillExiste um método delimitado que pode ser executado dentro do contexto do agente atual.Extrair requisitosCalcular should costAvaliar riscoNormalizar preçosProduzir parecer
Quando usar outro agenteA responsabilidade exige separação real de contexto e controle.Identidade própriaContexto e memória separadosFerramentas específicasPolítica diferenteAvaliação independenteColaboração contínua

Cascata do exemplo

Orquestrador da contratação

Recebe o objetivo, coordena o plano e acompanha a conclusão.

ETAPA 04

Agente documentalClassificar propostaExtrair camposRelacionar evidências
Agente técnicoAvaliar aderênciaIdentificar lacunasComparar arquitetura
Agente financeiroNormalizar preçosExecutar cost breakdownCalcular should cost
Agente de riscoAvaliar fornecedorIdentificar dependênciasAnalisar condições
Agente revisorConfrontar critériosVerificar evidênciasAprovar ou devolver

ETAPA 04

Contratos entre agentes

  • Objetivo
  • Dados de entrada
  • Contexto permitido
  • Formato de saída
  • Prazo
  • Limite de custo
  • Critério de conclusão
  • Política de falha
  • Limite de delegação

Cascata não significa conversa livre entre agentes. Significa delegação estruturada e rastreável.

ETAPA 05

O agente deixa de apenas responder e passa a agir.

Tool Use

  • Consultar ERP
  • Buscar fornecedor
  • Recuperar benchmark
  • Calcular cenário
  • Criar documento
  • Registrar parecer
  • Enviar para aprovação
MCPFerramentas e dados disponibilizados por uma interface padronizada e reutilizável entre agentes.A2A

Agentes diferentes solicitam e entregam trabalho com identidade e contratos definidos.

ETAPA 05

Computer UseQuando não existe API, o sistema opera uma interface autorizada — como último recurso, nunca como padrão.
Structured OutputToda saída destinada a outro sistema é validada antes da execução. Se o schema for inválido, a ação não acontece.
"supplier": "Fornecedor A", "normalized_total": 2450000, "technical_adherence": 0.91, "risk_level": "moderate", "requires_human_approval": true, "evidence_ids": ["EV-104", "EV-226", "EV-318"]

ETAPA 06

Toda ação passa por uma camada de controle.

O modelo pode sugerir uma ação. A política determina se ela pode acontecer.

O motor de políticas avalia

  • Identidade
  • Permissão
  • Ferramenta
  • Tipo de ação
  • Valor
  • Risco
  • Confiança
  • Origem dos dados
  • Evidências
  • Alçada
  • Horário
  • Ambiente

ETAPA 06

Possíveis decisões

AutorizarA execução continua automaticamente.
LimitarA ação continua com escopo, valor ou ferramenta reduzidos.
Solicitar aprovaçãoUma pessoa autorizada recebe contexto e recomendação.
BloquearA ação não atende às políticas.
EncaminharO caso entra na fila de exceções.
InterromperA execução é encerrada de forma segura.
AÇÃO SOLICITADACONFIANÇAALÇADA DO AGENTERESULTADO
Recomendar fornecedor A94% · evidências completasRecomendação permitidaAutorizado
Aprovar contratação de R$ 2,45 milhões94%NenhumaAprovação humana obrigatória

CONTROLE PERMANENTE

Segurança não é uma etapa final.

IdentidadeUsuários, agentes e serviços possuem identidades distintas.
Menor privilégioCada componente acessa somente o necessário para a sua função.
SegredosCredenciais ficam em Vault e não entram no contexto do modelo.
IsolamentoDados, memória e execuções permanecem separados por cliente e ambiente.
Proteção contra instruções externasDocumentos e conteúdos recuperados são tratados como dados, nunca como ordens ao sistema.
Saída validadaNenhuma ação crítica depende de texto livre gerado pelo modelo.
AuditoriaCada acesso, ferramenta, decisão e aprovação permanece registrado.
Red TeamingManipulação, vazamento e uso indevido são testados antes e depois da publicação.

QUANDO O SISTEMA NÃO PODE CONTINUAR

Falhar com controle também é parte da arquitetura.

Um sistema confiável não tenta esconder incerteza nem improvisa diante de situações não previstas.

Uma execução entra na fila quando

  • Falta informação obrigatória
  • Existe documento conflitante
  • A confiança está abaixo do limite
  • Uma política bloqueia a ação
  • Uma integração falha
  • O custo ultrapassa o orçamento
  • Não existe evidência suficiente
  • O caso exige julgamento humano
  • Há comportamento atípico

QUANDO O SISTEMA NÃO PODE CONTINUAR

PRIORIDADECASOMOTIVOETAPARESPONSÁVELSLA
ALTAPROC-2847Valores conflitantesNormalizaçãoComprador2h
ALTAPROC-2851Política bloqueou açãoAprovaçãoGestor1h
MÉDIAPROC-2862Baixa confiançaExtraçãoAnalista4h
BAIXAPROC-2868Fonte indisponívelConsultaTecnologia8h
O responsável recebeContexto do caso e etapa interrompidaExplicação e dados utilizadosEvidências e recomendaçãoOpções permitidasImpacto da decisão
Ações humanas possíveisCorrigir dado ou anexar informaçãoAprovar ou rejeitarEscolher alternativaDevolver ao agenteEncerrar o casoTransformar a situação em uma nova regra

Depois da intervenção, a execução retoma do checkpoint correto — sem repetir o que já estava concluído.

ETAPA 07

Antes de entregar, o sistema verifica se concluiu o trabalho.

Avaliação por etapaCada agente ou skill pode ser avaliado individualmente, com gabarito próprio.
Avaliação do processoO sistema verifica se o objetivo completo foi alcançado, não apenas se cada parte funcionou.

Dimensões possíveis

  • Correção
  • Completude
  • Aderência
  • Fidelidade à fonte
  • Qualidade das citações
  • Seleção de ferramentas
  • Conformidade com políticas
  • Consistência financeira
  • Conclusão da tarefa
  • Formato da entrega

ETAPA 07

Exemplo ilustrativo

Placar da execução do exemplo

Extração

aprovada

Normalização

aprovada com ressalva

Aderência técnica

aprovada

Should cost

aprovada

Cobertura de evidências

97%

Conformidade com políticas

confirmada

Conclusão

pronta para revisão humana
O agente revisor podeAceitarSolicitar correçãoDevolver uma etapaExecutar nova verificaçãoEncaminhar para humanoBloquear a entrega

ETAPA 08

O resultado precisa estar pronto para ser utilizado.

Síntese executivaFornecedor recomendado, justificativa e ressalvas.
ComparativoEscopo, valores, condições, aderência e riscos normalizados.
Should costPremissas, faixas e diferença em relação às propostas.
RiscosLacunas, dependências, exceções e mitigadores.
EvidênciasCada conclusão conectada ao documento e trecho de origem.
Próxima decisãoAprovar, negociar, solicitar informação ou rejeitar.

Registro final da execução

ETAPA 08

StatusPronto para aprovação
Etapas concluídas16 de 16
Exceções resolvidas2
Aprovações pendentes1
Evidências vinculadas38
Custo e tempo da execuçãoregistrados por etapa (valores ilustrativos nesta página)
Versõesagente, skills, modelos e políticas registradas

OBSERVABILIDADE

Cada execução pode ser reconstruída.

Exemplo ilustrativo

Visão de portfólioExecuções iniciadas e em andamentoAguardando humanoConcluídas e com falhaCusto total e tempo médioTaxa de conclusão
Visão de uma execuçãoTimeline e planoAgentes acionados e skills utilizadasFerramentas chamadas e modelos selecionadosContexto recuperado e decisõesPolíticas, aprovações e errosCusto por etapa, evidências e entrega
10:02:01 Caso recebido
10:02:02 Identidade validada
10:02:04 Plano criado — 16 atividades
10:02:07 Três documentos classificados
10:02:18 Extração concluída
10:02:20 Normalização iniciada

OBSERVABILIDADE

Exemplo ilustrativo

10:02:29 Exceção — valor conflitante
10:03:42 Correção humana recebida
10:03:43 Execução retomada
10:04:08 Should cost concluído
10:04:17 Revisor solicitou nova evidência
10:04:25 Evidência recuperada
10:04:31 Avaliações aprovadas
10:04:34 Entrega pronta para aprovação
Monitoramento técnicoDisponibilidade, erros e retriesLatência, filas e timeoutsConsumo e integraçõesModelos e infraestrutura
Monitoramento do trabalhoConclusão e qualidadeTempo por processoIntervenção humana e retrabalhoCusto por entrega e valor produzido

CUSTO POR RESULTADO

Não monitoramos apenas tokens.

A execução registra custo porModeloAgenteSkillFerramentaDocumentoEtapaExecuçãoEntrega concluída
O sistema pode aplicarOrçamento por execuçãoLimite por usuário e por agenteRoteamento de modelosCache e processamento em loteInterrupção por custoAprovação para execuções especiais

O objetivo não é utilizar sempre o modelo mais barato. É usar a combinação com melhor qualidade, risco, tempo e custo para cada decisão.

QUEM RESPONDE PELO SISTEMA

Todo agente precisa de finalidade, proprietário e limite.

Registro do agenteNome e finalidadeDomínioProprietárioVersãoNível de riscoAutonomiaDados permitidosFerramentasPolíticasMétricas
Status do ciclo de vidaHistórico de mudançasRascunhoEm avaliaçãoAprovadoPublicadoMonitoradoSuspensoDescontinuado

Mudanças que exigem avaliação e rollout controlado

ModeloPromptSkillConhecimentoFerramentaPolíticaIntegraçãoThreshold de confiança
Segregação de responsabilidadesQuem constróiQuem validaQuem aprovaQuem publicaQuem monitoraQuem responde por incidentes

COMO O SISTEMA MELHORA

Aprender não significa alterar o próprio comportamento sem controle.

A execução produz sinaisFeedback e correções humanasFalhas e exceçõesResultados e avaliaçõesPadrões de uso e desviosCustos
Que podem gerarNovo exemploCorreção de conhecimentoAlteração de skillNova políticaNovo testeMelhoria de promptAjuste de modeloMudança de arquitetura
ObservarIdentificarProporAvaliarAprovarPublicarMonitorar

Nenhuma correção relevante chega diretamente à produção sem avaliação e versionamento.

UMA EXPERIÊNCIA PARA CADA RESPONSABILIDADE

Três visões do mesmo sistema.

Interface de trabalhoPara quem solicita, acompanha, revisa ou aprova.DemandasExecuçãoPendênciasEntregasEvidênciasAprovações
Console operacionalPara engenharia e operação.TracesFalhas e filasLatênciaCustosModelos e ferramentasDeployments
Console de governançaPara responsáveis, segurança e auditoria.Agentes e proprietáriosVersõesPermissõesPolíticasRiscosAvaliações e alterações

CHECKLIST DE PRODUÇÃO

O que uma execução completa precisa responder.

  • Quem iniciou?
  • Qual agente executou?
  • Com qual identidade?
  • Quais dados foram acessados?
  • Quais fontes foram utilizadas?
  • Qual plano foi criado?
  • Quais agentes e skills participaram?
  • Quais ferramentas foram chamadas?
  • Quais políticas foram aplicadas?
  • Houve aprovação humana?

CHECKLIST DE PRODUÇÃO

  • Quais exceções ocorreram?
  • Como foram resolvidas?
  • O resultado foi avaliado?
  • Quais evidências sustentam a entrega?
  • Quanto custou?
  • Quanto tempo levou?
  • Qual versão produziu o resultado?
  • Quem responde pela operação?

Se o sistema não consegue responder a essas perguntas, ainda não existe rastreabilidade suficiente para uma operação empresarial.

VEJA COMO SERIA NO SEU PROCESSO

Qual execução sua empresa precisa transformar?

Conte-nos o pedido que entra, o trabalho realizado hoje, os sistemas envolvidos e a entrega esperada. Desenhamos a primeira visão da execução e identificamos as competências necessárias para colocá-la em produção. Se o caso ainda precisar ser estruturado, o Assessment aprofunda processo, arquitetura, dados, integrações, riscos, business case e roadmap.