Blog em destaque

Como usar o LangSmith em 2026: Guia completo para iniciantes e avançados

2026-05-14
ARQUIVO · langsmith_guide.py CORRIDA · 14/05/2026
SESSÃO · ATIVA
DOC / 015 Guia de Campo do Desenvolvedor
— LangSmith 2026 · Iniciante → Avançado —
VERSÃO 26.05.14 mesa de desenvolvimento ai.cc
Tutorial · 5 páginas · 18 minutos de leitura

Pare os agentes de depuração
com imprimir().
Usar LangSmith.

LangSmith é a principal plataforma de observabilidade, avaliação e implantação para aplicações LLM e IA Agética — desenvolvida pela equipe LangChain. Ela rastreia cada chamada de modelo, uso de ferramenta e decisão tomada pelos seus agentes, fornecendo painéis, avaliações e ferramentas de depuração para que você possa processá-las como um software profissional. Este é o guia essencial para profissionais: registro, rastreamento, depuração com LangGraph, avaliações e fluxo de trabalho de nível de produção.

Tempo de leitura
18m
+ configuração prática
vãos
5/5
Configuração → Produção
Pilha
Py·JS
+ LangGraph
Nível gratuito
$0/para
Não é necessário cartão.
§ Por que agora?

Por que a LangSmith é importante em 2026.

À medida que a IA Agentica se torna comum, a simplicidade imprimir() A depuração não funciona mais. Uma execução de agente moderna é uma árvore de chamadas LLM aninhadas, invocações de ferramentas, novas tentativas e ramificações condicionais — e você não pode depurar isso com logger.infoO LangSmith oferece cinco funcionalidades que se combinam para formar um fluxo de trabalho completo:

F / 01
Rastreamento de ponta a ponta
Cada chamada do LLM, uso de ferramentas e decisão são registrados.
F / 02
Depuração visual
Fluxos de trabalho multiagentes como árvores inspecionáveis.
F / 03
Avaliações automatizadas
Testes de regressão com conjuntos de dados e juízes de LLM.
F / 04
Gestão rápida
Controle de versões, testes A/B, revisão em equipe.
F / 05
Monitoramento da produção
Custo, latência e taxa de erro em grande escala.
Painel de rastreamento do LangSmith mostrando o rastreamento da execução do agente com chamadas LLM e uso da ferramenta.
Visão geral do rastreamento O painel de rastreamento do LangSmith — cada intervalo aninhado, cada chamada de ferramenta, cada custo de token em uma única linha do tempo.
▾ RAIZ · id_da_execução: 5a3f...c91d 5 vãos · total ~45m
SPAN · 01 CONFIGURAR
t = 00:00 ~5 min

Crie sua conta LangSmith Chave de API.

O plano gratuito para desenvolvedores é suficiente para começar — sem necessidade de cartão de crédito. As chaves de serviço são para produção, os tokens de acesso pessoal para desenvolvimento. Não os misture.

  1. Vá para smith.langchain.com e inscreva-se. O plano para desenvolvedores é gratuito. — Não é necessário cartão.
  2. Faça login com o Google, GitHub ou e-mail — você escolhe.
  3. Navegue até Configurações → Chaves de API.
  4. Criar um Token de Acesso Pessoal para desenvolvimento, ou um Chave de serviço para implantações em produção.
  5. Copie a chave — você só a verá uma vez. Guarde-a no seu gerenciador de segredos, não no Git.
Atenção As chaves de serviço têm escopo em nível organizacional. Se uma chave vazar, troque-a imediatamente na mesma página de Configurações — a chave antiga expira, a nova assume o controle e não há tempo de inatividade se você reimplantá-la rapidamente.
SPAN · 02 INSTALAR
t = 00:05 ~3 min

Instalar ferreiro E configure seu ambiente.

Uma instalação com o pip, três variáveis ​​de ambiente. A quarta variável, opcional, serve para configurar a residência na UE ou para roteamento personalizado de endpoints.

terminal Bash
1
pip instalar langsmith

Defina variáveis ​​de ambiente — adicione a .env ou exportar diretamente:

.env Bash
1
2
3
4
exportar RASTREAMENTO DE LANGSMITH=verdadeiro  exportar CHAVE_API_LANGSMITH=lsv2_xxxxxxxxxxxx  # Opcional: Para a UE ou região personalizada  # export LANGSMITH_ENDPOINT=https://eu.api.smith.langchain.com
SPAN · 03 INÍCIO RÁPIDO
t = 00:08 ~10 min

Habilite o rastreamento no seu código.

O @rastreável O decorador envolve qualquer função e envia suas entradas, saídas, latência e chamadas de ferramentas para o LangSmith. Esse é todo o guia de início rápido.

meu_agente.py Python
1
2
3
4
5
6
7
8
9
10
11
de langchain_openai importar ChatOpenAI  de ferreiro importar rastreável @rastreável  definição meu_agente(consulta: str): llm = ChatOpenAI(modelo="gpt-4o") retornar llm.invoke(consulta) # Ou habilite globalmente  importar os  os.environ["LANGSMITH_RASTREAMENTO"] = "verdadeiro"

Execute seu código. Os rastreamentos aparecem automaticamente no painel do LangSmith — geralmente em segundos.

Criação de chave de API LangSmith nas configurações
Criação de chave de API Configurações → Chaves de API — selecione o tipo de chave correto (PAT para desenvolvimento, Chave de Serviço para produção).
Código Python emparelhado com a visualização de rastreamento LangSmith correspondente.
Código → Rastreamento À esquerda: sua função decorada. À direita: o traçado que o LangSmith captura automaticamente.
SPAN · 04 LANGGRAPH
t = 00:18 ~15 min

Depure agentes complexos com Gráfico de idioma.

LangSmith brilha mais quando combinado com LangGraph — fluxos de trabalho com estado, com múltiplos nós e múltiplos agentes. A árvore de rastreamento se torna a própria execução do grafo.

  • Visualize a execução completa do gráfico. — cada nó, cada aresta, cada transição de estado.
  • Veja as mudanças de estado em cada nó. Chega imprimir(estado) em doze lugares.
  • Reproduza os trajetos com diferentes modelos ou instruções. — testar uma hipótese sem repetir a produção.
  • Use o LangSmith Studio Para depuração visual e passo a passo do agente.
Fluxo de trabalho multiagente do LangGraph visualizado no LangSmith Studio.
Estúdio · Visualização LangGraph Fluxo de trabalho multiagente como um gráfico visual — depuração passo a passo por arrastar, inspeção de estado em cada nó.
SPAN · 05 AVALIAÇÕES
t = 00:33 ~12 min

Realizar avaliações e experimentos.

As avaliações são o que diferenciam uma demonstração de um produto. Sem elas, cada ajuste nas instruções é um palpite. O LangSmith já incorpora esse fluxo de trabalho:

  • Criar conjuntos de dados de casos de teste — comece com 10 exemplos e aumente para centenas.
  • Defina avaliadores — LLM como juiz, código personalizado ou feedback humano.
  • Execute experimentos e compare versões. lado a lado, com indicadores de regressão.
  • Acompanhe a regressão à medida que itera. O novo prompt quebrou o exemplo nº 7? Você verá isso antes do lançamento.
Portão de produção Este é o protocolo que diferencia um projeto amador de uma IA Agética de nível de produção. Trate o conjunto de dados como um conjunto de testes — pequeno no início, crescendo sempre que uma falha do mundo real surgir.
§ Avançado · 2026

Dicas para usuários avançados para implantações em produção.

  • Use o mecanismo LangSmith (novidade em 2026) — uma camada de IA que analisa rastreamentos e sugere correções para execuções com falha ou custosas.
  • Integrar com LangGraph para memória persistente e pontos de verificação com intervenção humana — os dois padrões que mais importam após a fase de protótipo.
  • Monitore custos, latência e taxas de erro. Em produção. Defina limites. Receba alertas antes dos clientes.
  • Configure alertas de anomalia. Um aumento de 3 vezes no número de tokens por chamada é um sinal, não uma coincidência.
Painel de monitoramento de produção da LangSmith com métricas de custo e desempenho.
Monitoramento da produção Custo, latência, taxas de erro, p95 — os painéis de controle que você precisa antes de entrar em produção.
§ Preços

Visão geral dos preços • Níveis de 2026.

Plano · Preços · Capacidade ATUALIZADO EM 2026.05
Desenvolvedor
Para construtores individuais e protótipos. Volume de rastreamento limitado. Não é necessário cartão de crédito.
LIVRE
Mais
Para pequenas equipes que enviam agentes para a produção. Modelo de licença mais uso. Avaliações completas + Estúdio.
US$ 39 por assento por mês
Empresa
Para organizações de maior porte. Implantações auto-hospedadas e híbridas disponíveis. SLAs personalizados e revisão de segurança.
Personalizado
§ Casos de uso

Quais são, de fato, as equipes usando-o para.

Caso / 01 · Depuração Descobrir por que seu agente tem alucinações, entra em loop ou para no meio da tarefa — inspecionando a árvore de rastreamento real, e não por meio de palpites.
Caso / 02 · Modelo A/B Comparação entre Claude e GPT-4o em entradas idênticas — mesmo conjunto de dados, mesmos avaliadores, resultados frente a frente.
Caso / 03 · Conformidade Trilhas de auditoria para setores regulamentados — cada solicitação, resultado e decisão são registrados de forma imutável.
Caso / 04 · Instruções da Equipe Engenharia colaborativa de prompts — controle de versão, comentários, revisão e implementação em toda a equipe.

Lista de verificação de ações — Executar hoje.

  1. Crie sua conta LangSmith e gere uma chave de API.
  2. Habilite o rastreamento no seu projeto atual — um decorador, duas variáveis ​​de ambiente.
  3. Execute um fluxo de agente e inspecione a árvore de rastreamento resultante.
  4. Crie um pequeno conjunto de dados de avaliação (5 a 10 exemplos).
  5. Abra o LangSmith Studio e percorra visualmente o seu agente.

LangSmith tornou-se o de fato padrão Para desenvolvimento sério de IA Agética em 2026. Comece com o plano gratuito hoje mesmo e faça upgrade à medida que seus agentes se tornarem mais complexos. O que você está criando com o LangSmith? Compartilhe seu caso de uso nos comentários — terei prazer em dar conselhos específicos. Última atualização 14 de maio de 2026Sempre verifique o oficial Documentos LangSmith Para conhecer as funcionalidades mais recentes.

// FIM DO RASTREAMENTO · run_id: 5a3f...c91d ai.cc · guia_de_campo · DOC·015 · 14/05/2026

Mais de 300 modelos de IA para
OpenClaw e Agentes de IA

Economize 20% nos custos