Integração Maxim

Integração Maxim

Maxim AI oferece monitoramento completo de agentes, avaliação e observabilidade para suas aplicações CrewAI. Com a integração de uma linha do Maxim, você pode facilmente rastrear e analisar interações dos agentes, métricas de desempenho e muito mais.

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

Instale o SDK do Maxim via pip:

pip install maxim-py>=3.6.2

Ou adicione ao seu requirements.txt:

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

É isso! Todas as interações dos seus agentes CrewAI agora serão registradas e estarão disponíveis em seu painel Maxim.

Confira este Google Colab Notebook para referência rápida – Notebook

Visualizando Seus Rastreamentos

Após executar sua aplicação CrewAI:

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

Se você encontrar algum problema:

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