이 가이드는 AI 및 GitLab Duo 기능을 위한 이벤트 정의에 classification: duo 필드를 올바르게 추가하는 방법을 설명합니다.

classification 필드란 무엇인가요?#

classification 필드는 데이터 처리 요구 사항에 따라 이벤트를 분류하는 이벤트 정의의 선택적 속성입니다. 현재 지원되는 유일한 값은 duo이며, 이는 AI 및 GitLab Duo 관련 기능에 특별히 사용됩니다.

classification: duo를 사용하는 경우#

다음의 경우 이벤트 정의에 classification: duo를 추가합니다:

• AI 또는 GitLab Duo 기능을 계측하는 경우 (예: GitLab Duo Chat, GitLab Duo Workflow, AI 기반 제안)
• 이벤트가 다음과 같은 AI 엔지니어링 제품 그룹에 속하는 경우:
  • duo_chat
  • ai_framework
  • duo_agent_framework
  • 기타 AI 관련 제품 그룹
• 이벤트 데이터가 GitLab Self-Managed 인스턴스의 운영 데이터로 간주되어야 하는 경우

classification: duo를 사용하지 말아야 하는 경우#

중요: 다음의 경우에는 classification: duo를 추가하지 마세요:

• 이벤트가 AI 또는 GitLab Duo 기능과 관련이 없는 경우
• AI와 관련 없는 일반 GitLab 기능을 계측하는 경우

이벤트가 GitLab Duo 기능에 해당하지 않으면 classification 필드를 빈 채로 두지 말고 완전히 제거하세요.

데이터 처리 의미#

classification: duo가 있는 이벤트는 운영 데이터로 처리됩니다. 즉:

• 분석 데이터 수집이 거부된 경우에도 GitLab Self-Managed 인스턴스를 통해 흐릅니다
• 이는 필수 AI 기능 및 모니터링이 계속 작동하도록 보장합니다
• 데이터는 순수하게 분석적인 목적이 아닌 운영 목적에 필요한 것으로 간주됩니다

classification: duo를 사용한 이벤트 정의 예시#

다음은 올바르게 구성된 GitLab Duo Chat 이벤트의 예시입니다:

---
description: "User submits a Duo Chat message.
  The message is analyzed using LLM (e.g. categorization) and Ruby (e.g. message length).
  Schema: https://gitlab.com/gitlab-org/iglu/-/blob/master/public/schemas/com.gitlab/ai_question_category/jsonschema
  Category list: https://gitlab.com/gitlab-org/gitlab/-/blob/master/ee/lib/gitlab/llm/fixtures/categories.xml"
category: Gitlab::Llm::AiGateway::Completions::CategorizeQuestion
action: ai_question_category
classification: duo
identifiers:
  - user
product_group: duo_chat
milestone: '16.6'
introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/132803
tiers:
  - ultimate
additional_properties:
  property:
    description: Request ID to link to other events of the same AI request.

외부 서비스에 GitLab Duo 이벤트 추가#

모노리스를 통해 전달되는 다른 서비스에서 정의된 이벤트는 EventEligibilityChecker의 목록에 추가해야 합니다.

이를 통해 분석 데이터 수집이 거부된 경우에도 이벤트가 인스턴스를 통해 전달되도록 합니다.

GitLab Duo Workflow 이벤트#

---
description: Tracks duo workflow start event
internal_events: true
action: start_duo_workflow_execution
classification: duo
identifiers:
- user
- project
- namespace
product_group: duo_agent_framework
milestone: '17.0'
introduced_by_url: https://gitlab.com/gitlab-org/gitlab/-/merge_requests/150000
tiers:
- ultimate

유효성 검사#

classification 필드는 JSON Schema에 대해 유효성 검사됩니다. 현재 duo만 유효한 값으로 허용됩니다.