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. 컨텍스트 가져오기: 사용자가 액세스할 수 있는 일치하는 항목의 경우 에이전트가 Knowledge Catalog에서 보강된 컨텍스트를 조회합니다(기술 메타데이터, 사용 패턴, 비즈니스 용어집, LLM 추론에서 파생됨).

    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')
);

시작하기 전에

Knowledge Catalog 통합은 읽기 전용이며 내부 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 통합을 수동으로 사용 설정 또는 중지할 수 있습니다. 예를 들어 Data Cloud 커넥터를 연결하지 않고 Knowledge Catalog를 사용 설정하거나 Data Cloud 커넥터를 활성 상태로 유지하면서 Knowledge Catalog를 사용 중지할 수 있습니다.

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

    Gemini Enterprise

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

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

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

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

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

다음 단계