​

Integração Maxim

​

Funcionalidades: Integração com Uma Linha

• Rastreamento de Agentes de Ponta a Ponta: Monitore todo o ciclo de vida dos seus agentes
• Análise de Desempenho: Acompanhe latência, tokens consumidos e custos
• Monitoramento de Hiperparâmetros: Visualize detalhes de configuração das execuções dos agentes
• Rastreamento de Chamadas de Ferramentas: Observe quando e como os agentes usam suas ferramentas
• Visualização Avançada: Entenda as trajetórias dos agentes através de dashboards intuitivos

​

Começando

​

Pré-requisitos

• Python versão >=3.10
• Uma conta Maxim (cadastre-se aqui)
• Um projeto CrewAI

​

Instalação

pip install maxim-py>=3.6.2

maxim-py>=3.6.2

​

Configuração Básica

​

1. Configure as variáveis de ambiente

### Configuração de Variáveis de Ambiente

# Crie um arquivo `.env` na raiz do seu projeto:

# Configuração da API Maxim
MAXIM_API_KEY=your_api_key_here
MAXIM_LOG_REPO_ID=your_repo_id_here

​

2. Importe os pacotes necessários

from crewai import Agent, Task, Crew, Process
from maxim import Maxim
from maxim.logger.crewai import instrument_crewai

​

3. Inicialize o Maxim com sua chave de API

# Inicialize o logger do Maxim
logger = Maxim().logger()

# Instrumente o CrewAI com apenas uma linha
instrument_crewai(logger)

​

4. Crie e execute sua aplicação CrewAI normalmente

pesquisador = Agent(
    role='Pesquisador Sênior',
    goal='Descobrir os avanços mais recentes em IA',
    backstory="Você é um pesquisador especialista em um think tank de tecnologia...",
    verbose=True,
    llm=llm
)

# Defina a tarefa
research_task = Task(
    description="Pesquise os avanços mais recentes em IA...",
    expected_output="",
    agent=pesquisador
)

# Configure e execute a crew
crew = Crew(
    agents=[pesquisador],
    tasks=[research_task],
    verbose=True
)

try:
    result = crew.kickoff()
finally:
    maxim.cleanup()  # Garanta o cleanup mesmo em caso de erros

​

Visualizando Seus Rastreamentos

1. Faça login no seu Painel Maxim
2. Navegue até seu repositório
3. Visualize rastreamentos detalhados de agentes, incluindo:
   • Conversas dos agentes
   • Padrões de uso de ferramentas
   • Métricas de desempenho
   • Análises de custos

​

Solução de Problemas

​

Problemas Comuns

• Nenhum rastreamento aparecendo: Certifique-se de que sua chave de API e o ID do repositório estão corretos
• Certifique-se de que você chamou instrument_crewai() antes de executar sua crew. Isso inicializa corretamente os hooks de logging.
• Defina debug=True na chamada do instrument_crewai() para expor erros internos:
  instrument_crewai(logger, debug=True)
  
• Configure seus agentes com verbose=True para capturar logs detalhados:
  
  agent = CrewAgent(..., verbose=True)
  
• Verifique cuidadosamente se instrument_crewai() foi chamado antes de criar ou executar agentes. Isso pode parecer óbvio, mas é um erro comum.

​

Suporte

• Consulte a Documentação do Maxim
• Maxim Github Link