GUIA · IA
IA com Laravel: o guia completo
Tudo o que escrevi sobre colocar IA em produção dentro de sistemas Laravel: como chamar LLMs com filas e retries, extrair dados com saídas estruturadas, montar RAG com pgvector, criar agentes que executam ações com segurança e controlar custo e latência.
- Como fazer streaming das respostas do Claude no Laravel com Server-Sent Events Passo a passo para mostrar a resposta do Claude token a token no Laravel: ler o SSE da API com Http::, repassar ao navegador, salvar os tokens e fugir do buffering.
- Streaming do Claude no Laravel com SSE: como mostrar a resposta enquanto é gerada Como repassar o stream da API do Claude até o navegador no Laravel com SSE: parser de eventos, flush, Nginx, desconexão do cliente, erro no meio do stream e registro de tokens.
- Prompt caching do Claude no Laravel: como estruturar o prompt do agente para pagar menos Como usar cache_control da API do Claude num agente de IA em Laravel: onde pôr os breakpoints, o que quebra o cache sem você perceber e como medir a taxa de acerto.
- Como usar prompt caching do Claude no Laravel para baratear o agente de IA Passo a passo para ativar o prompt caching da API do Claude no Laravel com cache_control, organizar o prompt e medir no usage se o cache realmente está sendo usado.
- Batch API do Claude no Laravel: como processar milhares de chamadas pela metade do preço Como usar a Message Batches API do Claude no Laravel para reprocessar milhares de itens com 50% de desconto: envio, polling, leitura do JSONL, reenvio e idempotência.
- Como processar milhares de chamadas ao Claude com a Message Batches API no Laravel Passo a passo para enviar lotes de até 100 mil requisições ao Claude pela Message Batches API no Laravel, acompanhar o status e aplicar os resultados com 50% de desconto.
- Como mascarar CPF e dados pessoais antes de enviar ao Claude no Laravel (LGPD) Detecção com validação de dígito, marcadores reversíveis por conversa e restauração só no servidor: como tirar CPF, e-mail e chave Pix do prompt sem quebrar o agente de IA.
- Como testar código que chama o Claude no Laravel com Http::fake e respostas gravadas Passo a passo para testar integrações com LLM no Laravel sem gastar tokens: Http::fake, fixtures gravadas da API real, detecção de prompt alterado e testes de retry.
- Como ler comprovante de Pix do WhatsApp com Claude no Laravel sem confiar só na imagem O Claude extrai valor, data e ID end-to-end do print do comprovante. Quem decide se o pagamento entrou é o seu código, consultando o PSP pelo E2E ID.
- Como extrair dados de comprovantes Pix em imagem e PDF com Claude no Laravel Tutorial para ler o comprovante Pix que o cliente manda em foto ou PDF com a visão do Claude, validar o E2E ID e casar com o Pix recebido sem confiar no arquivo.
- Como ler comprovantes Pix do WhatsApp com Claude no Laravel e conferir se o dinheiro caiu O Claude extrai valor, data e ID do comprovante Pix em imagem ou PDF. Quem decide se está pago é a conciliação com o Pix que de fato entrou na conta.
- Como extrair dados de comprovantes Pix em PDF e imagem com Claude no Laravel Tutorial para ler comprovantes Pix em PDF ou foto com Claude no Laravel, extrair valor, data e E2E ID em JSON e conferir tudo com regras antes de dar baixa.
- Como validar o JSON do Claude no Laravel e pedir correção quando a validação falha Tutorial: force o Claude a responder por uma ferramenta, valide o JSON com o Validator do Laravel e devolva os erros para ele corrigir, com limite de tentativas e testes.
- Erros no loop do agente de IA no Laravel: is_error, stop_reason e limite de iterações Como tratar falhas de tool, cada stop_reason do Claude e loops infinitos num agente de IA em Laravel, sem derrubar o job nem deixar o cliente sem resposta.
- Como reranquear os resultados do RAG no Laravel com o rerank da Voyage AI Passo a passo para colocar um reranker entre o pgvector e o Claude no Laravel: buscar candidatos, reordenar com a Voyage AI, cortar por score e medir o ganho.
- Conciliação com IA no Laravel: como usar o Claude para casar o que as regras não bateram As regras determinísticas resolvem a maior parte da conciliação. Para a sobra, o Claude propõe o match, o código valida os valores e só o que passa nas checagens é aplicado.
- Human-in-the-loop no Laravel: como o agente de IA pede confirmação antes de agir Ações críticas do agente de IA não devem ser executadas na tool call. Viram uma ação pendente com payload congelado, confirmada por botão no WhatsApp e executada sem passar pelo LLM.
- Como fazer o Claude citar as fontes nas respostas do RAG no Laravel com a Citations API Passo a passo para usar a Citations API do Claude no Laravel: chunks como documentos, parse das citações, notas numeradas, validação do trecho citado e testes.
- Como exigir confirmação humana antes do agente de IA executar ações no Laravel Tutorial para o agente de IA pedir confirmação com código no WhatsApp antes de estornar, cobrar ou cancelar, com pendência no PostgreSQL, expiração e execução idempotente.
- Idempotência em tool calls: como evitar que o agente de IA execute a mesma ação duas vezes no Laravel Retry de job, tool repetida na mesma resposta e o "sim" enviado duas vezes podem fazer o agente agendar ou cobrar em dobro. Veja como blindar tool calls no Laravel.
- Chunking para RAG no Laravel: como dividir documentos sem perder o contexto Tamanho de chunk, overlap, divisão por seção e contextual retrieval com Claude: como quebrar documentos para o RAG achar o trecho certo, com código Laravel e um jeito de medir.
- Como avaliar a busca do RAG no Laravel com golden set, recall@k e MRR Passo a passo para medir se o retrieval do seu RAG traz os trechos certos: golden set, perguntas sintéticas com Claude, recall@k, MRR e um comando Artisan que barra regressões.
- Como revisar PRs de Laravel com Claude Code no GitHub Actions em modo headless Passo a passo para rodar o Claude Code em modo headless no GitHub Actions, revisar o diff de cada PR Laravel só com ferramentas de leitura e comentar o resultado no próprio PR.
- Mensagens picadas no WhatsApp: como agrupar antes de chamar o agente de IA no Laravel Debounce com jobs atrasados, teto de espera e lock por conversa para o agente de IA responder uma vez ao pensamento completo do cliente, e não a cada fragmento.
- Como manter embeddings sincronizados no Laravel com pgvector: reindexação incremental Como atualizar só os trechos que mudaram quando um registro é editado, sem regerar todos os embeddings: hash por chunk, job único na fila, backfill e troca de modelo.
- Como manter embeddings sincronizados no pgvector quando os dados mudam no Laravel Como reindexar só os chunks que mudaram, apagar vetores órfãos, pegar o que os eventos do Eloquent não veem e trocar de modelo de embedding sem derrubar o RAG.
- Como rastrear um agente de IA no Laravel: trace de cada tool call e replay da conversa Log comum não explica por que o agente de IA errou. Veja como gravar traces e spans de cada chamada ao Claude e de cada tool call no PostgreSQL, com redação de LGPD e replay.
- Como monitorar a qualidade do agente de IA em produção no Laravel com LLM-as-judge Passo a passo para amostrar conversas reais do agente de IA, avaliá-las com Claude como juiz, guardar as notas no PostgreSQL e receber alerta quando a qualidade cai.
- Como fazer cache semântico de respostas de LLM no Laravel com pgvector e Redis Passo a passo para reaproveitar respostas do Claude em perguntas parecidas: cache exato no Redis, busca por similaridade no pgvector, limiar calibrado e isolamento por cliente.
- Fallback de LLM no Laravel: como trocar de Claude para OpenAI quando a API cai Como montar uma cadeia de fallback entre Claude e OpenAI no Laravel: quais erros disparam a troca, orçamento de tempo, circuit breaker, prompts portáveis e testes.
- Como rotear chamadas entre Claude Haiku e Sonnet no Laravel e escalar só quando precisa Tutorial para mandar cada pedido ao modelo certo no Laravel: regras fixas, triagem com Haiku, escalada automática para Sonnet e log de cada decisão.
- Como versionar prompts no Laravel: arquivos no repositório, rollout gradual e rollback Prompt é código que muda o comportamento do produto. Veja como versionar prompts de LLM no Laravel com arquivos imutáveis, canário por tenant, métricas por versão e rollback.
- Text-to-SQL com Claude no Laravel: como deixar o lojista consultar as próprias vendas com segurança Pedir SQL ao LLM é tentador e perigoso. Mostro como fazer o Claude preencher uma consulta estruturada validada no Laravel e blindar o PostgreSQL quando o SQL for inevitável.
- Como fazer busca híbrida no Laravel com pgvector e full-text search do PostgreSQL Passo a passo para combinar busca vetorial (pgvector) e full-text do PostgreSQL com Reciprocal Rank Fusion no Laravel e parar de errar siglas, códigos e termos exatos no RAG.
- Como transferir o atendimento do agente de IA para um humano no WhatsApp com Laravel Passo a passo para fazer handoff do agente de IA para um atendente no WhatsApp: regras fixas, tool do Claude, estados da conversa, resumo estruturado e volta ao bot.
- Handoff do agente de IA para humano no WhatsApp: como transferir no Laravel Como decidir a hora de passar a conversa do agente de IA para um atendente, impedir que o bot responda junto com o humano e entregar um resumo estruturado.
- Como medir tokens e limitar o custo de IA por cliente no Laravel Tutorial para registrar o uso de tokens do Claude por cliente, calcular o custo sem float, reservar orçamento no Redis antes da chamada e alertar quando a cota mensal acaba.
- Custo de LLM por cliente no Laravel: como medir tokens e impor cotas por tenant Como registrar o uso de tokens do Claude por cliente, converter em custo sem erro de arredondamento e impor cotas mensais no Laravel com reserva atômica no Redis.
- Como transcrever áudios do WhatsApp com OpenAI no Laravel e mandar para o agente de IA Tutorial completo: receber o webhook da WhatsApp Cloud API, baixar o áudio, transcrever com a API da OpenAI em fila e entregar o texto ao seu agente de IA no Laravel.
- Como gerenciar a memória de um agente de IA no Laravel: janela, resumo e fatos Mandar o histórico inteiro ao Claude a cada mensagem encarece e piora o agente. Como combinar janela recente, resumo incremental e memória de fatos no Laravel.
- Como categorizar transações do extrato com Claude no Laravel Tutorial para classificar transações bancárias com Claude no Laravel: regras aprendidas, lotes, saída estruturada com enum, limiar de confiança e revisão humana.
- Como criar um servidor MCP no Laravel para expor dados do seu app ao Claude Passo a passo para implementar o Model Context Protocol via HTTP no Laravel, com tools somente leitura, autenticação Sanctum e testes no MCP Inspector e no Claude Code.
- Como configurar o Claude Code em projetos Laravel: CLAUDE.md, hooks e comandos Passo a passo para deixar o Claude Code útil num projeto Laravel: CLAUDE.md enxuto, permissões que protegem o .env, hook com Pint e PHPStan e comandos para testes e revisão.
- Como fazer streaming de respostas do Claude no Laravel com Server-Sent Events Passo a passo para exibir a resposta do Claude token a token no navegador com Laravel e SSE, sem pacote extra. Inclui parser, controller, front-end, nginx e erros comuns.
- Prompt caching e Batch API do Claude no Laravel: como cortar o custo de LLM em produção Como usar prompt caching e a Batch API da Anthropic no Laravel para pagar menos por token: estrutura do prompt, métrica de cache hit, batches noturnos e escolha de modelo.
- Como chamar LLMs no Laravel com filas, retries e timeouts sem duplicar custo Chamadas ao Claude ou à OpenAI falham por 429, 529 e timeout. Veja como usar filas, retry com retry-after, rate limit no Horizon e idempotência no Laravel.
- Prompt injection e LGPD em agentes de IA no Laravel: como proteger dados e ações Prompt injection não se resolve no system prompt. Veja como manter autorização fora do LLM, confirmar ações sensíveis e minimizar dados pessoais num agente Laravel.
- Como testar código que usa LLM no Laravel: Http::fake, respostas gravadas e evals Passo a passo para testar integrações com Claude no Laravel sem gastar tokens no CI: Http::fake, fixtures gravadas de respostas reais, testes de falha e evals.
- Como criar um agente de IA com tool calling do Claude no Laravel para agendamentos no WhatsApp Passo a passo para um agente de IA com Claude e tool calling no Laravel: ferramentas de agenda, loop, validação, permissões pelo telefone, fila e testes com Http::fake.
- Como extrair dados de comprovantes em PDF com Claude e saída estruturada no Laravel Tutorial para ler comprovantes de Pix, TED e boleto em PDF com Claude, receber JSON validado por schema e processar tudo em fila no Laravel, com retries e testes.
- Como fazer RAG com pgvector no Laravel: embeddings, busca vetorial e respostas com Claude Tutorial passo a passo para montar RAG no Laravel com PostgreSQL e pgvector: chunking, embeddings da OpenAI em fila, busca por similaridade e respostas com fontes via Claude.