Knowledge Catalog에 연결

이 문서에서는 Gemini Enterprise가 Knowledge Catalog와 통합되어 에이전트에게 사용자가 액세스할 수 있는 데이터를 검색하고 기술 및 비즈니스 컨텍스트를 조회할 수 있는 읽기 전용 도구를 제공하는 방법을 설명합니다.

Knowledge Catalog에 연결하기 위해 별도의 데이터 스토어를 만들 필요가 없습니다. 대신 페더레이션 쿼리 모드에서 BigQuery, Spanner, Cloud SQL 또는 PostgreSQL용 AlloyDB 데이터 스토어를 Gemini Enterprise 앱에 연결하면 Knowledge Catalog 통합이 자동으로 사용 설정됩니다. Knowledge Catalog는 데이터 스토어로 표시되지 않고 Gemini Enterprise 앱의 어시스턴트 탭에 있는 구성 옵션입니다. 또한 컴패니언 데이터 클라우드 커넥터 외부에서도 언제든지 통합을 수동으로 사용 설정하거나 중지할 수 있습니다.

Knowledge Catalog와 데이터 클라우드 커넥터의 연동 방식

Knowledge Catalog에서Google Cloud 환경 전반의 모든 분류된 데이터 애셋은 항목이라는 메타데이터 레코드로 저장됩니다. 페더레이션 쿼리 모드의 데이터 클라우드 커넥터는 단일 데이터 세트나 테이블로 제한되지 않고 인증된 사용자가 볼 수 있는 모든 리소스에 광범위하게 액세스할 수 있으므로 에이전트는 처음에 관련 데이터가 어디에 있는지 알 수 없습니다.

제휴 데이터 클라우드 커넥터를 연결할 때 자동으로 또는 어시스턴트 탭에서 수동으로 Gemini Enterprise 앱에 Knowledge Catalog를 사용 설정하면 통합을 통해 에이전트에 다음을 수행할 수 있는 기본 제공 기술과 읽기 전용 도구가 제공됩니다.

  • 액세스 가능한 데이터 검색: 인증된 사용자가 액세스할 권한이 있는 Knowledge Catalog의 카탈로그화된 데이터 애셋을 검색합니다.
  • 기술 및 비즈니스 컨텍스트 조회: 테이블 스키마, 열 설명, 비즈니스 용어집 용어, 사전 검증된 샘플 쿼리 (골든 쿼리)를 포함한 보강된 메타데이터를 검색합니다. 컴패니언 데이터 클라우드 커넥터와 페어링하면 에이전트는 이러한 표준 쿼리를 사용하여 복잡한 스키마에서 조인 할루시네이션을 방지하고 이 컨텍스트를 커넥터에 전달하여 정확한 쿼리를 생성하고 실행합니다.

워크플로 예시

다음 다이어그램은 Knowledge Catalog와 제휴 데이터 클라우드 커넥터가 함께 작동하여 사용자의 질문에 답하는 방식을 보여줍니다.

사용자 질문에서 Knowledge Catalog 시맨틱 검색 및 컨텍스트 검색, BigQuery SQL 쿼리 실행에 이르는 4단계 워크플로를 보여주는 다이어그램

이 워크플로에서 Gemini Enterprise는 다음 단계를 완료합니다.

  1. 사용자 질문: 사용자가 Gemini Enterprise에서 자연어로 질문합니다.

    "How many sales did we have this month for all cold weather products?"
    
  2. 시맨틱 검색 탐색: Gemini Enterprise 루트 에이전트는 사용자의 질문에서 추출한 검색어를 사용하여 Knowledge Catalog를 검색합니다.

    ["cold weather", "products", "orders", "sales"]
    
  3. 컨텍스트 검색: 사용자가 액세스할 수 있는 일치하는 항목에 대해 에이전트는 기술 메타데이터, 사용 패턴, 비즈니스 용어집, LLM 추론에서 파생된 Knowledge Catalog의 보강된 컨텍스트를 조회합니다.

    simpleName: my-project.ecomm.products
    type: BigQuery Table
    terms: "Cold Weather Products; category IN ('Sweaters', 'Coats & Jackets')"
    
  4. 쿼리 실행: 검색된 테이블 메타데이터와 비즈니스 정의를 사용하여 에이전트는 제휴 BigQuery 커넥터를 통해 읽기 전용 SQL 쿼리를 작성하고 실행합니다.

    -- Execute BigQuery read-only SQL
    SELECT COUNT(order_id) FROM `my-project.ecomm.orders`
    WHERE product_id IN (
      SELECT id FROM `my-project.ecomm.products`
      WHERE category IN ('Sweaters', 'Coats & Jackets')
    );
    

시작하기 전에

지식 카탈로그 통합은 읽기 전용이며 내부 API를 사용하므로 Dataplex API를 사용 설정하거나 MCP 도구 권한을 부여할 필요가 없으며 사용자는 Knowledge Catalog에서 리소스를 만들거나 수정할 권한이 필요하지 않습니다.

통합은 최종 사용자 인증 정보를 사용하여 요청을 인증하므로 에이전트는 인증된 사용자에게 Identity and Access Management (IAM) 보기 권한이 있는 데이터 애셋만 찾고 검색할 수 있습니다.

  • 검색 결과 자르기를 통한 메타데이터 및 데이터 액세스 분리: Knowledge Catalog는 기본 데이터 소스에서 인증된 사용자의 권한에 따라 검색 결과 자르기를 적용합니다. 사용자에게 데이터 세트 또는 테이블에 대한 읽기 권한 (예: roles/bigquery.dataViewer 또는 roles/bigquery.metadataViewer)이 없으면 해당 애셋은 카탈로그 검색 결과에서 자동으로 필터링되며 어시스턴트가 검색할 수 없습니다.
  • 퍼스트 파티 Google Cloud 데이터 소스: BigQuery, PostgreSQL용 AlloyDB, Spanner, Cloud SQL과 같은 퍼스트 파티 데이터 소스에 대한 권한은 자동으로 상속됩니다. 예를 들어 사용자에게 BigQuery 데이터 뷰어(roles/bigquery.dataViewer) 역할을 부여하면 Knowledge Catalog에서 해당 테이블 및 데이터 세트 메타데이터를 검색하고 탐색할 수 있는 액세스 권한이 부여됩니다.
  • 추가 메타데이터 및 서드 파티 데이터 소스: Knowledge Catalog에 추가된 커스텀 메타데이터, 비즈니스 용어집 또는 서드 파티 데이터 애셋의 경우 에이전트가 해당 데이터를 검색할 수 있도록 사용자에게 Knowledge Catalog에 필요한 보기 권한 (예: roles/dataplex.dataDomainEntryReader 또는 roles/dataplex.catalogViewer)이 있는지 확인합니다. 자세한 내용은 Knowledge Catalog 문서의 IAM으로 액세스 관리를 참조하세요.

앱에서 Knowledge Catalog 사용 설정 또는 사용 중지

페더레이션 쿼리 모드에서 BigQuery, Spanner, Cloud SQL 또는 PostgreSQL용 AlloyDB 데이터 스토어를 Gemini Enterprise 앱에 연결하면 Knowledge Catalog 및 기본 제공 에이전트 스킬이 앱에 자동으로 사용 설정됩니다.

앱의 구성 페이지에 있는 어시스턴트 탭에서 언제든지 Knowledge Catalog 통합을 수동으로 사용 설정하거나 중지할 수 있습니다. 이는 컴패니언 데이터 클라우드 커넥터 외부에서도 가능합니다 (예: 데이터 클라우드 커넥터를 연결하지 않고 Knowledge Catalog를 사용 설정하거나 데이터 클라우드 커넥터를 활성 상태로 유지하면서 사용 중지하는 경우).

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

    Gemini Enterprise

  2. 구성하려는 앱의 이름을 클릭합니다.

  3. 구성을 클릭한 다음 어시스턴트 탭을 선택합니다.

  4. Knowledge Catalog 사용 설정 섹션에서 전환 버튼을 사용하여 Knowledge Catalog 통합을 사용 설정 또는 중지합니다.

  5. Save and publish(저장 및 출시)를 클릭합니다.

어시스턴트 설정에 대한 자세한 내용은 어시스턴트 구성을 참조하세요.

다음 단계