[{"data":1,"prerenderedAt":800},["ShallowReactive",2],{"insight-insights_pt-getting-cited-by-chatgpt-and-claude":3,"insight-related-insights_pt-getting-cited-by-chatgpt-and-claude":169},{"id":4,"title":5,"author":6,"blobHue":10,"body":11,"category":144,"date":145,"description":17,"draft":146,"extension":147,"featured":146,"headline":148,"hue":149,"letter":150,"meta":151,"navigation":152,"path":153,"readMinutes":154,"related":155,"seo":159,"stem":160,"summary":161,"toc":162,"__hash__":168},"insights_pt\u002Finsights\u002Fgetting-cited-by-chatgpt-and-claude.md","Ser citado pelo ChatGPT e pelo Claude",{"name":7,"role":8,"bio":9},"André","Fundador e CTO","O André é o fundador e CTO da WizardingCode. Oito anos a construir o software em que as empresas assentam, agora a pôr agentes em produção.",null,{"type":12,"value":13,"toc":135},"minimark",[14,18,21,26,29,32,35,39,80,86,90,93,100,103,109,112,116,119,122,125,129,132],[15,16,17],"p",{},"Cada vez mais pesquisas de produto começam com uma pergunta ao ChatGPT, ao Claude ou a outro assistente, e não numa caixa de pesquisa. “Que camisa de linho aguenta bem as lavagens?” “Esta liquidificadora faz muito barulho?” O assistente responde num parágrafo e, às vezes, diz de onde tirou a resposta. A pergunta é se essa fonte és tu.",[15,19,20],{},"A otimização para motores generativos é o trabalho de fazer da tua página a fonte citada. Não é um truque novo. Na maior parte, é escrever páginas de produto como falaria um bom vendedor de loja: com clareza, com precisão e sem esconder os factos.",[22,23,25],"h2",{"id":24},"como-um-motor-de-respostas-lê-a-tua-página","Como um motor de respostas lê a tua página",[15,27,28],{},"Um motor de pesquisa ordena páginas. Um motor de respostas monta uma resposta com pedaços de páginas, e cita os pedaços em que confia. Isso muda o que é uma boa página.",[15,30,31],{},"Prefere frases que se podem tirar do contexto e continuam a fazer sentido. Prefere um facto dito uma vez, com clareza, a um facto sugerido por adjetivos. Prefere fontes que dão sempre o mesmo nome às coisas, para ter a certeza de que o produto da tua página é o mesmo de que fala uma análise. E lê a estrutura: títulos, listas, tabelas e dados estruturados ajudam-no a encontrar o pedaço de que precisa.",[15,33,34],{},"Nada disto substitui o SEO clássico. Uma página que não está indexada, que é lenta ou sem links a apontar para ela nem sequer é lida. Pensa nisto como um chão e um teto: os motores de pesquisa são o chão, os motores de respostas são o teto.",[22,36,38],{"id":37},"seis-hábitos-das-páginas-que-são-citadas","Seis hábitos das páginas que são citadas",[40,41,42,50,56,62,68,74],"ol",{},[43,44,45,49],"li",{},[46,47,48],"strong",{},"Diz os factos às claras."," Material, dimensões, peso, cuidados, compatibilidade, garantia, origem. Em frases, com unidades, e não só numa imagem com a tabela de especificações.",[43,51,52,55],{},[46,53,54],{},"Escreve parágrafos com forma de resposta."," Abre cada secção com a resposta direta numa frase, e explica depois. A primeira frase é a que tem mais hipóteses de ser citada.",[43,57,58,61],{},[46,59,60],{},"Junta perguntas e respostas reais."," Usa as perguntas que os clientes fazem de facto, tiradas de tickets de suporte e de avaliações. Cada uma com uma resposta curta e completa.",[43,63,64,67],{},[46,65,66],{},"Cria páginas de entidade."," Uma página para a marca e uma para cada categoria, a dizer o que são, para quem são e em que se distinguem. Os motores de respostas usam-nas para perceber onde encaixa um produto.",[43,69,70,73],{},[46,71,72],{},"Usa dados estruturados."," Marcação de produto, oferta, avaliação e perguntas frequentes que bata certo, palavra a palavra, com o texto visível. Uma marcação que contradiz a página faz mais mal do que nenhuma.",[43,75,76,79],{},[46,77,78],{},"Mantém os nomes iguais."," O mesmo nome de produto, de marca e de categoria na página, no feed, na marcação e em todas as línguas.",[81,82,83],"blockquote",{},[15,84,85],{},"Escreve a frase que gostavas que um assistente citasse sobre ti.",[22,87,89],{"id":88},"um-parágrafo-de-produto-antes-e-depois","Um parágrafo de produto, antes e depois",[15,91,92],{},"A maioria dos catálogos está cheia de parágrafos assim:",[15,94,95,99],{},[96,97,98],"em",{},"Antes:"," “Descobre um estilo descontraído com a nossa camisa icónica. Feita com tecidos premium para um conforto que dura o dia inteiro, é a peça perfeita para qualquer guarda-roupa. Eleva o teu visual nesta estação.”",[15,101,102],{},"Não há nada que um assistente possa citar. Nem material, nem corte, nem cuidados. Nada que responda a uma pergunta.",[15,104,105,108],{},[96,106,107],{},"Depois:"," “Esta camisa é feita de 100% linho europeu, com corte descontraído e bainha direita, pensada para usar por fora das calças. Pode lavar-se na máquina a 30 °C e fica mais macia a cada lavagem. Veste o tamanho habitual; se estiveres entre dois tamanhos, escolhe o mais pequeno para um corte mais justo.”",[15,110,111],{},"A segunda versão não perde encanto. Ganha utilidade, e cada frase responde a uma pergunta que alguém já fez. (A camisa e os detalhes são uma ilustração, não um produto real.)",[22,113,115],{"id":114},"fazer-isto-para-milhares-de-produtos","Fazer isto para milhares de produtos",[15,117,118],{},"Escrever assim à mão funciona para dez produtos. Não funciona para um catálogo que muda todas as semanas.",[15,120,121],{},"No sistema de marketplace que construímos, um estúdio de produto escreve os textos de produto, categoria, marca e página, com conteúdo para SEO e para pesquisa com IA, em quatro línguas. Trabalha a partir dos dados do fornecedor e do catálogo, não da imaginação. As páginas de entidade de marca e de categoria saem da mesma forma, por isso os nomes batem certo em todo o lado.",[15,123,124],{},"Uma pessoa continua a rever o que vai para o ar. O trabalho do estúdio é tornar a versão cuidada a versão por defeito, não publicar sem ninguém olhar.",[22,126,128],{"id":127},"o-que-não-controlas","O que não controlas",[15,130,131],{},"Ninguém decide o que um assistente cita. Os modelos mudam, as fontes variam e a mesma pergunta pode ter respostas diferentes em dias diferentes. Quem te promete uma posição no ChatGPT está a prometer algo que não controla.",[15,133,134],{},"O que controlas é se as tuas páginas merecem ser citadas. Testa os teus produtos principais da forma mais simples: faz aos assistentes as perguntas que os teus clientes fazem, e vê de quem são as frases que aparecem. Se não forem tuas, a correção costuma estar na página.",{"title":136,"searchDepth":137,"depth":137,"links":138},"",2,[139,140,141,142,143],{"id":24,"depth":137,"text":25},{"id":37,"depth":137,"text":38},{"id":88,"depth":137,"text":89},{"id":114,"depth":137,"text":115},{"id":127,"depth":137,"text":128},"engineering","2026-07-28",false,"md","Ser citado pelo ChatGPT e pelo ==Claude.==","blue","G",{},true,"\u002Finsights\u002Fgetting-cited-by-chatgpt-and-claude",4,[156,157,158],"cart-recovery-with-agents-notes-from-our-own-store","build-buy-or-both","every-agent-needs-a-judge",{"title":5,"description":17},"insights\u002Fgetting-cited-by-chatgpt-and-claude","Cada vez mais clientes perguntam ao ChatGPT antes de comprar. Como escrever páginas de produto que os assistentes citam: factos, perguntas reais, entidades.",[163,164,165,166,167],{"id":24,"label":25},{"id":37,"label":38},{"id":88,"label":89},{"id":114,"label":115},{"id":127,"label":128},"fIj4oC8g60VPeMNIkMcrMAUlAx3hS8_GNhvOCHLOOc4",[170,361,613],{"id":171,"title":172,"author":173,"blobHue":10,"body":174,"category":340,"date":341,"description":178,"draft":146,"extension":147,"featured":146,"headline":342,"hue":343,"letter":344,"meta":345,"navigation":152,"path":346,"readMinutes":154,"related":347,"seo":351,"stem":352,"summary":353,"toc":354,"__hash__":360},"insights_pt\u002Finsights\u002Fcart-recovery-with-agents-notes-from-our-own-store.md","Recuperar carrinhos com agentes: notas da nossa própria loja",{"name":7,"role":8,"bio":9},{"type":12,"value":175,"toc":333},[176,179,182,186,189,192,196,199,202,222,225,229,232,235,239,242,245,320,324,327,330],[15,177,178],{},"O nosso fundador também gere um marketplace de moda. Construímos o Agentic OS dele como construímos o de qualquer cliente, dentro do próprio CRM: 90 agentes em oito departamentos, cada equipa verificada por um juiz. A recuperação de carrinhos é um dos sítios onde os dados já lá estavam e o problema era evidente. As pessoas enchem um carrinho, e depois a vida acontece.",[15,180,181],{},"Estas notas contam o que mudou, o que medimos e o que não resultou. Deixámos de fora receitas e percentagens, de propósito. Dependem da época, do catálogo e do tráfego. Sem esse contexto, um número dizia-te menos do que o método.",[22,183,185],{"id":184},"de-onde-partimos","De onde partimos",[15,187,188],{},"Antes dos agentes, a recuperação de carrinhos era como na maioria das lojas: uma sequência fixa. Um email ao fim de algumas horas, outro no dia seguinte, às vezes um desconto no terceiro. As mesmas palavras para toda a gente, na língua da loja, fosse o que fosse que o cliente tinha estado a ver.",[15,190,191],{},"Funcionava. Só não falava com ninguém em particular, e os resultados mostravam isso.",[22,193,195],{"id":194},"uma-pessoa-uma-mensagem","Uma pessoa, uma mensagem",[15,197,198],{},"A primeira mudança a sério foi escrever cada mensagem para a pessoa que deixou o carrinho. Todas as noites, o sistema atualiza o perfil de cada comprador: uma persona, um risco de deixar de comprar e uma próxima melhor ação. O agente de recuperação lê esse perfil, o carrinho e o histórico do cliente antes de escrever uma linha.",[15,200,201],{},"Isso muda três coisas.",[40,203,204,210,216],{},[43,205,206,209],{},[46,207,208],{},"Momento."," Um cliente que costuma comprar ao fim da noite não recebe o lembrete às nove da manhã. Quem volta dentro de uma hora é deixado em paz durante algum tempo.",[43,211,212,215],{},[46,213,214],{},"Canal."," Email, SMS, push ou WhatsApp, conforme o que essa pessoa autorizou e aquilo a que já respondeu antes. Não todos os canais, nem o mais barulhento.",[43,217,218,221],{},[46,219,220],{},"Tom."," Quem chega pela primeira vez e um cliente com anos de encomendas não recebem a mesma mensagem. O primeiro precisa de ser tranquilizado quanto a tamanhos e devoluções. O segundo precisa de um lembrete curto, na língua dele, sobre as peças que escolheu.",[15,223,224],{},"Um juiz verifica as mensagens: os factos sobre o produto e a política têm de bater certo com o catálogo e com a memória partilhada, e o tom tem de ser o da marca.",[22,226,228],{"id":227},"vouchers-só-dentro-dos-limites","Vouchers, só dentro dos limites",[15,230,231],{},"A forma mais fácil de recuperar um carrinho é oferecer dinheiro. É também a forma mais fácil de perder margem numa venda que talvez acontecesse de qualquer maneira.",[15,233,234],{},"Por isso, o agente de recuperação pode propor um voucher, mas só dentro dos limites que a equipa comercial definiu. E só depois de um travão de margem o verificar. Esse travão é código simples, não um modelo. Calcula o mínimo de cada produto depois de devoluções, comissões e envio, e veta tudo o que fica abaixo. Nenhum agente escreve um preço. Um voucher é uma ferramenta para uma pessoa concreta, não uma regra por defeito.",[22,236,238],{"id":237},"uma-proposta-por-semana-um-veredicto-28-dias-depois","Uma proposta por semana, um veredicto 28 dias depois",[15,240,241],{},"Uma vez por semana, o sistema propõe formas de recuperar mais: mudar o momento para um segmento, experimentar outro canal, ajustar o texto, apertar ou alargar uma regra de vouchers. Uma pessoa revê cada proposta e decide se a aplica.",[15,243,244],{},"Depois vem a parte que mais nos importa. Cada alteração aplicada é medida 28 dias depois, face ao que acontecia antes. Não na manhã seguinte, quando qualquer mudança parece boa ou má por acaso. Vinte e oito dias chegam para ver se os clientes voltaram mesmo e compraram. E se as encomendas se aguentaram depois de chegarem as devoluções.",[246,247,248,264],"table",{},[249,250,251],"thead",{},[252,253,254,258,261],"tr",{},[255,256,257],"th",{},"PASSO",[255,259,260],{},"QUEM",[255,262,263],{},"QUANDO",[265,266,267,281,294,307],"tbody",{},[252,268,269,275,278],{},[270,271,272],"td",{},[46,273,274],{},"Propor uma alteração",[270,276,277],{},"O agente de recuperação",[270,279,280],{},"Todas as semanas",[252,282,283,288,291],{},[270,284,285],{},[46,286,287],{},"Aprovar ou rejeitar",[270,289,290],{},"Uma pessoa da equipa comercial",[270,292,293],{},"Antes de alguma coisa mudar",[252,295,296,301,304],{},[270,297,298],{},[46,299,300],{},"Medir o resultado",[270,302,303],{},"O sistema, face à referência",[270,305,306],{},"28 dias depois de entrar em vigor",[252,308,309,314,317],{},[270,310,311],{},[46,312,313],{},"Manter, mudar ou abandonar",[270,315,316],{},"A mesma pessoa",[270,318,319],{},"Depois da medição",[22,321,323],{"id":322},"o-que-não-resultou","O que não resultou",[15,325,326],{},"Nem todas as propostas se aguentam. Algumas alterações não fizeram diferença mensurável ao fim de 28 dias, e cortámo-las. É para isso que se mede: sem medição, ainda estariam ativas, e nós ainda acreditaríamos nelas.",[15,328,329],{},"Um perfil só vale o histórico que tem por trás. Para quem visita a loja pela primeira vez há pouco em que pegar, e a mensagem fica mais perto da genérica do que gostaríamos. Assumimos esse limite às claras, em vez de o tapar com palpites.",[15,331,332],{},"E uma mensagem melhor não resolve um mau motivo para sair. Se um carrinho fica abandonado por causa dos portes, de um tamanho esgotado ou de uma política de devoluções confusa, o certo é corrigir a loja. Às vezes, o resultado mais útil do agente de recuperação nem é uma mensagem. É um padrão para alguém ir ver.",{"title":136,"searchDepth":137,"depth":137,"links":334},[335,336,337,338,339],{"id":184,"depth":137,"text":185},{"id":194,"depth":137,"text":195},{"id":227,"depth":137,"text":228},{"id":237,"depth":137,"text":238},{"id":322,"depth":137,"text":323},"case-notes","2026-08-11","Recuperar carrinhos com agentes: notas da nossa própria ==loja.==","sun","R",{},"\u002Finsights\u002Fcart-recovery-with-agents-notes-from-our-own-store",[348,349,350],"testing-a-campaign-on-customers-who-dont-exist","what-agents-should-never-do-alone","getting-cited-by-chatgpt-and-claude",{"title":172,"description":178},"insights\u002Fcart-recovery-with-agents-notes-from-our-own-store","Momento, canal e tom. O que mudou quando cada mensagem de carrinho abandonado passou a ser escrita para uma pessoa, e o que não resultou.",[355,356,357,358,359],{"id":184,"label":185},{"id":194,"label":195},{"id":227,"label":228},{"id":237,"label":238},{"id":322,"label":323},"iyjjPEk-4pFcTmVQtDAgWrxMc3IcYqi857bFBH_1iEE",{"id":362,"title":363,"author":364,"blobHue":10,"body":365,"category":592,"date":593,"description":369,"draft":146,"extension":147,"featured":146,"headline":594,"hue":595,"letter":596,"meta":597,"navigation":152,"path":598,"readMinutes":154,"related":599,"seo":603,"stem":604,"summary":605,"toc":606,"__hash__":612},"insights_pt\u002Finsights\u002Fbuild-buy-or-both.md","Construir, comprar ou ambos?",{"name":7,"role":8,"bio":9},{"type":12,"value":366,"toc":585},[367,370,373,377,380,387,394,400,403,407,410,436,439,443,446,452,458,538,541,546,550,553,556,560,582],[15,368,369],{},"Provavelmente já pagas por alguma ferramenta de IA. Todas as empresas com quem falamos pagam. Um assistente de escrita aqui, uma ferramenta que resume reuniões ali, um chatbot no site. A pergunta raramente é se deves usar IA. É que trabalho merece mais do que uma subscrição.",[15,371,372],{},"A resposta honesta: a maior parte não merece. E a parte que merece costuma precisar das duas coisas, o que se compra e o que se constrói.",[22,374,376],{"id":375},"quando-comprar-chega","Quando comprar chega",[15,378,379],{},"Uma ferramenta pronta a usar é a escolha certa quando três coisas são verdade.",[15,381,382,383,386],{},"O trabalho é ",[46,384,385],{},"genérico",". Resumir uma reunião, reescrever um email, traduzir um documento, fazer a primeira versão de um anúncio de emprego. Todas as empresas o fazem mais ou menos da mesma forma, por isso um produto feito para todos serve-te bem.",[15,388,389,390,393],{},"Não precisa de ",[46,391,392],{},"dados reais",". A entrada é o que a pessoa cola lá, e o resultado volta para essa pessoa. Nada tem de sair do teu ERP nem de entrar no teu CRM.",[15,395,396,399],{},[46,397,398],{},"Ninguém responde por um resultado."," Torna as pessoas mais rápidas, mas nenhuma equipa se comprometeu a fazer mexer um número com ela. Se piorar no mês seguinte, alguém muda de ferramenta e nada se parte.",[15,401,402],{},"Para este tipo de trabalho, construir uma de raiz é deitar dinheiro fora. Compra a ferramenta, define regras sensatas sobre que dados lá entram, e segue em frente.",[22,404,406],{"id":405},"quando-um-processo-merece-um-agente-próprio","Quando um processo merece um agente próprio",[15,408,409],{},"Tudo muda quando o trabalho passa pelos teus sistemas e pelas tuas regras. Um processo merece um agente próprio quando:",[40,411,412,418,424,430],{},[43,413,414,417],{},[46,415,416],{},"Vive nos teus sistemas."," O agente tem de ler a encomenda, o histórico de tickets, o ficheiro do fornecedor ou a tabela de preços, e escrever de volta neles.",[43,419,420,423],{},[46,421,422],{},"Há um número."," Tempo de primeira resposta, horas perdidas em papelada, stock por vender. Uma equipa responde por ele e quer vê-lo mexer.",[43,425,426,429],{},[46,427,428],{},"Há decisões que precisam de uma pessoa."," Reembolsos, promessas, tudo o que não se pode desfazer. Pedem regras de aprovação feitas à medida da tua empresa, não da empresa que um fornecedor imaginou.",[43,431,432,435],{},[46,433,434],{},"É só teu."," As tuas políticas, as tuas exceções, o teu tom, aquilo que só a Maria sabe. Uma ferramenta genérica não sabe nada disto, e não lho consegues ensinar como deve ser.",[15,437,438],{},"Nenhum produto vendido a toda a gente faz as quatro coisas por ti. Não conhece os teus sistemas, não pode responder pelo teu número, e as regras dele são de outra pessoa.",[22,440,442],{"id":441},"o-padrão-ambos","O padrão “ambos”",[15,444,445],{},"Na prática, para a maioria dos processos que importam, a resposta é ambos.",[15,447,448,451],{},[46,449,450],{},"Compras o que é comum."," Os próprios modelos de linguagem, dos grandes fornecedores. Alojamento, envio de email, pesquisa, a canalização. Ninguém devia construir um modelo próprio para responder a emails de fornecedores.",[15,453,454,457],{},[46,455,456],{},"Constróis o que é teu."," Os agentes, as regras de aprovação e a memória partilhada. É aí que vivem o teu processo, as tuas políticas e o teu critério. É essa parte que separa uma demo de um sistema em que podes confiar.",[246,459,460,472],{},[249,461,462],{},[252,463,464,466,469],{},[255,465],{},[255,467,468],{},"COMPRAR",[255,470,471],{},"CONSTRUIR",[265,473,474,487,499,512,525],{},[252,475,476,481,484],{},[270,477,478],{},[46,479,480],{},"Modelos",[270,482,483],{},"Aos fornecedores de modelos",[270,485,486],{},"Nunca",[252,488,489,494,497],{},[270,490,491],{},[46,492,493],{},"Infraestrutura",[270,495,496],{},"Alojamento, email, armazenamento",[270,498,486],{},[252,500,501,506,509],{},[270,502,503],{},[46,504,505],{},"Agentes",[270,507,508],{},"Raramente servem",[270,510,511],{},"Construídos à volta do teu processo",[252,513,514,519,522],{},[270,515,516],{},[46,517,518],{},"Regras de aprovação",[270,520,521],{},"Configurações genéricas",[270,523,524],{},"Escritas com a tua equipa",[252,526,527,532,535],{},[270,528,529],{},[46,530,531],{},"Memória partilhada",[270,533,534],{},"Vazia até a preencheres",[270,536,537],{},"As tuas políticas, histórico e decisões",[15,539,540],{},"Esta divisão também te protege. Os modelos melhoram e os preços mudam de poucos em poucos meses. Se os agentes, as regras e a memória são teus, trocar o modelo por baixo é uma tarefa de engenharia, não uma migração. O sistema de marketplace que construímos usa modelos de vários fornecedores ao mesmo tempo, cada um escolhido para a sua tarefa. E não depende de nenhum em particular.",[81,542,543],{},[15,544,545],{},"Compra o modelo. Constrói a parte que conhece o teu negócio.",[22,547,549],{"id":548},"de-quem-é-o-quê","De quem é o quê",[15,551,552],{},"Construas o que construíres, pergunta de quem é no fim. Nos nossos projetos a resposta é simples. Os agentes correm no teu ambiente e a memória está nos teus sistemas. O código, os prompts e os dados são teus, por isso podes pô-los a correr sem nós.",[15,554,555],{},"Isto importa mais do que parece. Se um processo assenta num agente que não é teu, outra empresa pode mudar-lhe o preço, alterá-lo ou desligá-lo.",[22,557,559],{"id":558},"um-teste-rápido","Um teste rápido",[561,562,564],"prose-checklist",{"title":563},"Antes de comprares mais uma ferramenta de IA, pergunta",[565,566,567,570,573,576,579],"ul",{},[43,568,569],{},"Precisa de ler ou escrever nos teus sistemas reais?",[43,571,572],{},"Há um número que uma equipa tem de mexer com ela?",[43,574,575],{},"Há decisões lá dentro que têm de ficar com uma pessoa?",[43,577,578],{},"Depende de políticas, exceções ou de um tom que são só teus?",[43,580,581],{},"Se o fornecedor mudasse o preço ou o produto amanhã, algum processo parava?",[15,583,584],{},"Se todas as respostas forem não, compra. Se duas ou mais forem sim, o processo provavelmente merece um agente próprio. Construído sobre modelos comprados, com regras e memória que são tuas.",{"title":136,"searchDepth":137,"depth":137,"links":586},[587,588,589,590,591],{"id":375,"depth":137,"text":376},{"id":405,"depth":137,"text":406},{"id":441,"depth":137,"text":442},{"id":548,"depth":137,"text":549},{"id":558,"depth":137,"text":559},"strategy","2026-08-04","Construir, comprar ou ==ambos?==","violet","?",{},"\u002Finsights\u002Fbuild-buy-or-both",[600,601,602],"what-an-agentic-os-is-and-what-it-isnt","why-95-percent-of-ai-pilots-never-reach-production","the-30-day-playbook-week-by-week",{"title":363,"description":369},"insights\u002Fbuild-buy-or-both","Quando basta uma ferramenta de IA pronta a usar, e quando o teu processo merece um agente só dele. Um teste de cinco perguntas.",[607,608,609,610,611],{"id":375,"label":376},{"id":405,"label":406},{"id":441,"label":442},{"id":548,"label":549},{"id":558,"label":559},"yWyzOC0EsBnqZzlKrYr2y9I9aGOPajrA4EhNDUjBinM",{"id":614,"title":615,"author":616,"blobHue":10,"body":617,"category":144,"date":784,"description":621,"draft":146,"extension":147,"featured":146,"headline":785,"hue":149,"letter":786,"meta":787,"navigation":152,"path":788,"readMinutes":154,"related":789,"seo":790,"stem":791,"summary":792,"toc":793,"__hash__":799},"insights_pt\u002Finsights\u002Fevery-agent-needs-a-judge.md","Cada agente precisa de um juiz",{"name":7,"role":8,"bio":9},{"type":12,"value":618,"toc":777},[619,622,625,629,632,635,638,642,645,713,716,719,723,726,746,749,753,756,759,762,767,771,774],[15,620,621],{},"Um modelo de linguagem é ótimo a parecer que tem razão. É esse o problema. Uma resposta com o valor de reembolso errado soa tão segura como uma com o valor certo. E quem passa os olhos por uma fila de rascunhos não a apanha sempre.",[15,623,624],{},"Por isso não pedimos às pessoas que a apanhem. No sistema de marketplace que construímos, 90 agentes trabalham em oito departamentos, e cada equipa tem um juiz: 9 juízes ao todo. Um juiz é um segundo modelo com uma única tarefa: verificar a resposta de outro agente antes de alguém confiar nela.",[22,626,628],{"id":627},"porquê-um-segundo-modelo","Porquê um segundo modelo",[15,630,631],{},"Pedir ao mesmo modelo que reveja o próprio trabalho ajuda menos do que pensas. Tende a concordar consigo mesmo. E tem os mesmos pontos cegos que causaram o erro.",[15,633,634],{},"Por isso os nossos juízes correm numa família de modelos diferente da dos agentes que verificam. Treino diferente, hábitos diferentes, erros diferentes. Se dois modelos sem relação entre si concordam que uma resposta assenta nos dados e cumpre as políticas, isso vale muito mais do que um modelo a concordar duas vezes consigo próprio.",[15,636,637],{},"Um juiz também lê a resposta com outros olhos. O agente estava a tentar ajudar. O juiz só procura o que está errado. Uma tarefa estreita e mais nada para fazer: é isso que o torna útil.",[22,639,641],{"id":640},"bloquear-ou-avaliar-depois","Bloquear ou avaliar depois",[15,643,644],{},"Há duas formas de pôr um juiz no caminho. Escolher entre elas é a principal decisão de desenho.",[246,646,647,659],{},[249,648,649],{},[252,650,651,653,656],{},[255,652],{},[255,654,655],{},"BLOQUEAR E REPARAR",[255,657,658],{},"ENVIAR, DEPOIS AVALIAR",[265,660,661,674,687,700],{},[252,662,663,668,671],{},[270,664,665],{},[46,666,667],{},"Quando o juiz corre",[270,669,670],{},"Antes de a resposta sair",[270,672,673],{},"Depois de ter saído",[252,675,676,681,684],{},[270,677,678],{},[46,679,680],{},"Se falhar",[270,682,683],{},"Volta uma vez com os motivos, depois sai com reservas",[270,685,686],{},"Assinalada, contada, usada nas lições seguintes",[252,688,689,694,697],{},[270,690,691],{},[46,692,693],{},"Custo para o utilizador",[270,695,696],{},"Alguns segundos a mais",[270,698,699],{},"Nenhum",[252,701,702,707,710],{},[270,703,704],{},[46,705,706],{},"Serve para",[270,708,709],{},"Tudo o que um cliente vê, tudo o que mexe em dinheiro",[270,711,712],{},"Muito volume, pouco risco, fácil de corrigir",[15,714,715],{},"No caminho que bloqueia, uma resposta chumbada não é deitada fora. Volta ao agente uma vez, com os motivos do juiz, e o agente tem uma hipótese de a corrigir. Se a versão corrigida voltar a falhar, sai assinalada com as reservas do juiz. Ou, quando as regras o exigem, vai para uma pessoa. Nada sai sem veredicto.",[15,717,718],{},"No caminho que avalia depois, a resposta sai e o juiz dá-lhe nota a seguir. As notas mostram onde um agente se desvia e alimentam as lições que o sistema aprende durante a noite. Essas lições não se aplicam sozinhas: uma pessoa aprova cada uma antes de os agentes a usarem.",[22,720,722],{"id":721},"o-que-um-juiz-verifica","O que um juiz verifica",[15,724,725],{},"Um juiz com uma instrução vaga (“esta resposta é boa?”) é ruído caro. Os nossos verificam coisas concretas, e cada verificação pode falhar sozinha:",[561,727,729],{"title":728},"O que um juiz verifica, sempre",[565,730,731,734,737,740,743],{},[43,732,733],{},"Cada número da resposta vem de dados que o agente leu de facto nesta execução?",[43,735,736],{},"Contradiz alguma política da memória partilhada?",[43,738,739],{},"Responde por inteiro à pergunta que foi feita?",[43,741,742],{},"Propõe alguma ação que as regras de aprovação não permitem?",[43,744,745],{},"O tom é o certo para quem a vai ler?",[15,747,748],{},"A primeira verificação é a que mais importa. Um valor de reembolso, uma data de entrega ou um número de stock que não aparece em nenhum resultado das ferramentas conta como inventado. Por mais plausível que pareça.",[22,750,752],{"id":751},"quanto-custa-e-quando-dispensá-lo","Quanto custa, e quando dispensá-lo",[15,754,755],{},"Um juiz é mais uma chamada a um modelo em cada resposta. Gasta mais tokens e, no caminho que bloqueia, mais uns segundos. Numa resposta a um cliente, é um seguro barato. Noutros trabalhos, é desperdício.",[15,757,758],{},"Dispensamos o juiz, ou passamo-lo para avaliação posterior, quando o resultado tem pouco em jogo, se pode desfazer e é fácil de verificar. Uma sugestão de etiqueta interna que uma pessoa vê de qualquer maneira não precisa de um segundo modelo à frente. Um rascunho que alguém edita sempre antes de enviar também não.",[15,760,761],{},"Também nunca pedimos a um modelo que verifique o que o código consegue verificar. Um preço acima do mínimo, uma data no futuro, uma encomenda que existe: são perguntas determinísticas. Têm respostas determinísticas, mais rápidas e sem opiniões.",[81,763,764],{},[15,765,766],{},"Um juiz serve para julgar. Se uma regra cabe em código, escreve-a em código.",[22,768,770],{"id":769},"falhar-à-vista-não-em-silêncio","Falhar à vista, não em silêncio",[15,772,773],{},"Os juízes também falham. Excedem o tempo limite, ou o fornecedor do modelo vai abaixo durante uns minutos. O pior que um sistema pode fazer nesse momento é fingir que a verificação aconteceu.",[15,775,776],{},"Quando um juiz não consegue correr, a resposta aparece com uma marca visível de “não validada”. Quem a lê decide se confia nela. Uma aprovação silenciosa parece inofensiva. É assim que um sistema perde a confiança de quem trabalha com ele. E essa confiança custa muito mais a recuperar do que um tempo limite custa a corrigir.",{"title":136,"searchDepth":137,"depth":137,"links":778},[779,780,781,782,783],{"id":627,"depth":137,"text":628},{"id":640,"depth":137,"text":641},{"id":721,"depth":137,"text":722},{"id":751,"depth":137,"text":752},{"id":769,"depth":137,"text":770},"2026-09-01","Cada agente precisa de um ==juiz.==","J",{},"\u002Finsights\u002Fevery-agent-needs-a-judge",[349,600,348],{"title":615,"description":621},"insights\u002Fevery-agent-needs-a-judge","Porque pomos um segundo modelo à frente de cada resposta antes de alguém confiar nela. E quando o juiz não vale o que custa.",[794,795,796,797,798],{"id":627,"label":628},{"id":640,"label":641},{"id":721,"label":722},{"id":751,"label":752},{"id":769,"label":770},"-WLGVX3562I9dAdmmmG7-O4u5MEXxbwYHE9xfCkGCk0",1790618465890]