Files
crewAI/docs/pt-BR/observability/langtrace.mdx
Tony Kipkemboi 1a1bb0ca3d docs: Docs updates (#3459)
* docs(cli): document device-code login and config reset guidance; renumber sections

* docs(cli): fix duplicate numbering (renumber Login/API Keys/Configuration sections)

* docs: Fix webhook documentation to include meta dict in all webhook payloads

- Add note explaining that meta objects from kickoff requests are included in all webhook payloads
- Update webhook examples to show proper payload structure including meta field
- Fix webhook examples to match actual API implementation
- Apply changes to English, Korean, and Portuguese documentation

Resolves the documentation gap where meta dict passing to webhooks was not documented despite being implemented in the API.

* WIP: CrewAI docs theme, changelog, GEO, localization

* docs(cli): fix merge markers; ensure mode: "wide"; convert ASCII tables to Markdown (en/pt-BR/ko)

* docs: add group icons across locales; split Automation/Integrations; update tools overviews and links
2025-09-05 17:40:11 -04:00

73 lines
2.9 KiB
Plaintext

---
title: Integração com Langtrace
description: Como monitorar custo, latência e desempenho dos Agentes CrewAI usando o Langtrace, uma ferramenta externa de observabilidade.
icon: chart-line
mode: "wide"
---
# Visão Geral do Langtrace
O Langtrace é uma ferramenta externa e open-source que auxilia na configuração de observabilidade e avaliações para Modelos de Linguagem de Grande Porte (LLMs), frameworks de LLM e Bancos de Dados Vetoriais.
Apesar de não ser integrado diretamente ao CrewAI, o Langtrace pode ser utilizado em conjunto com o CrewAI para fornecer uma visibilidade aprofundada sobre o custo, latência e desempenho dos seus Agentes CrewAI.
Essa integração permite o registro de hiperparâmetros, o monitoramento de regressões de desempenho e o estabelecimento de um processo de melhoria contínua dos seus Agentes.
![Visão geral de uma seleção de execuções de sessões de agentes](/images/langtrace1.png)
![Visão geral dos traces de agentes](/images/langtrace2.png)
![Visão detalhada dos traces de LLM](/images/langtrace3.png)
## Instruções de Configuração
<Steps>
<Step title="Crie uma conta no Langtrace">
Cadastre-se acessando [https://langtrace.ai/signup](https://langtrace.ai/signup).
</Step>
<Step title="Crie um projeto">
Defina o tipo do projeto como `CrewAI` e gere uma chave de API.
</Step>
<Step title="Instale o Langtrace no seu projeto CrewAI">
Use o seguinte comando:
```bash
pip install langtrace-python-sdk
```
</Step>
<Step title="Importe o Langtrace">
Importe e inicialize o Langtrace no início do seu script, antes de quaisquer imports do CrewAI:
```python
from langtrace_python_sdk import langtrace
langtrace.init(api_key='<SUA_CHAVE_LANGTRACE>')
# Agora importe os módulos do CrewAI
from crewai import Agent, Task, Crew
```
</Step>
</Steps>
### Funcionalidades e Sua Aplicação no CrewAI
1. **Rastreamento de Token e Custo do LLM**
- Monitore o uso de tokens e os custos associados para cada interação dos agentes CrewAI.
2. **Gráfico de Trace para Etapas de Execução**
- Visualize o fluxo de execução das suas tarefas CrewAI, incluindo latência e logs.
- Útil para identificar gargalos nos fluxos de trabalho dos seus agentes.
3. **Curadoria de Dataset com Anotação Manual**
- Crie conjuntos de dados a partir das saídas das suas tarefas CrewAI para futuros treinamentos ou avaliações.
4. **Versionamento e Gerenciamento de Prompt**
- Acompanhe as diferentes versões de prompts utilizados em seus agentes CrewAI.
- Útil para testes A/B e otimização de desempenho dos agentes.
5. **Playground de Prompt com Comparações de Modelos**
- Teste e compare diferentes prompts e modelos para seus agentes CrewAI antes da implantação.
6. **Testes e Avaliações**
- Configure testes automatizados para seus agentes e tarefas CrewAI.