컨텍스트 세트 관리

컨텍스트 세트를 사용하면 시맨틱 정보 및 데이터 애셋 참조의 제한된 컨테이너를 사용하여 AI 에이전트를 그라운딩할 수 있습니다. 이러한 컨테이너의 작동 방식에 대한 자세한 내용은 컨텍스트 세트 개요를 참조하세요.

보강 태스크를 실행하기 전에 컨텍스트 집합을 구성해야 합니다. 보강 태스크는 데이터 세트 스키마와 문서를 지속적으로 분석하여 데이터 애셋에 대해 제안된 메타데이터를 생성하는 자율 에이전트입니다.

컨텍스트 세트는 독립형 컨테이너로 구성하거나 보강 작업 설정의 일부로 구성할 수 있습니다. 작업 설정 중에 컨텍스트 집합을 만드는 방법에 대한 자세한 내용은 보강 작업 만들기를 참조하세요.

시작하기 전에

컨텍스트 세트를 관리하기 전에 필요한 IAM 역할이 있는지 확인하세요.

필요한 역할

컨텍스트 세트를 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 컨텍스트 세트 만들기: Dataplex 카탈로그 관리자 (roles/dataplex.catalogAdmin) 또는 Dataplex 항목 그룹 소유자 (roles/dataplex.entryGroupOwner). 이러한 역할에는 컨텍스트 세트를 만드는 동안 소유자 권한을 자동으로 부여하는 데 필요한 dataplex.entryGroups.setIamPolicy 권한이 포함됩니다.
  • 컨텍스트 세트 수정 또는 삭제: Dataplex 카탈로그 관리자(roles/dataplex.catalogAdmin) 또는 Dataplex 카탈로그 편집자(roles/dataplex.catalogEditor)

컨텍스트 세트 만들기

보강된 메타데이터를 저장할 빈 컨텍스트 세트를 만들려면 다음을 수행합니다.

Knowledge Studio

  1. Google Cloud 콘솔에서 Knowledge Studio 페이지로 이동합니다.

    Knowledge Studio로 이동

  2. 왼쪽 탐색창에서 컨텍스트 세트를 선택합니다.

  3. 컨텍스트 세트 페이지에서 만들기를 클릭합니다.

  4. 컨텍스트 세트 만들기 창에서 표시 이름 필드에 이름을 입력하고 컨텍스트 세트 ID 필드에 ID를 입력합니다.

  5. 선택사항: 설명을 입력하고 위치를 선택하고 라벨을 추가합니다.

  6. 저장을 클릭합니다.

메타데이터 유형

  1. Google Cloud 콘솔에서 메타데이터 유형 페이지로 이동합니다.

    메타데이터 유형으로 이동

  2. 항목 그룹 > 컨텍스트 세트를 클릭합니다.

  3. 메타데이터 유형 페이지에서 만들기를 클릭합니다.

  4. 컨텍스트 세트 만들기 창에서 표시 이름 필드에 이름을 입력하고 컨텍스트 세트 ID 필드에 ID를 입력합니다.

  5. 선택사항: 설명을 입력하고 위치를 선택하고 라벨을 추가합니다.

  6. 저장을 클릭합니다.

컨텍스트 집합을 만든 후 보강 태스크의 대상으로 선택할 수 있습니다. 보강 실행은 AI가 제안한 메타데이터 개념, 시맨틱 연결, 수식으로 이 컨테이너를 채웁니다.

보강 태스크에 대한 자세한 내용은 보강 태스크 정보를 참조하세요.

컨텍스트 세트 보기

기존 컨텍스트 세트를 보려면 다음을 수행합니다.

Knowledge Studio

  1. Google Cloud 콘솔에서 Knowledge Studio 페이지로 이동합니다.

    Knowledge Studio로 이동

  2. 왼쪽 탐색창에서 컨텍스트 세트를 선택합니다.

  3. 특정 컨텍스트 세트의 세부정보를 보려면 목록에서 이름을 클릭합니다.

메타데이터 유형

  1. Google Cloud 콘솔에서 메타데이터 유형 페이지로 이동합니다.

    메타데이터 유형으로 이동

  2. 항목 그룹 > 컨텍스트 세트를 클릭합니다.

  3. 특정 컨텍스트 세트의 세부정보를 보려면 목록에서 이름을 클릭합니다.

세부정보 페이지에는 설명, 위치, 프로젝트 ID와 같은 컨텍스트 세트의 속성이 표시됩니다. 또한 컨텍스트 세트 내에 저장된 보강된 메타데이터 항목의 미리보기를 나열하고 검색에서 모든 관련 항목을 볼 수 있는 버튼을 제공하는 샘플 항목 섹션도 포함되어 있습니다.

컨텍스트 세트 수정

Google Cloud 콘솔을 사용하여 컨텍스트 세트의 컨테이너 속성(표시 이름, 설명, 라벨 포함)을 수정할 수 있습니다.

컨텍스트 세트 내의 보강된 메타데이터 콘텐츠를 업데이트하려면 해당 세트를 타겟팅하는 보강 작업을 실행하고 생성된 변경 제안을 승인해야 합니다. 변경 제안 승인에 대한 자세한 내용은 보강 실행 관리를 참조하세요.

컨텍스트 세트의 속성을 수정하려면 다음 단계를 따르세요.

Knowledge Studio

  1. Google Cloud 콘솔에서 Knowledge Studio 페이지로 이동합니다.

    Knowledge Studio로 이동

  2. 왼쪽 탐색창에서 컨텍스트 세트를 선택합니다.

  3. 수정하려는 컨텍스트 집합의 이름을 클릭합니다.

  4. 세부정보 페이지에서 수정을 클릭합니다.

  5. 수정 가능한 필드 (표시 이름, 설명 또는 라벨)를 수정한 후 저장을 클릭합니다.

메타데이터 유형

  1. Google Cloud 콘솔에서 메타데이터 유형 페이지로 이동합니다.

    메타데이터 유형으로 이동

  2. 항목 그룹 > 컨텍스트 세트를 클릭합니다.

  3. 메타데이터 유형 페이지에서 수정할 컨텍스트 집합의 이름을 클릭합니다.

  4. 세부정보 페이지에서 수정을 클릭합니다.

  5. 수정 가능한 필드 (표시 이름, 설명 또는 라벨)를 수정한 후 저장을 클릭합니다.

컨텍스트 세트 삭제

컨텍스트 세트를 삭제하면 데이터 컨텍스트 그래프에서 시맨틱 연결이 삭제됩니다. 보강 실행이 활성 상태인 동안 컨텍스트 집합을 삭제하면 대상 위치를 더 이상 사용할 수 없으므로 실행이 완료될 때 제안된 메타데이터를 저장할 수 없습니다. 유효한 컨텍스트 세트로 출력하도록 작업을 업데이트할 때까지 보강 작업의 후속 실행도 실패합니다.

컨텍스트 세트를 삭제하려면 다음 단계를 따르세요.

Knowledge Studio

  1. Google Cloud 콘솔에서 Knowledge Studio 페이지로 이동합니다.

    Knowledge Studio로 이동

  2. 왼쪽 탐색창에서 컨텍스트 세트를 선택합니다.

  3. 목록에서 삭제하려는 컨텍스트 세트의 이름을 클릭합니다.

  4. 세부정보 페이지에서 삭제를 클릭합니다.

  5. 삭제를 확인합니다.

메타데이터 유형

  1. Google Cloud 콘솔에서 메타데이터 유형 페이지로 이동합니다.

    메타데이터 유형으로 이동

  2. 항목 그룹 > 컨텍스트 세트를 클릭합니다.

  3. 목록에서 삭제하려는 컨텍스트 세트의 이름을 클릭합니다.

  4. 세부정보 페이지에서 삭제를 클릭합니다.

  5. 삭제를 확인합니다.

제한사항

프리뷰 중에 적용되는 제한사항에 대한 자세한 내용은 프리뷰 경계를 참조하세요.

다음 단계

자세한 내용은 다음을 참조하세요.