🧩 Nos, arestas e estado

Um no pode ser um agente de IA, uma chamada de modelo, um pedaco de codigo comum ou ate uma decisao humana no meio do fluxo. A pergunta que voce precisa fazer antes de desenhar qualquer no e simples: isso aqui precisa de IA de verdade? Nem sempre a resposta e sim.

Um no deterministico — um if, uma query num banco, um script que so formata dados — e mais barato, mais rapido e mais confiavel do que jogar tudo pro modelo. A regra que a industria convergiu: codigo controla o roteamento previsivel, modelo cuida do que exige interpretacao ou julgamento.

O que olhar: as cinco caixinhas ciano dentro do no. Cada uma delas pode ser diferente em cada no do seu grafo — e por isso elas ficam dentro da caixa, nao espalhadas pelo sistema. As duas setas de saida ja mostram o que o topico 2 vai destrinchar: e la, na aresta, que a condicao mora.

Uma aresta condicional — a que carrega um "se" — e onde mora o roteamento: "se aprovado siga, se reprovado volte". Isso e exatamente o que separa um grafo de uma fila. Se todas as suas arestas sao incondicionais (sempre vao pro mesmo lugar seguinte), voce nao escreveu um grafo — escreveu um pipeline disfarcado.

O que olhar: as duas setas saindo do validador vao pra lugares diferentes, dependendo de uma condicao. E essa bifurcacao — nao a quantidade de nos — que faz esse desenho ser um grafo. Se so existisse a seta verde, seria so um pipeline de tres passos.

O que exatamente passa de um no pro outro? Essa pergunta parece pequena, mas define metade do sucesso do seu grafo. O state schema — o formato acordado do que viaja pelas arestas — e um contrato, e contrato se escreve, nao se improvisa.

Passar a conversa inteira de um no pro outro parece seguro, mas anula o ganho de contexto limpo: o proximo no volta a ver como o trabalho foi feito, nao so o que foi produzido — e isso enche o contexto dele de ruido. Passar de menos faz o no seguinte trabalhar as cegas, sem o dado que ele precisava.

Modelo, ferramentas, permissoes, instrucoes e teto de custo (o limite maximo que aquele no pode gastar antes de ser interrompido) podem ser diferentes em cada no. Modelo forte no passo dificil e barato no facil; ferramenta de escrita so no no que escreve; acesso a internet so em quem pesquisa.

Essa configuracao por no e o que da valor economico real ao grafo — e onde o custo cai de verdade. Um sistema que usa o mesmo modelo caro em todo passo, so porque "e mais simples configurar uma vez", esta queimando dinheiro em passos que um modelo barato resolveria igual.

Um grafo de um no so, com todas as ferramentas e todas as instrucoes, girando ate acabar: isso e loop reinventado, e a estrutura de grafo nao esta fazendo nada por voce. Voce pagou a complexidade de "pensar em grafo" e nao colheu nenhum dos beneficios — configuracao por no, custo diferenciado, roteamento condicional.

Teste pratico: se voce nao consegue dar configuracoes diferentes a dois nos do seu desenho, provavelmente voce nao precisava de dois nos. Junte-os. Um grafo degenerado desse tipo nao e "errado" — ele so nao e um grafo, e um loop com um desenho bonito por cima.

O que olhar: a equacao nao tem "menos loop" em lugar nenhum — ela tem loop mais loop mais um ingrediente novo, o estado explicito que viaja entre eles (o que voce viu no topico 3). Um grafo de um no so, sem essa composicao, e so um loop se fingindo de grafo.

No grande demais e o grafo nao ajuda em nada — voce voltou pra caixa preta de um orquestrador unico fazendo tudo. No pequeno demais e voce paga sobrecarga de coordenacao em cima de trabalho trivial — mais arestas, mais estado pra passar, mais chance de erro, pra ganho nenhum.

Regra pratica: um no por mudanca de contexto, de ferramenta ou de responsabilidade. Se dois passos usam o mesmo contexto e as mesmas ferramentas, provavelmente sao um no so. Se um passo muda de "escrever" pra "validar", isso e mudanca de responsabilidade — dois nos.

{
  "nos": {
    "escritor": {
      "modelo": "<modelo-medio>",
      "ferramentas": ["escrever_arquivo"],
      "teto_custo_usd": 0.05
    },
    "validador": {
      "modelo": "<modelo-forte>",
      "ferramentas": [],
      "teto_custo_usd": 0.02
    },
    "formatador": {
      "modelo": null,
      "ferramentas": ["script_deterministico"],
      "teto_custo_usd": 0.00
    }
  },
  "arestas": [
    { "de": "escritor", "para": "validador", "quando": "sempre" },
    { "de": "validador", "para": "formatador", "quando": "resultado_valido == true" },
    { "de": "validador", "para": "escritor", "quando": "resultado_valido == false" }
  ]
}