Como implementar a chamada de ferramentas com LangSmith (Passo a passo)

📖 6 min read•1,017 words•Updated Apr 1, 2026

Como implementar a chamada de ferramentas com LangSmith

Estamos construindo uma implementação de chamada de ferramentas que conecta diversas APIs e serviços, tornando seu aplicativo mais eficiente e responsivo. Esse método é particularmente relevante hoje em dia, com as empresas enfrentando a necessidade de ciclos de desenvolvimento mais rápidos.

Pré-requisitos

JavaScript ES6+
Node.js 14+
LangSmith v1.0.0+

Passo 1: Configure seu ambiente

Primeiramente, você precisa criar seu projeto e instalar as dependências necessárias. Ignorar esta etapa te fará perder os cabelos mais tarde.


mkdir langsmith-tool-calling
cd langsmith-tool-calling
npm init -y
npm install langsmith

Por que isso é importante: Inicializar corretamente seu ambiente evita muitos problemas depois. Se você não estiver usando a versão 14 do Node ou uma versão posterior, seu aplicativo enfrentará problemas de compatibilidade mais tarde. Acredite, já passei por isso.

Passo 2: Crie uma função de chamada de ferramenta básica

Depois de tudo configurado, o próximo passo é implementar uma chamada de ferramenta básica. Esse será seu primeiro teste para garantir que o LangSmith funcione como esperado.


import { Tool } from 'langsmith';

const fetchDataFromAPI = async (url) => {
 const response = await Tool.call(url);
 return response.data;
};

fetchDataFromAPI('https://api.example.com/data')
 .then(data => console.log(data))
 .catch(err => console.error(err));

Essa função chamará uma API e retornará os dados. O verdadeiro desafio aqui é gerenciar os erros com cuidado. Se você tentar chamar uma URL inexistente, receberá um erro de rede. Pegue-os e registre-os para entender o que está errado.

Passo 3: Configure sua chave da API e suas variáveis de ambiente

Normalmente, você não gostaria de expor suas chaves da API diretamente no código. Então, você deve gerenciar suas credenciais através de variáveis de ambiente.


echo "API_KEY=your_api_key" > .env

Agora, modifique sua função para usar dotenv para carregar a chave da API.


import dotenv from 'dotenv';
dotenv.config();

const fetchDataFromAPI = async (url) => {
 const apiKey = process.env.API_KEY;
 const response = await Tool.call(url, {headers: { 'Authorization': `Bearer ${apiKey}` }});
 return response.data;
};

Certifique-se de instalar dotenv: npm install dotenv. Se você esquecer, receberá erros de chave da API indefinida e ficará confuso sobre o motivo pelo qual suas requisições falham.

Passo 4: Adicione requisições paralelas

Por que não acelerar suas chamadas? Ao buscar dados em paralelo, você pode ganhar segundos valiosos.


const fetchMultipleAPIs = async (urls) => {
 const promises = urls.map(url => fetchDataFromAPI(url));
 return Promise.all(promises);
};

fetchMultipleAPIs(['https://api.one.com', 'https://api.two.com'])
 .then(data => console.log(data))
 .catch(err => console.error(err));

Essa etapa é onde você acelera tudo. Imagine seu aplicativo buscando dados de cinco endpoints em vez de um; é óbvio. Esqueça de gerenciar o throttling, e você excederá os limites da API, resultando em ainda mais dores de cabeça.

Passo 5: Gerenciamento de erros e log

Agora, um aplicativo sem gerenciamento de erros é como um navio sem bússola. Você está destinado a se perder. Vamos adicionar alguns mecanismos de captura de erros a mais.


const fetchDataFromAPI = async (url) => {
 try {
 const apiKey = process.env.API_KEY;
 const response = await Tool.call(url, { headers: { 'Authorization': `Bearer ${apiKey}` } });
 return response.data;
 } catch (error) {
 console.error(`Erro ao recuperar de ${url} : ${error.message}`);
 throw error; // Importante para o gerenciamento de erros a monte.
 }
};

Adicionar instruções try/catch garante não apenas que os logs sejam limpos, mas também permite uma depuração melhor. Se algo falhar, você saberá exatamente onde aconteceu. Acredite em mim; eu sou aquele que tentou depurar após uma falha silenciosa.

Os perigos

Limitação de taxa: A maioria das APIs limita o número de requisições que você pode fazer por minuto. Muitas requisições paralelas podem resultar em blacklisting.
Consistência dos dados: Chamar várias APIs significa que os dados podem mudar entre as chamadas. Tenha sempre uma estratégia para lidar com isso.
Flutuação da rede: Ouça, problemas de rede acontecem. Limite suas requisições para gerenciar graciosamente esses cenários com tentativas novamente.
Configuração do ambiente: Certifique-se de que seu arquivo .env não esteja no controle de versão. Eu aprendi isso da pior forma.

Exemplo de código completo


import dotenv from 'dotenv';
import { Tool } from 'langsmith';

dotenv.config();

const fetchDataFromAPI = async (url) => {
 try {
 const apiKey = process.env.API_KEY;
 const response = await Tool.call(url, { headers: { 'Authorization': `Bearer ${apiKey}` } });
 return response.data;
 } catch (error) {
 console.error(`Erro ao recuperar de ${url} : ${error.message}`);
 throw error;
 }
};

const fetchMultipleAPIs = async (urls) => {
 const promises = urls.map(url => fetchDataFromAPI(url));
 return Promise.all(promises);
};

fetchMultipleAPIs(['https://api.one.com', 'https://api.two.com'])
 .then(data => console.log(data))
 .catch(err => console.error(err));

E depois?

Considere adicionar mecanismos de cache para otimizar chamadas da API repetidas. Ao armazenar em cache as respostas, você pode melhorar significativamente o desempenho e reduzir custos.

FAQ

Posso usar LangSmith com outras linguagens de programação?
Não, o LangSmith é atualmente projetado para JavaScript e TypeScript. Você precisará procurar em outro lugar para integrações em Python ou Ruby.
Como posso monitorar as chamadas da API?
Adicionar um log como indicado permite monitorar a taxa de sucesso e falha. Para produção, considere se integrar a um serviço de log.
Existem custos associados ao uso do LangSmith?
O LangSmith possui um modelo de precificação por níveis, e você deve consultar o site deles para obter detalhes.

Fontes de dados

LangSmith GitHub
Chamada de ferramentas – Documentação do LangChain

Última atualização em 25 de março de 2026. Dados provenientes de documentos oficiais e benchmarks da comunidade.

Como implementar a chamada de ferramentas com LangSmith (Passo a passo)