--- title: Integração com Langfuse slug: integracao-com-langfuse createdAt: 2024-09-02T19:57:16.997Z --- ## O que é Langfuse Langfuse é uma plataforma de código aberto para engenharia de LLM que ajuda equipes a colaborar na depuração, análise e iteração de suas aplicações. :::hint{type="info"} Introdução ao Langfuse: [Langfuse](https://langfuse.com/) ::: ## Como Configurar o Langfuse 1.Registre-se e faça login no Langfuse no site oficial. 2.Crie um projeto no Langfuse. Após fazer login, clique em "New" 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/-KuoFVmWuToJFxjpqAaIN_captura-de-tela-2024-09-03-as-110835-am.png) Edite o nome do projeto ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/7bGBQM1ayyQV2m0Ga-zcw_captura-de-tela-2024-09-03-as-112550-am.png) 3.Crie as credenciais da API do projeto. Na barra lateral esquerda do projeto, clique em "Configurações" para abrir as configurações. ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/T7wDjgPOmIK7MrPWhabWe_captura-de-tela-2024-09-03-as-112636-am.png) Nas configurações, clique em "Criar Chaves de API" para gerar as credenciais da API do projeto. ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/WWBjvN4rCy_kjCqDeEa4P_captura-de-tela-2024-09-03-as-113016-am.png) Copie e salve a Secret Key, Public Key e o Host ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/5JiRY5HdBNHi9Wy6pPEld_captura-de-tela-2024-09-03-as-113118-am.png) 4.Configure o Langfuse no Paragraph. Abra a aplicação que você precisa monitorar, acesse a opção "Monitoramento" no menu lateral e selecione "Rastreamento de desempenho da aplicação" na página. ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/BdNw0KhDh2ppO0t4MGHSx_captura-de-tela-2024-09-03-as-113723-am.png) Após clicar em "Configurar", cole a Secret Key, Public Key e o Host criados no Langfuse na configuração e salve. ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/gLw_7CqQgPLcfrZ_UZiiw_captura-de-tela-2024-09-03-as-114044-am.png) Após salvar com sucesso, você poderá visualizar o status na página atual. Se estiver exibindo "Iniciado", o monitoramento está ativo. ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/aBE-OY5uiMqk4N3ebojW0_captura-de-tela-2024-09-03-as-114248-am.png) ## Visualizando Monitoramento de Dados no Lagfuse Após a configuração, os dados de depuração ou de produção da aplicação no *Paragraph* podem ser visualizados no Langfuse. ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/A9XNtsWcKbxartlbyUuBF_captura-de-tela-2024-09-03-as-114555-am.png) ![](https://api.archbee.com/api/optimize/NB-ulyH02IT7Ep_VosDsd/3MsSRszFrDOfFgPBzoOZM_captura-de-tela-2024-09-03-as-21352-pm.png) ## Lista de Dados de Monitoramento Rastreamento de informações de Workflow e Chatflow Rastreando workflow e chatflow **Informações de Rastreamento de Workflow** - **workflow\_id**: ID único do Workflow - **conversation\_id**: ID da conversa - **workflow\_run\_id**: ID do Workflow desta execução - **tenant\_id**: ID do tenant - **elapsed\_time**: Tempo decorrido nesta execução - **status**: Status da execução - **version**: Versão do workflow - **total\_tokens**: Total de tokens usados nesta execução - **file\_list**: Lista de arquivos processados - **triggered\_from**: Fonte que acionou esta execução - **workflow\_run\_inputs**: Entrada deste workflow - **workflow\_run\_outputs**: Saída deste workflow - **error**: Mensagem de erro - **query**: Consultas usadas na execução - **workflow\_app\_log\_id**: ID do log da aplicação do workflow - **message\_id**: ID da Mensagem relevante - **start\_time**: Hora de início desta execução - **end\_time**: Hora de término desta execução - **workflow node executions**: Informações de execução dos nós do workflow **Metadata** - **workflow\_id**: ID único do Workflow - **conversation\_id**: ID da conversa - **workflow\_run\_id**: ID do Workflow desta execução - **tenant\_id**: ID do tenant - **elapsed\_time**: Tempo decorrido nesta execução - **status**: Estado operacional - **version**: Versão do workflow - **total\_tokens**: Total de tokens usados nesta execução - **file\_list**: Lista de arquivos processados - **triggered\_from**: Fonte que acionou esta execução **Informações de Rastreamento de Mensagens** Para rastrear conversas LLM | Mensagem | Geração/Rastreamento LangFuse | | ----------------------------- | ----------------------------- | | message\_id | id | | user\_session\_id | user\_id | | message\_{id} | name | | start\_time | start\_time | | end\_time | end\_time | | inputs | input | | outputs | output | | Consumo de tokens do modelo | usage | | metadata | metadata | | error | level | | \[mensagem, modo de conversa] | tags | | conversation\_id | session\_id | | conversion\_id | parent\_observation\_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**: Modelo de conversação - **message\_tokens**: Tokens da mensagem - **answer\_tokens**: Tokens da resposta - **total\_tokens**: Total de Tokens da Mensagem e Resposta - **error**: Mensagem 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 relevante da mensagem - **conversation\_mode**: Modo de conversa **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 é baseado em agente - **workflow\_run\_id**: ID do Workflow desta execução - **from\_source**: Fonte da mensagem - **message\_id**: ID da Mensagem **Informações de Rastreamento de Moderação** Usado para rastrear moderação de conversas | Moderação | Geração/Rastreamento LangFuse | | ------------ | ----------------------------- | | user\_id | user\_id | | moderação | name | | start\_time | start\_time | | end\_time | end\_time | | inputs | input | | outputs | output | | metadata | metadata | | \[moderação] | tags | | message\_id | parent\_observation\_id | **Informações de Rastreamento de Moderação** - **message\_id**: ID da Mensagem - **user\_id**: ID do usuário - **workflow\_app\_log\_id**: workflow\_app\_log\_id - **inputs**: Dados de entrada para revisão - **message\_data**: Dados da Mensagem - **flagged**: Se foi sinalizado para atenção - **action**: Ações específicas a serem implementadas - **preset\_response**: Resposta predefinida - **start\_time**: Hora de início da revisão - **end\_time**: Hora de término da revisão **Metadata** - **message\_id**: ID da Mensagem - **action**: Ações específicas a serem implementadas - **preset\_response**: Resposta predefinida **Informações de Rastreamento de Perguntas Sugeridas** Usado para rastrear perguntas sugeridas | Pergunta Sugerida | Geração/Rastreamento LangFuse | | --------------------- | ----------------------------- | | user\_id | user\_id | | pergunta\_sugerida | name | | start\_time | start\_time | | end\_time | end\_time | | inputs | input | | outputs | output | | metadata | metadata | | \[pergunta\_sugerida] | tags | | message\_id | parent\_observation\_id | **Informações de Rastreamento de Perguntas Sugeridas** - **message\_id**: ID da Mensagem - **message\_data**: Dados da mensagem - **inputs**: Dados de entrada - **outputs**: Dados de saída - **start\_time**: Hora de início - **end\_time**: Hora de término - **total\_tokens**: Total de tokens - **status**: Status da Mensagem - **error**: Mensagem de erro - **from\_account\_id**: ID da conta remetente - **agent\_based**: Se é baseado em agente - **from\_source**: Fonte da mensagem - **model\_provider**: Provedor do modelo - **model\_id**: ID do modelo - **suggested\_question**: Pergunta sugerida - **level**: Nível de status - **status\_message**: Status da mensagem **Metadata** - **message\_id**: ID da Mensagem - \*\*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 - **workflow\_run\_id**: ID do Workflow desta execução - **from\_source**: Fonte da mensagem **Informações de Rastreamento de Recuperação de Conjunto de Dados** Usado para rastrear a recuperação da base de conhecimento | Recuperação de Conjunto de Dados | Geração/Rastreamento LangFuse | | -------------------------------- | ----------------------------- | | user\_id | user\_id | | recuperação\_conjunto\_dados | name | | start\_time | start\_time | | end\_time | end\_time | | inputs | input | | outputs | output | | metadata | metadata | | \[recuperação\_conjunto\_dados] | tags | | message\_id | parent\_observation\_id | **Informações de Rastreamento de Recuperação de Conjunto de Dados** - **message\_id**: ID da Mensagem - **inputs**: Mensagem de entrada - **documents**: Dados do documento - **start\_time**: Hora de início - **end\_time**: Hora de término - **message\_data**: Dados da mensagem **Metadata** - **message\_id**: ID da Mensagem - **ls\_provider**: Provedor do Modelo - **ls\_model\_name**: ID do Modelo - **status**: Status do Modelo - **from\_end\_user\_id**: ID do usuário remetente - **from\_account\_id**: ID da conta remetente - **agent\_based**: Se é baseado em agente - **workflow\_run\_id**: ID do Workflow desta execução - **from\_source**: Fonte da Mensagem **Informações de Rastreamento de Ferramentas** Usado para rastrear a invocação de ferramentas | Ferramenta | Geração/Rastreamento LangFuse | | --------------------------------- | ----------------------------- | | user\_id | user\_id | | nome\_ferramenta | name | | start\_time | start\_time | | end\_time | end\_time | | inputs | input | | outputs | output | | metadata | metadata | | \["ferramenta", nome\_ferramenta] | tags | | message\_id | parent\_observation\_id | **Informações de Rastreamento de Ferramentas** - **message\_id**: ID da Mensagem - **nome\_ferramenta**: Nome da ferramenta - **start\_time**: Hora de início - **end\_time**: Hora de término - **tool\_inputs**: Entradas da ferramenta - **tool\_outputs**: Saídas da ferramenta - **message\_data**: Dados da mensagem - **error**: Mensagem de erro, se existir - **inputs**: Entrada da Mensagem - **outputs**: Saída da Mensagem - **tool\_config**: Configuração da ferramenta - **time\_cost**: Custo de tempo - **tool\_parameters**: Parâmetros da ferramenta - **file\_url**: URL dos arquivos relevantes **Metadata** - **message\_id**: ID da Mensagem - **tool\_name**: Nome da Ferramenta - **tool\_inputs**: Entradas da ferramenta - **tool\_outputs**: Saídas da ferramenta - **tool\_config**: Configuração da ferramenta - **time\_cost**: Custo de tempo - **error**: Mensagem de erro - **tool\_parameters**: Parâmetros da ferramenta - **message\_file\_id**: ID do arquivo da mensagem - **created\_by\_role**: Criado pelo papel - **created\_user\_id**: ID do usuário criador **Rastreamento de Geração de Nome** Usado para rastrear a geração do título da conversa | Geração de Nome | Geração/Rastreamento LangFuse | | --------------- | ----------------------------- | | user\_id | user\_id | | gerar\_nome | name | | start\_time | start\_time | | end\_time | end\_time | | inputs | input | | outputs | output | | metadata | metadata | | \[gerar\_nome] | tags | **Informações de Rastreamento de Geração de Nome** - **conversation\_id**: ID da Conversa - **inputs**: Dados de entrada - **outputs**: Nome da sessão gerado - **start\_time**: Hora de início - **end\_time**: Hora de término - **tenant\_id**: ID do tenant **Metadata** - **conversation\_id**: ID da Conversa - **tenant\_id**: ID do tenant *** Se precisar de mais alguma coisa, estou à disposição!