Anthropic SDK: Claude dentro do produto

Até aqui a série usou IA pra construir o produto (Claude Code) e pra operar em background (resumos). Agora o giro: IA como feature do produto, falando direto com o usuário. É o Anthropic SDK colocando o Claude dentro do ClubPetro. Este post mostra como pensamos isso.

IA que constrói × IA que é produto

Vale separar dois usos que a série mistura de propósito:

• Claude Code (Módulo 2) — IA que ajuda o dev a escrever o produto.
• Anthropic SDK — IA que é parte do produto, gerando valor pro usuário final (resumos, narrativas, copiloto, classificação).

Mesmo modelo por baixo, papéis diferentes. Este post é sobre o segundo.

Onde Claude vira feature no ClubPetro

• Resumos e digests de conversa/atendimento (Módulos 4 e 5).
• Narrativa mensal das apresentações.
• Copiloto — assistente que responde com contexto, citações e streaming.
• Classificação e extração — transformar texto bagunçado em dado estruturado.

Os padrões de quem coloca IA em produção

1. Streaming pra percepção de velocidade

Resposta de IA demora alguns segundos. Em vez de tela travada, a gente transmite o texto conforme ele sai (SSE). O usuário vê a resposta nascer — muda totalmente a experiência.

2. Prompt é código

O prompt que gera a feature vive no repo, versionado, revisado e melhorado com base no resultado. "Mexer no prompt" é mudança de produto, não ajuste solto.

3. Saída estruturada quando precisa virar dado

Quando a saída da IA vai pro banco ou alimenta lógica, a gente força formato estruturado e valida — não confia em "o modelo provavelmente respondeu certo".

4. Custo e latência são decisão

Cada chamada custa e demora. Pré-gerar em background (#27) vs. gerar ao vivo é escolha consciente, guiada por dado de uso.

O cuidado inegociável

• Dado sensível com responsabilidade — o que vai pro modelo é decisão de privacidade.
• A IA pode errar. Feature de IA precisa de caminho pra quando ela alucina: citação, revisão, fallback. Confiança cega vira bug com cara de fato.
• Modelo certo pra tarefa. Nem tudo precisa do modelo mais caro; nem tudo aguenta o mais simples. Escolha com dado.

⚠️ Armadilha #34: colocar IA como feature sem plano pra quando ela erra. Modelo erra — a pergunta é se o seu produto trata o erro com elegância ou entrega a alucinação como verdade pro usuário.

Próximo da série: #35 — Resend: e-mail transacional que chega.