Skip to main content

Telemetria

Por padrão, não coletamos dados que possam ser considerados informações pessoais segundo a GDPR e outras regulamentações de privacidade. Coletamos nomes das ferramentas e funções dos agentes, portanto, evite incluir qualquer informação pessoal nos nomes das ferramentas ou nas funções dos agentes. Como nenhuma informação pessoal é coletada, não é necessário se preocupar com localidade dos dados. Quando share_crew está ativado, dados adicionais são coletados e podem conter informações pessoais caso sejam incluídas pelo usuário. Usuários devem tomar cuidado ao habilitar este recurso para garantir conformidade com regulamentações de privacidade.
O CrewAI utiliza telemetria anônima para coletar estatísticas de uso com o objetivo principal de aprimorar a biblioteca. Nosso foco está em melhorar e desenvolver as funcionalidades, integrações e ferramentas mais utilizadas pelos usuários. É fundamental compreender que, por padrão, NENHUM dado pessoal é coletado referente a prompts, descrições de tarefas, histórias ou objetivos dos agentes, uso de ferramentas, chamadas de API, respostas, quaisquer dados processados pelos agentes ou segredos e variáveis de ambiente. Quando o recurso share_crew está ativado, dados detalhados, incluindo descrições das tarefas, histórias ou objetivos dos agentes e outros atributos específicos são coletados para fornecer insights mais detalhados. Essa coleta expandida pode incluir informações pessoais caso o usuário as tenha inserido em seus crews ou tarefas. Usuários devem considerar cuidadosamente o conteúdo de seus crews e tarefas antes de habilitar o share_crew. A telemetria do CrewAI pode ser desabilitada ao definir CREWAI_DISABLE_TELEMETRY como true, 1, yes ou on (qualquer capitalização). OTEL_SDK_DISABLED com os mesmos valores também desabilita o exportador do CrewAI. O SDK do OpenTelemetry em si ainda só reconhece true para desabilitar as demais instrumentações do processo.

Exemplos:

CREWAI_DISABLE_TELEMETRY=1 (ou yes / on) funciona como true. Valores não reconhecidos são ignorados e a telemetria permanece ligada.

Isolamento da sua própria configuração do OpenTelemetry

A telemetria do CrewAI roda em seu próprio TracerProvider privado e nunca se registra como o provider global. Isso mantém as duas direções separadas:
  • Spans de outras bibliotecas instrumentadas no seu processo — frameworks web, clientes de banco de dados, clientes HTTP — nunca são enviados ao CrewAI.
  • Os spans de telemetria do CrewAI nunca são enviados ao seu backend de observabilidade, portanto não aparecerão no Langfuse, Braintrust, Phoenix ou em qualquer outro coletor que você configurar.
As integrações de observabilidade não são afetadas: elas instrumentam o CrewAI por meio do próprio tracer provider, que é independente do descrito aqui.

Explicação dos Dados:

“Não” na coluna “Padrão” indica que esse dado só é coletado quando share_crew está configurado como true.

Compartilhamento Avançado de Telemetria (Opt-In)

Usuários podem optar por compartilhar toda a telemetria habilitando o atributo share_crew como True nas configurações do seu crew. Ao habilitar share_crew, há coleta detalhada dos dados de execução do crew e das tarefas, incluindo goal, backstory, context e output das tarefas. Isso permite uma compreensão mais profunda dos padrões de uso.
Se você habilitar o share_crew, os dados coletados podem incluir informações pessoais caso estas estejam presentes nas configurações do crew, descrições de tarefas ou outputs. Os usuários devem revisar cuidadosamente seus dados e garantir conformidade com a GDPR e outras regulamentações de privacidade antes de habilitar esse recurso.