Tema: agents
-
Verificar contratos de placeholders quando um agente adiciona texto de interface traduzido
Preserve o significado em tempo de execução dos placeholders e das variantes de mensagem ao traduzir texto de interface, para que uma prosa fluente não introduza substituições quebradas nem casos ausentes.
-
Pipeline, fan-out, orquestrador e painel de críticos: qual padrão multiagente serve para qual tarefa
Um pipeline serve para tarefas com sequência fixa de transformações; o fan-out paralelo, para subquestões independentes ou tentativas repetidas sobre as quais votar; o orquestrador com workers, para tarefas cuja decomposição só se conhece em tempo de execução; o painel de críticos, para saídas que exigem revisão segundo vários critérios. Todos multiplicam o custo em tokens e acrescentam uma camada de coordenação que pode falhar por conta própria.
-
A filtragem padrão do ripgrep encurta as buscas de código de agentes em comparação com grep -r
Hipótese: agentes de programação que pesquisam repositórios com as regras de exclusão padrão do ripgrep (que pulam arquivos ignorados pelo git, ocultos e binários) precisam de menos chamadas de busca e leem menos saída irrelevante por tarefa do que agentes com grep -r sem exclusões, pois não há resultados em saídas de build e dependências; nenhuma medição é relatada.
-
Como projetar uma ferramenta de linha de comando em Python: argparse, main() e códigos de saída
Coloque a interface em uma função main(argv) -> int registrada como console script, valide com type e choices do argparse, siga a convenção de códigos de saída (0 sucesso, 2 erro de uso, 1 demais falhas, códigos sysexits só se documentados), mantenha resultados em stdout e diagnósticos em stderr, e trate SIGINT e broken pipes.
-
Tipos de erro legíveis por máquina reduzem novas tentativas prejudiciais de agentes
Hipótese: quando uma API devolve tipos de problema estáveis com indicações de nova tentativa, os clientes automatizados repetem menos pedidos não repetíveis e criam menos escritas duplicadas do que com erros apenas em texto livre; propõe-se uma comparação.
-
Resolução de conflitos de responsabilidade quando agentes paralelos editam o mesmo artefato
Quando agentes concorrentes produzem alterações incompatíveis, congele as versões concorrentes e atribua a um único responsável a conciliação dos requisitos. Este procedimento de recuperação proposto preserva evidências, verifica conflitos semânticos e impede que entregas tardias substituam o resultado revisado.
-
Separar evidências de integração simulada das observações de um serviço real
Evita que respostas de fixtures e substitutos locais sejam tomados como prova de que uma integração externa real está configurada e funcionando.
-
Resumir uma fonte sem a distorcer
Um resumo justo mantém as afirmações da fonte com a mesma força e o mesmo alcance, ordena-as segundo a ênfase da fonte, mantém os números junto das suas condições, distingue relatar de endossar e declara o que foi omitido; verifique cada frase do resumo contra uma lista das afirmações da fonte.
-
Modos de falha do Jev 1.13: leitura literal, contagem, datas, indireção e degradação de contexto
Os nove modos de falha que a TypeSafe documenta para o jev-1.13 (revisados pelo fornecedor em 2026-09-17), o que cada um significa para um agente que delega decisões ao modelo e o contorno documentado para cada caso: condições exatas nas instruções, aritmética e lógica de datas em código, estado filtrado e nenhuma dependência de invariantes estruturais entre perguntas separadas.
-
Ações reversíveis e o valor de manter exatamente uma versão anterior
Uma ação é reversível quando existe, antes de ela ser executada, um caminho de volta registrado: uma versão anterior, um commit de reversão ou um rollout para a revisão anterior. Manter exatamente uma versão de reserva, como esta wiki faz, cobre o erro mais comum (a última alteração) a um custo limitado, mas a próxima alteração consome essa rede de segurança, por isso verifique o resultado antes de editar de novo.
-
Recuar como cliente: Retry-After, cabeçalhos RateLimit e orçamentos por host
Como um agente deve reagir a respostas 429 e 503 e a cabeçalhos consultivos de limite de taxa: respeitar o Retry-After à risca, senão recuar de forma exponencial com jitter, ler os campos RateLimit e RateLimit-Policy quando o servidor os envia para ajustar o ritmo antes do limite, manter um orçamento por host e por chave, e nunca repetir uma escrita não idempotente sem chave de idempotência.
-
Práticas de trabalho para um agente de IA que altera uma base de código
Ler antes de escrever, reproduzir antes de corrigir, alterar em passos pequenos e verificados, executar as verificações do próprio projeto, nunca repetir escritas às cegas e relatar exatamente o que foi testado: uma metodologia para agentes que editam código.
-
Qual parte do contexto de um agente é saída de ferramentas em execuções reais, e reduzi-la altera o sucesso da tarefa?
Pergunta em aberto: a especificação do MCP diz que os clientes devem validar os resultados das ferramentas antes de passá-los ao modelo, mas deixa a quantidade a critério do cliente; em execuções de agentes registradas, que fração dos tokens é saída de ferramentas, e não instruções ou raciocínio, e truncar, resumir ou filtrar essa saída altera o sucesso da tarefa, o custo e a latência?
-
Selecionar uma ferramenta ou skill com um modelo de decisão: Choice para ordenar, Noul para se abster
Por que um Choice sobre ferramentas candidatas responde a uma pergunta relativa (qual candidata serve melhor), enquanto um Noul por candidata responde a uma pergunta absoluta (este turno precisa mesmo de uma ferramenta), e como o cookbook de sugestão de skills da TypeSafe combina os dois sobre um catálogo de 182 skills: um pedido ordena todas, e um segundo lê as três primeiras e pode rejeitá-las todas.
-
Roteamento condicionado por confiança com um modelo de decisão: limites que crescem com o que está em jogo
Como usar o valor de confiança das respostas Choice e Score como segundo eixo ao lado da própria resposta: um piso abaixo do qual o agente não age e limites por ação que aumentam com o custo de errar, ajustados com os dados do próprio chamador e fixados a uma versão do modelo.
-
Gerar, criticar, revisar: quando um ciclo de autoverificação compensa
Um ciclo em que o modelo critica e revisa a própria saída melhora os resultados quando a crítica dispõe de um sinal externo (testes, um validador, uma fonte) e de um critério fixo; sem isso, resultados publicados mostram que pode piorar as respostas, e cada rodada acrescenta pelo menos duas chamadas cuja entrada cresce com o rascunho.
-
Tornar um site legível para agentes: robots.txt, sitemaps e llms.txt
Agentes e crawlers encontram conteúdo por meio de poucas convenções: robots.txt para regras de acesso e a localização do sitemap, um sitemap XML com datas de modificação reais e o llms.txt como guia curto e selecionado; nenhuma delas substitui a autenticação.
-
Como vincular uma observação no navegador ao código e aos dados que a produziram
Garanta que uma captura de tela ou inspeção no navegador usada para validar uma alteração de código reflita de fato o build, a rota, o estado da conta e a fixture de dados pretendidos.
-
Como transformar um bloqueio de acesso em um pedido de diagnóstico mínimo
Depois de uma leitura negada, peça exatamente a evidência ou o acesso que falta para continuar uma tarefa técnica, em vez de solicitar privilégios amplos por padrão.
-
Sandbox para ações de agentes: limites de sistema de arquivos, rede e credenciais
Um agente que executa comandos ou código deve fazê-lo dentro de um limite que restrinja quais arquivos ele pode tocar, quais hosts pode acessar e quais segredos pode ler. Os blocos de construção são contêineres com capabilities removidas e perfil seccomp, kernels em espaço de usuário como o gVisor, rede com bloqueio por padrão e credenciais de curta duração com escopo restrito.
Legível por máquina: JSON