Quando um agente de IA deve pedir esclarecimento antes de usar uma tool?
Defina quando um agente de IA deve pedir esclarecimento, usar um default seguro ou parar antes da tool, com estado tipado e testes de retomada.
|
Eu sou Samuel Fajreldines Sou especialista em todo o ecossistema JavaScript e TypeScript (incluindo Node.js, React, Angular e Vue.js) Sou especialista em IA e na criação de soluções integradas com IA Sou especialista em DevOps e Arquitetura Serverless (AWS, Google Cloud e Azure) Sou especialista em PHP e seus frameworks (como Codeigniter e Laravel). |
|
Samuel Fajreldines Sou especialista em todo o ecossistema JavaScript e TypeScript (incluindo Node.js, React, Angular e Vue.js) Sou especialista em IA e na criação de soluções integradas com IA Sou especialista em DevOps e Arquitetura Serverless (AWS, Google Cloud e Azure) Sou especialista em PHP e seus frameworks (como Codeigniter e Laravel).
|
Inteligência Artificial
58 artigos · guias e tutoriais práticos por Samuel Fajreldines
Artigos aprofundados sobre Inteligência Artificial, guias práticos e tutoriais por Samuel Fajreldines — 58 posts especializados sobre Inteligência Artificial para engenheiros de software.
Artigos em Inteligência Artificial
Como usar circuit breaker nas tools de um agente de IA
Aprenda a proteger tools de agentes de IA com circuit breaker: diferencie retry de falha persistente, abra o circuito e teste a retomada sem sleep.
Como testar aprovação humana em agentes de IA
Teste aprovação humana em agentes de IA: confirme que a tool espera, rejeita sem efeitos e executa uma vez quando o payload aprovado continua igual no runtime.
Como testar prompt injection em um agente de IA antes de produção
Aprenda a testar prompt injection em um agente de IA com fixtures sintéticas, critérios de falha, tool calls observáveis e efeitos reais bloqueados.
Como fazer replay de um agente de IA sem executar tools reais
Aprenda a gravar uma execução de agente, substituir respostas de modelo e tools por fixtures e detectar divergências sem disparar efeitos reais.
Como escrever descrição de tools para agentes de IA
Aprenda a escrever nomes, descrições e parâmetros de tools para agentes de IA escolherem a ferramenta certa, evitarem ambiguidades e pedirem dados faltantes.
Dead-letter queue para agentes de IA que falham sempre
Entenda como separar tarefas de agentes de IA que falham repetidamente, preservar evidências e decidir entre corrigir, retomar ou fazer redrive com segurança.
Como validar a saída de um agente de IA antes de salvar?
Valide a saída de um agente de IA em quatro fronteiras: formato, significado, autoridade e efeito confirmado antes de gravar o resultado.
O que registrar no log de auditoria de um agente de IA?
Defina o que registrar em um log de auditoria de agente de IA: identidade, autoridade, tool calls, aprovações, bloqueios e efeitos externos verificados.
Como criar um handoff entre agentes de IA com contexto estruturado
Projete handoffs entre agentes de IA com estado, evidência, autoridade e recuperação, sem copiar o histórico inteiro ou confiar em um resumo vago.
Como rastrear tool calls de um agente de IA com OpenTelemetry
Crie um trace útil para agentes de IA: ligue execução, modelo, tool calls, retries e erros sem registrar prompts e dados sensíveis por padrão em produção.
Compactação de contexto em agentes: o que preservar antes de continuar
Entenda o que um agente pode resumir, o que precisa persistir fora do histórico e como verificar a tarefa depois da compactação.
Como verificar se uma tool call teve efeito antes de repetir
Aprenda a verificar o efeito de uma tool call após timeout ou resposta perdida, registrar recibos e repetir ações sem criar duplicatas.
Como pausar e retomar um agente de IA sem reiniciar a tarefa?
Aprenda a pausar e retomar agentes de IA com checkpoints, estado durável, aprovação revalidada e reconciliação de efeitos externos após uma interrupção.
Como transmitir o progresso de um agente de IA para a interface?
Aprenda a transmitir o progresso de um agente de IA para a interface com eventos tipados, SSE ou WebSockets, reconexão, aprovação e estado final confiável.
Como evitar loop infinito em um agente de IA?
Evite loop infinito em agentes de IA combinando 4 barreiras: conclusão, progresso, orçamento e um estado terminal que o runtime consiga explicar em produção.
Como evitar tool calls duplicadas no fallback de LLM?
Defina retry, fallback e parada para chamadas de LLM sem repetir tool calls, perder o contrato de saída ou esconder custo, latência e efeitos parciais.
Como testar a trajetória de um agente de IA?
Aprenda a avaliar a trajetória de um agente de IA: registre tools, argumentos, ordem, estado e intervenções antes de aceitar apenas a resposta final.
Quando um agente de IA deve pedir aprovação humana?
Saiba quando um agente de IA deve pausar para aprovação humana, como classificar tools por risco e como retomar a execução sem duplicar efeitos.
Como definir um orçamento de tokens para um agente de IA
Aprenda a limitar tokens, tool calls e turnos por execução de agentes de IA com uma guarda em TypeScript que para antes da próxima chamada e registra a parada.
Como cancelar um agente de IA quando uma tool trava?
Aprenda a combinar AbortSignal, timeout por etapa e limite de turnos para cancelar agentes de IA com segurança e evitar retries inseguros após efeitos externos.
Prompt caching para agentes de IA com tool calls
Estruture tools, system e histórico para acertar cache hits em cada tool step. Meça cached tokens, evite invalidar o prefixo e reduza custo de input no loop.
Portfólio de software engineer com IA: o que provar
Monte um portfólio de software engineer com IA que mostre problema, arquitetura, testes, operação, falhas e decisões, não apenas uma demo gerada por agente.
Memória de agentes de IA: Graphiti, RAG vetorial ou PostgreSQL?
Compare Graphiti, RAG vetorial e PostgreSQL para memória de agentes de IA. Separe verdade, recuperação, histórico e verificação antes do prompt no sistema.
Validação de tool calls em TypeScript para agentes de IA
Valide tool calls de agentes de IA em TypeScript com Zod, erros estruturados, output seguro e retry limitado antes de tocar na sua API.
Habilidades de engenharia de software para coding agents
Descubra quais habilidades de engenharia de software continuam valiosas com coding agents: especificação, arquitetura, contexto, revisão, evals e operação.
Como configurar code review com IA no GitHub Actions
Configure code review com IA no GitHub Actions usando Codex, permissões mínimas e jobs separados. Inclui YAML, verificação, erros e limites.
Como criar um servidor MCP em TypeScript para agentes de código
Crie um servidor MCP em TypeScript, teste no Inspector e conecte a Claude Code e Codex com esquemas, limites de saída e ferramentas somente leitura.
Sandbox do agente acaba quando o host confia no arquivo
Em 2026, a Pillar publicou 7 escapes em 4 agentes; proteja host, Git, IDE, hooks, Docker e CI quando o agente escreve arquivos confiáveis no workspace.
Quando o agente escreve migration, o banco precisa dizer não
Em 2026, 84% dos devs usam ou planejam usar IA; veja como revisar migration de agente no CI com dry-run, lint e rollback antes de chegar ao banco real.
Sem telemetria, agente de código vira caixa-preta
Em 2026, GitHub relatou 60 milhões de revisões com Copilot; veja como criar observabilidade de agentes de código no CI com JSONL, OTel e prova segura.
Comentário de PR não é contexto confiável para agente
Em 2026, GitInject documentou 11 ataques em 4 provedores; proteja agentes no GitHub Actions contra prompt injection em PRs com sandbox e segredos mínimos.
O patch do agente passou; o produto ainda quebrou
Em 2026, TDAD reduziu regressões de teste em 70%; monte evals de regressão para agentes de código com impacto, CI e prova de PR.
RAG de codebase só ajuda quando o agente sabe perguntar
Em 2025, Cursor mediu 12,5% mais acerto com busca semântica; monte RAG sobre codebase com grep, símbolos, MCP e prova no PR.
O PR do agente morre quando vira trabalho de revisor
Em 2026, estudo analisou 33.596 PRs agentic no GitHub; reduza abandono, duplicidade, escopo amplo e CI quebrado antes de pedir revisão humana mais segura.
Quando o EDR confunde agente com invasor
Em 2026, a Sophos viu acesso a credenciais em 56,2% dos bloqueios de agentes; ajuste EDR, permissões e CI sem liberar segredos.
O custo invisível do contexto em agentes de código
Em 2026, a Systima mediu cerca de 33 mil tokens antes do prompt no Claude Code; monte orçamento de contexto, MCP e subagentes com prova auditável no CI.
Friendly Fire faz o agente de segurança rodar o ataque
Em 2026, a AI Now mostrou RCE em Claude Code e Codex ao revisar repo de terceiros; isole permissões, sandbox, rede e CI com prova auditável no PR seguro.
Seu agente pode clonar um repo que nunca existiu
Em 2026, o arXiv mediu até 85% de alucinação ao clonar repos; veja como travar origem, MCP e CI antes do agente executar.
GhostApproval mostra onde o diff mente para o agente
Em 2026, a Wiz testou 6 assistentes de código; aprenda a revisar symlink, sandbox e aprovação antes que o agente escreva fora do workspace.
Repositório desconhecido precisa de quarentena de agente
Em 2026, a 0DIN mostrou payload fora do repo; use quarentena de agente com sandbox, rede negada e segredos fora do setup.
MCP com allowlist segura agentes de código
Em 2026, pesquisa MCP achou 57 ameaças; monte allowlist por ferramenta, registro privado, CI e logs para agentes de código.
Quando o CI devolve a falha para o agente
Monte loop self-correcting de agente no CI com logs curtos, sandbox, limite de tentativas e prova de PR revisável sem abrir diffs amplos nem perder controle.
Spec executável deixa agente de código obedecer
Em 2026, GitLab mediu 85% vendo revisão como gargalo; use spec executável para fazer agentes de código provarem cada mudança.
Agentjacking via Sentry muda o risco dos agentes
Em 2026, Tenet relatou 2.388 organizações expostas; trate eventos Sentry via MCP como input hostil antes de deixar Codex ou Claude Code agir.
Hooks seguram agentes de código antes do estrago
Claude Code documenta 3 cadências de hooks; use gates antes, depois e no fim do loop para reduzir risco real em agentes de código, MCP, shell local e CI.
AGENTS.md enxuto deixa o agente gastar contexto melhor
Em 2026, estudo mediu custo acima de 20% com contexto ruim; escreva um AGENTS.md enxuto para Codex e Claude Code testar melhor no CI sem inflar tokens.
Fan-out de subagentes para migrar código sem perder controle
Em 2026, 85% veem revisão e validação como gargalo; use fan-out de subagentes para migrar monorepos com prova, worktrees e evidência clara no PR final.
MCP de codebase RAG para agentes que não leem tudo
Em 2026, mais de 1 em 5 revisões no GitHub já passa pelo Copilot; use MCP de codebase RAG para dar contexto sob demanda aos agentes.
Evals de PR que seguram agentes de código no CI
Em 2026, GitHub já viu 60 milhões de revisões com Copilot; monte evals de PR no CI para validar agentes antes do revisor.
Context engineering para agentes de código sem desperdício
Em 2025, a DORA mediu 90% de adoção de IA em times de software; monte contexto enxuto para agentes de código trabalharem melhor.
O gargalo dos agentes de código é a revisão
Em 2026, 85% dos devs citam revisão, edição e teste de código com IA como gargalo. Veja um harness prático para PRs confiáveis, com gates, MCP e subagentes.
Claudiomiro: Como Alcançar 100% de Codificação Autônoma (Complexa)
Claudiomiro é uma CLI com IA que executa autonomamente o ciclo de vida completo do desenvolvimento de software: análise de bases de código, planejamento e…
Criando um Sistema de Grafo de Conhecimento Nativo com MongoDB, S3 e LangChain
Um guia prático para construir um sistema de grafo de conhecimento nativo com MongoDB, S3 e LangChain que vincula entidades e relacionamentos para dar ao AI…
Construindo um Agente de IA para Fitness com LangChain.js: Uma Implementação Real
Mergulho profundo na implementação de um agente de IA fitness pronto para produção com LangChain.js: ferramentas estruturadas, prompting adequado e recuperação…
Dominando o Langchainjs para Coordenar Chamadas de Ferramentas e Funções com Agentes de IA
Descubra como o Langchainjs orquestra chamadas de ferramentas e funções com o paradigma chain-of-thought, com um exemplo prático de app de fitness.
Memória de Longo Prazo para IA: Como o Graphiti Funciona para Construir Aplicações Realmente Inteligentes
Um mergulho profundo no Graphiti, o framework open-source de grafo de conhecimento temporal da Zep, com um blueprint completo para construir um Coach…
Por Que Contratei o ChatGPT Pro (US$200/Mês) como Meu Desenvolvedor Júnior
Saiba como contratar o ChatGPT Pro como desenvolvedor júnior a US$200/mês transformou meu fluxo de trabalho de engenharia de software, aumentando produtividade…
