Telemetry
CrewAI에서 수집하는 텔레메트리 데이터와 이 데이터가 라이브러리 개선에 어떻게 기여하는지 이해하기
원격 측정(Telemetry)
기본적으로 GDPR 및 기타 개인정보 보호 규정에 따라 개인정보로 간주될 수 있는 데이터는 수집하지 않는다.
툴 이름과 에이전트 역할은 수집하므로, 툴 이름이나 에이전트 역할에 개인정보를 포함하지 않도록 주의해야 한다.
개인정보를 수집하지 않기 때문에 데이터 거주지에 대해 걱정할 필요가 없다.
share_crew가 활성화되면, 사용자가 포함한 경우 개인정보를 포함할 수 있는 추가 데이터가 수집된다.
이 기능을 활성화할 때는 개인정보 보호 규정 준수를 위해 주의를 기울여야 한다.
CrewAI는 라이브러리 개선을 목적으로 익명 원격 측정을 활용해 사용 통계를 수집한다. 주요 관심사는 사용자가 가장 많이 활용하는 기능, 통합, 툴을 개선하고 개발하는 것이다.
기본적으로 개인 데이터를 수집하지 않는다 는 점을 이해하는 것이 중요하다. 이는 프롬프트, 작업 설명, 에이전트 배경이나 목표,
툴 사용, API 호출, 응답, 에이전트가 처리한 데이터, 비밀 및 환경 변수 등에 해당한다.
share_crew 기능이 활성화되면, 작업 설명, 에이전트 배경이나 목표, 기타 특정 속성 등 상세 데이터가 수집되어
더 깊은 통찰을 제공한다. 이 확장된 데이터 수집은 사용자가 크루나 작업에 개인정보를 포함한 경우 이를 포함할 수 있다.
share_crew를 활성화하기 전에 크루와 작업의 내용을 신중히 고려해야 한다.
사용자는 환경 변수 OTEL_SDK_DISABLED를 true로 설정해 원격 측정을 비활성화할 수 있다.
데이터 설명:
| 기본 수집 여부 | 데이터 | 이유 및 세부 사항 |
|---|---|---|
| 예 | CrewAI 및 Python 버전 | 소프트웨어 버전을 추적한다. 예: CrewAI v1.2.3, Python 3.8.10. 개인 데이터는 포함되지 않는다. |
| 예 | Crew 메타데이터 | 포함 사항: 무작위로 생성된 키와 ID, 프로세스 타입(예: ‘sequential’, ‘parallel’), 메모리 사용 여부를 나타내는 불리언 플래그(true/false), 태스크 수, 에이전트 수. 모두 비개인적 데이터다. |
| 예 | 에이전트 데이터 | 포함 사항: 무작위로 생성된 키와 ID, 역할 이름(개인 정보 포함 금지), 불리언 설정(verbose, delegation enabled, code execution allowed), 최대 반복 횟수, 최대 RPM, 최대 재시도 횟수, LLM 정보(LLM 속성 참조), 도구 이름 목록(개인 정보 포함 금지). 개인 데이터는 없다. |
| 예 | 태스크 메타데이터 | 포함 사항: 무작위로 생성된 키와 ID, 불리언 실행 설정(async_execution, human_input), 관련 에이전트의 역할과 키, 도구 이름 목록. 모두 비개인적 데이터다. |
| 예 | 도구 사용 통계 | 포함 사항: 도구 이름(개인 정보 포함 금지), 사용 시도 횟수(정수), 사용된 LLM 속성. 개인 데이터는 없다. |
| 예 | 테스트 실행 데이터 | 포함 사항: crew의 무작위로 생성된 키와 ID, 반복 횟수, 사용된 모델 이름, 품질 점수(실수), 실행 시간(초 단위). 모두 비개인적 데이터다. |
| 예 | 태스크 라이프사이클 데이터 | 포함 사항: 생성 및 실행 시작/종료 시간, crew와 태스크 식별자. 타임스탬프가 포함된 스팬으로 저장된다. 개인 데이터는 없다. |
| 예 | LLM 속성 | 포함 사항: 이름, model_name, model, top_k, temperature, LLM의 클래스 이름. 모두 기술적이고 비개인적 데이터다. |
| 예 | crewAI CLI를 통한 Crew 배포 시도 | 포함 사항: 배포 시도 여부와 crew ID, 로그를 가져오려는 시도 여부. 그 외 데이터는 없다. |
| 아니오 | 에이전트의 상세 데이터 | 포함 사항: 목표 설명, 배경 스토리 텍스트, i18n 프롬프트 파일 식별자. 사용자는 텍스트 필드에 개인 정보가 포함되지 않도록 해야 한다. |
| 아니오 | 상세 태스크 정보 | 포함 사항: 태스크 설명, 예상 출력 설명, 컨텍스트 참조. 사용자는 이 필드에 개인 정보가 포함되지 않도록 해야 한다. |
| 아니오 | 환경 정보 | 포함 사항: 플랫폼, 릴리스, 시스템, 버전, CPU 수. 예: ‘Windows 10’, ‘x86_64’. 개인 데이터는 없다. |
| 아니오 | Crew 및 태스크 입력과 출력 | 포함 사항: 입력 매개변수와 출력 결과를 비식별 데이터로 포함. 사용자는 개인 정보가 포함되지 않도록 해야 한다. |
| 아니오 | 상세 Crew 실행 데이터 | 포함 사항: crew 작업의 상세 로그, 모든 에이전트와 태스크 데이터, 최종 출력. 모두 비개인적이고 기술적인 성격을 가진다. |
추가 원격 측정 데이터 공유 옵션
사용자는 crew 설정에서 share_crew 속성을 True로 설정해 전체 원격 측정 데이터를 공유할 수 있다.
share_crew를 활성화하면 goal, backstory, context, output 등 작업 실행 데이터를 포함한 상세한 크루 정보가 수집된다.
이를 통해 사용 패턴을 더 깊이 있게 분석할 수 있다.
share_crew를 활성화하면 크루 설정, 작업 설명, 출력 결과에 개인 정보가 포함될 수 있다.
이 기능을 사용하기 전에 데이터를 꼼꼼히 확인하고 GDPR 및 기타 개인정보 보호 규정을 준수해야 한다.