Blank white background with no objects or features visible.

Olá, EMEA! A TrueFoundry está expandindo sua presença pela Europa, Oriente Médio e África. Leia mais. →

Engenharia de Grafos para Agentes de IA: Governe as Conexões

By Boyu Wang

Updated: outubro 7, 2026

Published: agosto 22, 2026

As empresas não governam trabalhos importantes tentando inspecionar cada pensamento de cada funcionário, serviço ou fornecedor. Elas governam as interfaces em torno desse trabalho: quais sistemas podem ser acessados, quais ações precisam de um segundo aprovador, quais credenciais podem ser usadas, quanto pode ser gasto, quais informações podem cruzar uma fronteira e qual registro permanece depois. Agentes de IA precisam do mesmo instinto institucional — com uma adição importante. Modelos ainda precisam de avaliação. Testes e monitoramento dizem como um componente se comporta sob condições definidas; controles em tempo de execução determinam o que esse componente tem permissão para fazer quando conectado a sistemas de produção.

Essa distinção é a maneira mais útil de pensar sobre engenharia de grafos. O termo ainda está surgindo, mas o problema de engenharia já é concreto: um ecossistema de agentes é um grafo de modelos, ferramentas, serviços, fontes de dados, sandboxes, humanos e outros agentes. Cada conexão importante carrega autoridade. A tarefa da empresa não é escolher entre avaliar o nó e governar o grafo. É fazer ambos — e saber qual camada é responsável por qual controle.

Key Takeaways

Key Takeaways

  • Evaluate the node; govern the edges. Model/system evaluation and runtime access control solve different problems and should be designed together.
  • Reachability is not authorization. Hiding or deferring a tool can reduce context and accidental selection; a policy boundary must still decide whether the caller may invoke it.
  • The designed graph and the executed graph are different objects. Architecture diagrams show intent; harness events, gateway traces, IAM records, and downstream logs provide execution evidence.
  • TrueForge is the open execution-loop layer. Its public repo documents MCP tools, skills, sandboxing, human checkpoints, context management, session state, and local/hosted operation under the MIT license.
  • TrueFoundry adds the estate-level policy plane. AI Gateway and MCP Gateway centralize model/tool access, credentials, budgets, rate limits, and gateway-visible observability for traffic routed through them.
  • No single layer sees everything. The orchestrator owns topology; the harness sees the steps it executes; the gateway sees traffic that traverses it; downstream systems remain authoritative for their own side effects.

1. Avalie o Nó; Governe as Conexões

É tentador definir a governança de agentes como uma reação à opacidade do modelo: como o modelo é difícil de inspecionar internamente, governe apenas as interfaces. Isso vai longe demais. A Estrutura de Gestão de Risco de IA do NIST exige avaliação sob condições semelhantes às de implantação antes do uso e monitoramento do comportamento do sistema de IA em produção; a orientação de segurança de agentes da OWASP combina testes adversariais com privilégio mínimo, autorização, aprovações, registro e monitoramento. A postura madura é, portanto, complementar: a avaliação estima o comportamento; os controles de conexão limitam a autoridade.

Edge Policy Note
A model evaluation can tell you what an agent tends to do. An edge policy can constrain what it is allowed to reach, spend, disclose, or change.

A analogia institucional torna-se útil quando é delimitada dessa forma. Uma equipe financeira não confia apenas no julgamento de um funcionário; ela também limita o acesso à conta e exige contra-assinaturas. Um agente de produção não deve confiar apenas nas instruções de prompt; seu tempo de execução e gateways devem tornar as fronteiras sensíveis explícitas e aplicáveis. A analogia não é literal — pessoas e modelos não são o mesmo tipo de ator —, mas os objetivos de controle se alinham surpreendentemente bem.

Institutional Control Mapping Table
Institutional control Agent-estate translation Enforcement / evidence layer
Access review Reachability + authorization: which models, tools, and systems an agent may actually invoke TrueForge resource attachment/discovery narrows what the runtime presents; authorization must still be enforced by application or TrueFoundry AI/MCP Gateway policy for traffic routed through the gateway.
Counter-signature Human checkpoint before a configured sensitive or destructive action TrueForge human checkpoints; additional application policy can add approval requirements at other boundaries.
Need-to-know briefing Bounded context transfer instead of copying every intermediate artifact into every agent TrueForge subagents, deferred tool loading, large-result offloading, and compaction
Clean-room / credential policy Keep generated code and execution environments away from harness credentials TrueForge sandbox-as-a-tool; secrets remain in the harness
Spending authority Cost limits by user, team, model, virtual account, or metadata-defined workload TrueFoundry AI Gateway budget rules
Audit trail Reconstruct the steps and gateway-visible calls that carried a consequential action TrueForge session/events plus TrueFoundry traces, metrics, and downstream system-of-record logs
Mirror diagram comparing institutional governance controls with AI agent edge controls: counter-signature to approval gate, access scope to reachability and authorization, summary transfer to bounded transfer, and audit trail to runtime evidence.
Figura 1: A analogia institucional, corrigida para a fronteira da IA. Controles humanos não mapeiam um para um para software, mas os objetivos de controle rimam: delimitar acesso, controlar consequências, limitar transferências e preservar evidências. A metade que falta está explícita na parte inferior: avalie o nó; governe as conexões. Síntese editorial da TrueFoundry; PNG original.

A descoberta não é uma fronteira de segurança

Essa distinção é importante especialmente para a descoberta de ferramentas. O TrueForge documenta o carregamento de ferramentas adiado e outros mecanismos de engenharia de contexto que mantêm o contexto ativo menor. Isso pode melhorar a qualidade da seleção e reduzir a exposição desnecessária aos esquemas das ferramentas. Ele não não autoriza a chamada por si só. A autorização em nível de ecossistema pertence a uma camada de controle de acesso que resolve o chamador e aplica a política. Os controles de acesso do AI Gateway da TrueFoundry governam o acesso ao modelo para usuários, equipes e aplicações; o Modelo de autenticação e segurança do MCP Gateway resolve separadamente a identidade de entrada, as permissões de ferramentas/servidores e as credenciais de downstream.

2. Grafos Projetados e Grafos Executados são objetos diferentes

Um diagrama de arquitetura é uma declaração de intenção. As evidências de produção são um registro do que o sistema instrumentado realmente observou. Os dois divergem por motivos comuns: uma ferramenta de protótipo permanece conectada, uma rota de fallback é ativada, uma tarefa delegada se ramifica, uma concessão OAuth muda ou um agente segue um caminho que o autor do diagrama não previu. Essa lacuna é onde a governança de grafos se torna operacional, em vez de arquitetural.

Diagram comparing an intended AI-agent graph with an executed graph reconstructed from runtime evidence, showing design-time intent on the left and run-time behavior on the right.
Figura 2: Uma maneira simples de distinguir os dois objetos. O grafo projetado é a arquitetura que você pretendia; o grafo executado é o caminho que a execução realmente utilizou, reconstruído a partir de evidências de tempo de execução, como eventos de harness, aprovações, rastreamentos de gateway e registros de auditoria de downstream. Síntese editorial da TrueFoundry; gráfico original.

Mas dizer que “o grafo real está nos rastreamentos” também é simplista demais. Nenhuma fonte de rastreamento é automaticamente completa. Uma reconstrução útil combina as evidências que cada camada possui:

  • Orquestrador: topologia do grafo, estado do nó, roteamento, novas tentativas, junções e decisões de delegação.
  • Harness: etapas do loop de modelo/ferramenta, uso de sandbox, pontos de verificação de aprovação, estado da sessão e eventos visíveis ao tempo de execução.
  • Gateway: chamadas autenticadas de modelo/MCP, resultados de políticas de acesso, orçamentos/limites de taxa, latência, custo e rastreamentos de solicitação visíveis ao gateway.
  • Sistemas de downstream: registros autoritativos de efeitos colaterais de negócios — a mutação no banco de dados, atualização de ticket, pagamento, implantação ou alteração de permissão que realmente ocorreu.
TrueForge user interface showing an agent steps panel with reasoning-step entries, tool calls, and a sub-agent during a run.
Figura 3: Uma visão de tempo de execução das arestas executadas. A interface do TrueForge expõe as etapas visíveis ao harness — incluindo entradas de etapas de raciocínio, chamadas de ferramentas e um subagente gerado nesta execução. É uma evidência de uma camada, não uma afirmação de que o harness registra sozinho todos os efeitos colaterais de downstream. Imagem de origem do material do produto TrueForge; convertida para PNG.

Portanto, a pergunta de auditoria correta não é “o rastreamento corresponde ao diagrama?”, mas sim “podemos correlacionar a topologia pretendida com evidências suficientes de tempo de execução e do sistema de registro para explicar uma ação consequencial?”. Esse é um padrão muito mais elevado — e mais útil.

3. TrueForge: Mantenha o loop de execução inspecionável

Na camada de harness, a questão de governança é se as decisões operacionais em torno do modelo são visíveis e configuráveis. O repositório público do TrueForge descreve o tempo de execução de forma clara: ele executa o loop de execução do agente através de chamadas de modelo, ferramentas MCP, habilidades, sandboxing, aprovações, gerenciamento de contexto e estado da sessão. O mesmo repositório documenta o sandbox-como-ferramenta com segredos retidos no harness, pontos de verificação humanos, subagentes, carregamento de ferramentas adiado, descarregamento de grandes resultados, compactação e modos local e hospedado. O repositório posiciona explicitamente o modo local como um caminho de avaliação em máquina única, não como uma configuração de produção ou voltada para a internet; o uso compartilhado ou em produção pertence ao modo hospedado. Ele é lançado sob a licença MIT.

Essa abertura é útil por uma questão de governança, não apenas de licenciamento. A disponibilidade do código-fonte torna possível a inspeção e a modificação em nível de implementação. Isso não prova que uma instância implantada seja segura, configurada corretamente ou equivalente a um commit específico; esses aspectos ainda exigem controles operacionais e de cadeia de suprimentos de software. Mas oferece às equipes de plataforma algo que runtimes fechados não podem oferecer: a capacidade de inspecionar o mecanismo de execução no qual precisam confiar e, quando necessário, executá-lo ou modificá-lo por conta própria. O post de lançamento da TrueFoundry, Apresentando o TrueForge, torna esse posicionamento explícito, e Por que os Harnesses de Agentes Devem Ser Abertos declara o compromisso comercial diretamente: mantenha o harness aberto; adicione governança centralizada quando a organização realmente precisar dela.

A maneira mais sólida de promover o TrueForge não é afirmar que ele é dono de todo o grafo. Ele não é. Um orquestrador multiagente arbitrário pode ser dono da topologia acima do harness, e os sistemas conectados mantêm suas próprias semânticas de autorização e auditoria. O papel do TrueForge é mais restrito e mais crível: tornar o loop de execução inspecionável, portátil e governável na fronteira do runtime.

4. TrueFoundry: Adicione o Plano de Política Quando o Conjunto se Torna uma Frota

Um harness pode gerenciar sua própria execução. Um conjunto de agentes cria um segundo problema: credenciais, política de acesso, controles de gastos e evidências começam a se fragmentar entre as equipes. É aí que os gateways da TrueFoundry se tornam a camada complementar.

OGateway de IA fornece uma interface de modelo unificada com controle de acesso centralizado, limitação de taxa, limitação de orçamento e observabilidade. Suas regras de orçamento podem definir gastos por usuário, equipe, modelo, conta virtual ou metadados. O Painel de Métricas agrega atividade de LLM e MCP, custos, erros, roteamento, guardrails e outros sinais operacionais. O MCP Gateway separa a autenticação de entrada, o controle de acesso a ferramentas/servidores e a autenticação de saída, para que os agentes não precisem lidar individualmente com todo o problema de credenciais.

Isso produz uma narrativa de arquitetura limpa:

Layer Ownership and Role Table
Layer What it should own TrueForge / TrueFoundry role
Model and system evaluation Measure behavior under defined conditions before and during deployment Complementary discipline; not replaced by graph governance
Graph / orchestrator Topology, routing, delegation, joins, retries, and graph state Owned by the application or orchestration framework; TrueFoundry does not infer arbitrary graph topology
Harness / execution loop Model-tool loop, context management, sandboxing, approvals, session state, runtime events TrueForge — open-source, MIT-licensed agent harness
Gateway policy plane Centralized model/tool access, credentials, budgets, rate limits, and gateway-visible traces TrueFoundry AI Gateway and MCP Gateway
Downstream systems Authoritative business authorization, side effects, and system-of-record audit evidence Remains the responsibility of the connected enterprise systems; correlate their records with harness/gateway evidence

A mensagem do produto, portanto, não é “a TrueFoundry governa cada aresta em cada grafo”. Isso seria tecnicamente impreciso e estrategicamente mais fraco. A afirmação mais defensável é: O TrueForge oferece um harness aberto para o loop de execução de agentes; os gateways da TrueFoundry podem centralizar políticas e evidências para o tráfego de modelos e MCP que você roteia deliberadamente através deles. O orquestrador e os sistemas downstream permanecem parte da narrativa de controle, que é exatamente como uma infraestrutura séria deve ser descrita.

Boundary Note
Boundary worth stating: a gateway cannot govern traffic that bypasses it, and a harness cannot attest to side effects it cannot observe. Graph governance is an architecture property, not a product checkbox.

5. O Teste de Liderança

Action Audit Note
For any consequential action an agent took, ask five questions: Which edge carried it? Was that edge authorized? What crossed it? Under whose identity or delegated authority? Which records let us prove the answer?

Essas perguntas são deliberadamente mais operacionais do que “qual modelo usamos?”. A escolha do modelo ainda importa — para capacidade, segurança, latência, custo e resultados de avaliação. Mas, uma vez que os agentes podem agir, a superfície de governança se expande. Um conjunto bem gerenciado deve ser capaz de conectar a avaliação pré-implantação com a autorização em tempo de execução e a evidência post-hoc: o que se esperava que o modelo fizesse, o que ele tinha permissão para fazer, o que ele realmente fez por meio de fronteiras instrumentadas e o que o sistema de registro diz que aconteceu.

Esse é o argumento sólido para a engenharia de grafos como uma postura de governança. A novidade não é que as empresas descobriram os grafos de repente. A novidade é que os agentes de IA tornam os controles institucionais familiares programáveis nas bordas do software — e tornam as ações nessas bordas rápidas, repetíveis e suficientemente autônomas para que a governança informal deixe de ser escalável.

Escopo, Método e Divulgações

A TrueFoundry publica este ensaio, mantém o TrueForge e comercializa o AI Gateway e o MCP Gateway aqui discutidos. Portanto, o mapeamento de produtos possui interesse comercial e é declarado como tal. As alegações sobre os produtos nesta revisão limitam-se ao comportamento documentado nas páginas ativas da TrueFoundry ou no repositório público atual do TrueForge. A analogia institucional é um enquadramento editorial, não uma afirmação de que organizações humanas e sistemas de IA são equivalentes. "Engenharia de grafos" continua sendo um termo emergente; o guia corporativo da TrueFoundry, vinculado aqui, discute sua origem e os limites atuais do produto. Este ensaio não afirma que os controles de borda substituem a avaliação de modelos/sistemas, que os rastreamentos são completos por padrão ou que a TrueFoundry governa o tráfego fora das superfícies pelas quais ele flui.

Referências

‍

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
novembro 20, 2026
|
5 min read

AI Gateway Observability for Agents: Oodle on TrueFoundry

Integrations
novembro 20, 2026
|
5 min read

AI Gateway Security for Agents: Straiker on TrueFoundry

No items found.
novembro 18, 2026
|
5 min read

Limites do Claude Code Explicados (Edição 2026)

No items found.
Analyzing how Cloudflare detects MCP traffic
novembro 18, 2026
|
5 min read

How Cloudflare Detects MCP Traffic and Helps Secure It

No items found.
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.
Take a quick product tour
Start Product Tour
Product Tour