---
title: Integração com LangSmith
slug: integracao-com-langsmith
createdAt: 2024-09-02T19:55:17.380Z
---

## O que é LangSmith

LangSmith é uma plataforma para construir aplicações LLM em nível de produção. Ela é usada para desenvolver, colaborar, testar, implantar e monitorar aplicações LLM.

Para mais detalhes, consulte LangSmith.

## Como Configurar LangSmith

**1.Registrar/Login no LangSmith**

**2.Criar um Projeto**
Crie um projeto no LangSmith. Após o login, clique em "New Project" na página inicial para criar seu próprio projeto. O projeto será usado para associar com as aplicações no Paragraph para monitoramento de dados.

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/7EL1OJW8dVpkq8LH8U7WJ_captura-de-tela-2024-09-03-as-101112-am.png)

Depois de criados, você pode visualizar todos os projetos na seção "Projetos".

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/x55mp6IFk_zplOiFC--s3_captura-de-tela-2024-09-03-as-101256-am.png)

**3.Criar Credenciais do Projeto**
Encontre as configurações do projeto em "Settings" na barra lateral esquerda.

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/Cnf59jNmKMVh-4TdLl29a_captura-de-tela-2024-09-03-as-101748-am.png)

Clique em "Criar Chave de API" para gerar as credenciais do projeto.

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/Q4YGa7zfcoskPisBRIwhV_captura-de-tela-2024-09-03-as-101916-am.png)

Selecione "Token de Acesso Pessoal" para a autenticação da API subsequente.

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/EPYUkOzqQsZE8mjoC2766_captura-de-tela-2024-09-03-as-101945-am.png)

Crie e salve a API Key criada.

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/54cGNIXgjaM0F3Hm8_WAl_captura-de-tela-2024-09-03-as-102028-am.png)

**4.Integrando LangSmith com o Paragraph**
Configure o LangSmith na aplicação Paragraph. Abra a aplicação que você precisa monitorar, acesse "Monitoring" no menu lateral e selecione "Tracing app performance" na página.

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/HmyD3IwWzkkjrKoHlSjte_captura-de-tela-2024-09-03-as-102423-am.png)

Após clicar em configurar, cole a chave API e o nome do projeto criados no LangSmith na configuração e salve.

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/IsAbiJkcubCG8qjyeO12q_captura-de-tela-2024-09-03-as-102624-am.png)

:::hint{type="info"}
O nome do projeto configurado precisa corresponder ao projeto definido no LangSmith. Se os nomes dos projetos não coincidirem, o LangSmith criará automaticamente um novo projeto durante a sincronização de dados.
:::

Depois de salvar com sucesso, você pode visualizar o status de monitoramento na página atual.

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/31Z8ZLsshtQKc9-5JIKOI_captura-de-tela-2024-09-03-as-103011-am.png)

## Visualizando Dados de Monitoramento no LangSmith

Uma vez configurado, os dados de depuração ou produção das aplicações dentro do Paragraph podem ser monitorados no LangSmith.

![Depurando Aplicações no Paragraph](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/RJ4GwZlyZxCFAwTq6BJv-_captura-de-tela-2024-09-03-as-103341-am.png "Depurando Aplicações no Paragraph")


Quando você alterna para o LangSmith, pode visualizar logs detalhados de operação das aplicações do Paragraph no painel de controle.

![Visualizando dados da aplicação no LangSmith](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/MzEttGWbSTEvgniPv1Jip_captura-de-tela-2024-09-03-as-103358-am.png "Visualizando dados da aplicação no LangSmith")

Logs detalhados de operações de LLM através do LangSmith ajudarão você a otimizar o desempenho da sua aplicação no Paragraph.

![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/lxIO_Xc8UQGqODDIMzbd7_captura-de-tela-2024-09-03-as-105158-am.png)

## Lista de Dados de Monitoramento

### Informações de Rastreamento de Workflow/Chatflow
Usado para rastrear workflows e chatflows

| Workflow                                 | LangSmith Chain              |
| ---------------------------------------- | ---------------------------- |
| workflow\_app\_log\_id/workflow\_run\_id | id                           |
| user\_session\_id                        | - colocado em metadata       |
| workflow\_{id}                      | name                         |
| start\_time                              | start\_time                  |
| end\_time                                | end\_time                    |
| inputs                                   | inputs                       |
| outputs                                  | outputs                      |
| Model token consumption                  | usage\_metadata              |
| metadata                                 | metadata                     |
| extra                                    | extra                        |
| error                                    | error                        |
| \[workflow]                              | tags                         |
| "conversation\_id/none for workflow"     | conversation\_id em metadata |
| conversation\_id                         | conversation\_id             |
| parent\_run\_id                          | parent\_run\_id              |

## Informações de Rastreamento de Workflow

- **workflow\_id**: Identificador único do workflow
- **conversation\_id**: ID da conversa
- **workflow\_run\_id**: ID da execução atual
- **tenant\_id**: ID do tenant
- **elapsed\_time**: Tempo gasto na execução atual
- **status**: Status da execução
- **version**: Versão do workflow
- **total\_tokens**: Total de tokens usados na execução atual
- **file\_list**: Lista de arquivos processados
- **triggered\_from**: Fonte que acionou a execução atual
- **workflow\_run\_inputs**: Dados de entrada da execução atual
- **workflow\_run\_outputs**: Dados de saída da execução atual
- **error**: Erros encontrados durante a execução atual
- **query**: Consulta usada durante a execução
- **workflow\_app\_log\_id**: ID do log da aplicação do workflow
- **message\_id**: ID da mensagem associada
- **start\_time**: Hora de início da execução
- **end\_time**: Hora de término da execução
- **workflow node executions**: Informações sobre as execuções dos nós do workflow

## Metadata

- **workflow\_id**: Identificador único do workflow
- **conversation\_id**: ID da conversa
- **workflow\_run\_id**: ID da execução atual
- **tenant\_id**: ID do tenant
- **elapsed\_time**: Tempo gasto na execução atual
- **status**: Status da execução
- **version**: Versão do workflow
- **total\_tokens**: Total de tokens usados na execução atual
- **file\_list**: Lista de arquivos processados
- **triggered\_from**: Fonte que acionou a execução atual

## Informações de Rastreamento de Mensagens

Usado para rastrear conversas relacionadas a LLM

| Chat                             | LangSmith LLM                |
| -------------------------------- | ---------------------------- |
| message\_id                      | id                           |
| user\_session\_id                | - colocado em metadata       |
| “message\_{id}"             | name                         |
| start\_time                      | start\_time                  |
| end\_time                        | end\_time                    |
| inputs                           | inputs                       |
| outputs                          | outputs                      |
| Model token consumption          | usage\_metadata              |
| metadata                         | metadata                     |
| extra                            | extra                        |
| error                            | error                        |
| \["message", conversation\_mode] | tags                         |
| conversation\_id                 | conversation\_id em metadata |
| conversation\_id                 | conversation\_id             |
| parent\_run\_id                  | parent\_run\_id              |

## Informações de Rastreamento de Mensagens

- **message\_id**: ID da Mensagem
- **message\_data**: Dados da mensagem
- **user\_session\_id**: ID da sessão do usuário
- **conversation\_model**: Modo de conversação
- **message\_tokens**: Número de tokens na mensagem
- **answer\_tokens**: Número de tokens na resposta
- **total\_tokens**: Total de tokens na mensagem e resposta
- **error**: Informações de erro
- **inputs**: Dados de entrada
- **outputs**: Dados de saída
- **file\_list**: Lista de arquivos processados
- **start\_time**: Hora de início
- **end\_time**: Hora de término
- **message\_file\_data**: Dados do arquivo associado à mensagem
- **conversation\_mode**: Modo de conversação

## Metadata

- **conversation\_id**: ID da conversa
- **ls\_provider**: Provedor do modelo
- **ls\_model\_name**: ID do modelo
- **status**: Status da mensagem
- **from\_end\_user\_id**: ID do usuário remetente
- **from\_account\_id**: ID da conta remetente
- **agent\_based**: Se a mensagem é baseada em agente
- **workflow\_run\_id**: ID da execução do workflow
- **from\_source**: Fonte da mensagem

## Informações de Rastreamento de Moderação

Usado para rastrear moderação de conversas

| Moderação     | LangSmith Tool         |
| ------------- | ---------------------- |
| user\_id      | - colocado em metadata |
| “moderation"  | name                   |
| start\_time   | start\_time            |
| end\_time     | end\_time              |
| inputs        | inputs                 |
| outputs       | outputs                |
| metadata      | extra                  |
| \[moderation] | tags                   |
| message\_id   | parent\_run\_id        |

## Informações de Rastreamento de Moderação

- **message\_id**: ID da Mensagem
- **user\_id**: ID do Usuário
- **workflow\_app\_log\_id**: ID do log da aplicação do workflow
- **inputs**: Dados de entrada da moderação
- **message\_data**: Dados da mensagem
- **flagged**: Se o conteúdo foi sinalizado para atenção
- **action**: Ações específicas tomadas
- **preset\_response**: Resposta predefinida
- **start\_time**: Hora de início da moderação
- **end\_time**: Hora de término da moderação

## Metadata

- **message\_id**: ID da Mensagem
- **action**: Ações específicas tomadas
- **preset\_response**: Resposta predefinida

## Informações de Rastreamento de Perguntas Sugeridas

Usado para rastrear perguntas sugeridas

| Pergunta Sugerida      | LangSmith LLM          |
| ---------------------- | ---------------------- |
| user\_id               | - colocado em metadata |
| suggested\_question    | name                   |
| start\_time            | start\_time            |
| end\_time              | end\_time              |
| inputs                 | inputs                 |
| outputs                | outputs                |
| metadata               | extra                  |
| \[suggested\_question] | tags                   |
| message\_id            | parent\_run\_id        |

## Informações de Rastreamento de Perguntas Sugeridas

- **message\_id**: ID da Mensagem
- **message\_data**: Dados da mensagem
- **inputs**: Conteúdo de entrada
- **outputs**: Conteúdo de saída
- **start\_time**: Hora de início
- **end\_time**: Hora de término
- **total\_tokens**: Número de tokens
- **status**: Status da mensagem