데이터 에이전트 만들기 및 관리

데이터 에이전트를 사용하면 사용자를 위한 대화형 분석 환경을 큐레이션할 수 있습니다. 에이전트를 사용하면 대화형 분석에 컨텍스트와 요청 사항을 제공하여 특정 사용 사례에 대해 더 효과적으로 질문에 답변할 수 있습니다. 에이전트를 사용하면 분석가가 비즈니스 용어를 특정 필드에 매핑하고, 필터링에 가장 적합한 필드를 지정하고, 커스텀 계산을 정의할 수 있습니다.

이 페이지에서는 다음 프로세스를 안내합니다.

를 위한 Gemini에서 사용자 데이터를 사용하는 방법과 시점을 알아보세요. Google Cloud

시작하기 전에

데이터 에이전트를 대시보드, Look, 폴더와 같은 다른 유형의 Looker 콘텐츠로 생각하세요.

데이터 에이전트의 사용은 콘텐츠 액세스, 데이터 액세스, 기능 액세스의 조합을 통해 관리됩니다. 다음 표에 설명된 작업을 실행하려면 데이터 에이전트가 쿼리할 모델에 필요한 권한이 있는 Looker 역할과 경우에 따라 에이전트 자체에 대한 액세스 권한이 할당되어야 합니다.

작업 필요한 Looker 권한 필요한 데이터 에이전트 액세스 수준
에이전트 만들기, 수정, 공유, 삭제 25.18에 추가됨 admin_agents 콘텐츠 액세스 권한을 부여해서는 안 됩니다.
에이전트 만들기, 수정, 공유, 삭제 25.18에 추가됨 save_agents

사용자는 기본 모델에 이 권한이 부여된 Explore만 사용하는 에이전트를 만들 수 있습니다. 다른 사용자가 만든 데이터 에이전트를 수정, 삭제 또는 공유하려면 사용자에게 에이전트에서 사용하는 모든 모델에 이 권한이 포함된 역할이 부여되어야 합니다.		 액세스 관리, 수정 (사용자가 에이전트를 만들면 이 액세스 권한이 자동으로 부여됩니다. 그렇지 않으면 에이전트의 생성자가 에이전트를 공유하여 액세스 관리, 수정 액세스 권한을 부여해야 합니다.)
다른 애플리케이션에 에이전트 게시 Google Cloud 26.6에 추가됨 publish_agent_externally

사용자는 기존 에이전트를 Gemini Enterprise와 같은 다른 Google Cloud 애플리케이션에 게시합니다.		 액세스 관리, 수정 (사용자가 에이전트를 만들면 이 액세스 권한이 자동으로 부여됩니다. 그렇지 않으면 에이전트의 생성자가 에이전트를 공유하여 액세스 관리, 수정 액세스 권한을 부여해야 합니다.)
대화형 분석의 에이전트 탭에서 데이터 에이전트와 채팅 access_data (데이터 에이전트에서 사용하는 Explore가 포함된 각 모델에서)

25.18에 추가됨 chat_with_agent (데이터 에이전트에서 사용하는 Explore가 포함된 각 모델에서)		 보기 액세스
대화형 분석의 Explore 탭에서 Looker Explore와 채팅 access_data (데이터 에이전트에서 사용하는 Explore가 포함된 각 모델에서)

25.18에 추가됨 chat_with_explore

Looker에는 인스턴스의 모든 모델에 대해 이러한 권한의 하위 집합이 포함된 다음과 같은 기본 역할도 있습니다.

  • 대화형 분석 에이전트 관리자: 이 역할을 사용하면 사용자가 액세스 관리, 수정 액세스 권한이 있는 에이전트를 만들고, 수정하고, 공유하고, 삭제하고, 채팅할 수 있으며 Explore와 채팅할 수 있습니다.
  • 대화형 분석 사용자: 이 역할을 사용하면 사용자가 보기 액세스 권한이 있는 에이전트와 채팅할 수 있습니다.
  • 관리자: 기본적으로 이 역할 (Looker 관리자)에는 인스턴스 전반에 걸쳐 모든 권한과 콘텐츠 액세스 권한이 있습니다.

Looker 관리자는 Looker 인스턴스의 관리 섹션에 있는 역할 페이지에서 이러한 역할과 권한을 부여할 수 있습니다. Looker 역할에 관한 자세한 내용은 관리자 설정 - 역할 문서 페이지를 참고하세요.

데이터 에이전트의 생성자는 에이전트를 공유하여 에이전트에 대한 개별 사용자의 액세스 권한을 관리할 수 있습니다.

데이터 에이전트 만들기 및 수정

새 데이터 에이전트를 만들려면 다음 단계를 따르세요.

  1. 대화 페이지로 이동합니다.
  2. 에이전트 탭에서 + 새 에이전트를 선택합니다. 또는 왼쪽 패널에서 spark에이전트 관리를 선택한 다음 + 새 에이전트를 선택합니다.

  3. 새 에이전트 페이지에서 데이터 에이전트에 관한 다음 정보를 입력합니다.

    • 에이전트 이름: 에이전트의 이름을 입력합니다. 이름은 고유하고 설명이 포함되어야 합니다.
    • 에이전트 설명: 이 에이전트가 수행할 수 있는 작업과 사용하는 데이터를 간략하게 설명합니다. 사용자가 에이전트를 선택하여 대화를 시작하거나 사용자와 에이전트를 공유할 때 이 설명이 표시되므로 설명에 에이전트의 목적과 도움이 될 수 있는 방법을 명확하게 설명해야 합니다.
    • 데이터: 다음 단계에 따라 최대 5개의 기존 Looker Explore에 연결합니다.
      1. 데이터 필드에서 + Explore 선택 을 클릭합니다.
      2. Explore 검색 창에서 데이터 에이전트에 포함할 Explore를 클릭합니다. 이러한 Explore는 창의 선택된 Explore 패널에 표시됩니다.
      3. 선택한 Explore를 데이터 에이전트에 추가하려면 저장 을 클릭합니다.

  4. 요청 사항: 대화형 분석이 데이터와 상호작용하고 정확하고 관련성 높은 응답을 제공하는 방법을 이해하는 데 도움이 되는 컨텍스트를 제공합니다. 제공할 수 있는 컨텍스트 유형의 예는 에이전트 요청 사항 작성을 참고하세요.

  5. 선택사항으로 에이전트와의 모든 대화에 코드 인터프리터를 사용 설정하려면 고급 분석 사용 설정을 선택합니다.

  6. 선택사항으로 에이전트를 테스트하여 요청 사항과 설정을 세부적으로 조정할 수 있습니다.

  7. 새 데이터 에이전트를 저장하려면 저장 을 클릭합니다.

데이터 에이전트를 저장한 후에는 다른 사용자와 에이전트를 공유하고 에이전트와 대화를 시작할 수 있습니다.

에이전트 요청 사항 작성

데이터 에이전트를 만들 때 데이터 에이전트의 핵심 동작을 정의하고 사용자의 프롬프트를 처리하기 전에 고려해야 할 기본 컨텍스트를 제공하는 자유 형식 요청 사항을 추가할 수 있습니다.

다음은 요청 사항 필드에서 제공할 수 있는 컨텍스트 유형의 예입니다.

  • 주요 필드: 분석에 가장 중요한 필드입니다.
  • 제외된 필드: 데이터 에이전트가 피해야 하는 필드입니다.
  • 필터링 및 그룹화: 에이전트가 데이터를 필터링하고 그룹화하는 데 사용할 필드입니다.
  • 표준 쿼리: 자연어 질문과 상응하는 Explore 쿼리의 쌍입니다.
  • 페르소나: 에이전트에 할당하는 역할 또는 전문성, 성격 또는 어조입니다.

에이전트 요청 사항 작성에 관한 팁과 권장사항은 Looker에서 대화형 분석 구성에 관한 권장사항을 참고하세요.

Looker 표준 쿼리 정의

특정 Explore에 대한 각 Looker 표준 쿼리를 정의하려면 다음 두 필드 모두에 값을 제공합니다.

  • natural_language_questions: 사용자가 물어볼 수 있는 자연어 질문입니다.
  • looker_query: 자연어 질문에 해당하는 Looker 표준 쿼리입니다.

natural_language_questions 필드의 경우 사용자가 해당 Explore에 관해 물어볼 수 있는 질문을 고려하고 자연어로 질문을 작성합니다. 이 필드의 값에 둘 이상의 질문을 포함할 수 있습니다. Explore의 쿼리 메타데이터에서 looker_query 필드의 값을 가져올 수 있습니다.

표준 쿼리는 다음 필드를 지원합니다.

  • model (문자열): 쿼리를 생성하는 데 사용된 LookML 모델입니다. 필수 입력란입니다.
  • explore (문자열): 쿼리를 생성하는 데 사용된 Explore입니다. 필수 입력란입니다.
  • fields[] (문자열): 측정기준 및 측정항목을 포함하여 Explore에서 검색할 필드입니다. 이 필드는 선택 사항입니다.
  • filters[] (문자열): Explore에 적용할 필터입니다. 이 필드는 선택 사항입니다.
  • sorts[] (문자열): Explore에 적용할 정렬입니다. 이 필드는 선택 사항입니다.
  • limit (문자열): Explore에 적용할 데이터 행 제한입니다. 이 필드는 선택 사항입니다.

다음 단계에 따라 Explore에서 직접 Explore의 쿼리 메타데이터를 가져올 수 있습니다.

  1. Explore에서 Explore 작업 메뉴를 선택한 다음 LookML 가져오기를 선택합니다.
  2. 대시보드 탭을 선택합니다.
  3. LookML에서 쿼리 세부정보를 복사합니다. 예를 들어 다음 이미지 는 주문 항목이라는 Explore의 LookML을 보여줍니다.

Looker 표준 쿼리에서 사용할 선택한 메타데이터를 복사합니다.

  model: thelook
  explore: order_items
  fields: [order_items.order_id, orders.status]
  sorts: [orders.status, order_items.order_id]
  limit: 500

에이전트 테스트

에이전트를 만들거나 수정할 때 에이전트 세부정보 페이지에 에이전트 미리보기 창이 포함됩니다. 에이전트와 대화를 시작하여 에이전트 설정과 요청 사항을 테스트할 수 있습니다.

변경사항이 미리보기에 반영되도록 하려면 업데이트 를 클릭해야 합니다. 저장 상태가 Not saved인 경우 설정 업데이트가 미리보기에 반영되지 않습니다.

기존 데이터 에이전트 수정

기존 데이터 에이전트를 수정하려면 다음 단계를 따르세요.

  1. 대화 페이지에서 spark에이전트 관리를 선택합니다.
  2. 에이전트 관리 페이지에서 수정할 데이터 에이전트를 선택합니다.
  3. 필요에 따라 에이전트에 관한 세부정보를 업데이트합니다. 에이전트를 만들 때 지정한 세부정보를 에이전트 이름, 에이전트 설명, 데이터, 요청 사항 필드를 비롯하여 수정할 수 있습니다. 에이전트에 코드 인터프리터를 사용 설정할 수도 있습니다.
  4. 변경사항을 저장하려면 업데이트 를 클릭합니다.

데이터 에이전트 공유

공유를 사용하면 다른 사용자가 에이전트 및 Explore와 채팅할 수 있습니다. 에이전트에 콘텐츠 액세스 권한을 부여하여 다른 사용자와 데이터 에이전트를 공유할 수 있습니다. 적절한 권한과 콘텐츠 액세스 권한이 있는 사용자만 에이전트를 공유할 수 있습니다. 에이전트가 생성되면 공유 가능해지기까지 몇 분 정도 걸릴 수 있습니다.

데이터 에이전트를 공유하려면 다음 단계를 따르세요.

  1. 대화 페이지의 왼쪽 패널에서 spark에이전트 관리를 선택합니다.
  2. 옵션 더보기 아이콘을 클릭하여 선택한 에이전트의 메뉴를 연 다음 공유를 클릭합니다.
  3. 이 에이전트에 액세스할 수 있는 사용자 섹션에 개인 또는 그룹을 추가하고 부여할 권한 수준을 선택한 후 추가 를 클릭하여 공유 목록에 배치합니다.
  4. 새 사용자 또는 그룹이 알림 이메일을 수신하도록 하려면 방금 추가한 사용자에게 이메일 보내기 체크박스를 선택합니다.
  5. 모든 변경사항을 적용한 후 저장 을 클릭합니다.

에이전트 설정 페이지에서 공유 를 클릭하고 앞서 설명한 단계를 따라 방금 만든 에이전트 또는 수정 중인 에이전트를 공유할 수도 있습니다.

데이터 에이전트에 대한 액세스 권한 취소

에이전트에 대한 액세스 권한을 취소하려면 다음 단계를 따르세요.

  1. 대화 페이지의 왼쪽 패널에서 spark에이전트 관리 를 클릭합니다.
  2. 옵션 더보기 아이콘을 클릭하여 선택한 에이전트의 메뉴를 연 다음 공유를 클릭합니다.
  3. 액세스 권한을 삭제해야 하는 사용자 또는 그룹 옆에 있는 X 를 클릭합니다.
  4. 모든 변경사항을 적용한 후 저장 을 클릭합니다.

삭제된 사용자가 진행 중인 대화가 있는 경우 변경사항이 전파되는 동안 1~2분 동안 계속 액세스할 수 있습니다.

사용자가 에이전트에 대한 액세스 권한이 삭제된 후 추가 질문을 하려고 하면 The agent in this conversation may not be shared with you, or may have been deleted. You can view any past conversations with the agent, but can't ask new questions.라는 메시지가 표시됩니다.

데이터 에이전트 게시

Gemini Enterprise에서 데이터 에이전트를 게시하여 Looker 인터페이스에 익숙하지 않은 사용자를 비롯한 더 많은 잠재고객에게 에이전트의 미리 정의된 컨텍스트와 분석을 제공할 수 있습니다. Gemini Enterprise는 사용자가 애플리케이션 전반에서 생성된 데이터 에이전트를 관리할 수 있는 중앙 허브 역할을 하므로 사용자가 분석 요구사항에 가장 적합한 에이전트를 찾는 데 도움이 됩니다. Google Cloud

Looker에서 대화형 분석 데이터 에이전트를 만든 다음 Gemini Enterprise에서 채팅할 수 있도록 게시하는 절차에는 Looker 인스턴스, 콘솔의 Gemini Enterprise 페이지, Gemini Enterprise 인스턴스에서 실행되는 작업이 포함됩니다. Google Cloud

Looker에서 데이터 에이전트를 만들고 Gemini Enterprise의 사용자가 사용할 수 있도록 하려면 괄호 안의 역할이 있는 사용자가 다음 단계를 따라야 합니다. 이 단계는 다음 섹션에 자세히 설명되어 있습니다.

  1. [데이터 에이전트 편집자]: Looker에서 에이전트를 게시합니다.
  2. [검색 엔진 관리자]: 콘솔에서 에이전트를 사용 설정합니다. Google Cloud
  3. [검색 엔진 사용자]: Gemini Enterprise 인스턴스에서 에이전트와 채팅합니다.

시작하기 전에

에이전트를 게시하려면 다음 요구사항을 충족해야 합니다.

Gemini Enterprise에 데이터 에이전트 게시

이 섹션에 설명된 단계를 완료하려면 publish_agent_externally 권한이 포함된 Looker 역할과 데이터 에이전트를 수정할 수 있는 적절한 권한 및 콘텐츠 액세스 권한이 있어야 합니다.

에이전트를 게시하려면 다음 단계를 따르세요.

  1. 에이전트를 수정합니다.
  2. 게시 설정 을 선택하여 에이전트 게시 설정 창을 엽니다.
  3. 에이전트 게시 설정 창에서 Gemini Enterprise 설정을 사용 설정하고 업데이트 를 선택합니다. 이 설정을 사용 설정하면 관리 패널의 Looker의 Gemini 페이지에 표시된 Gemini Enterprise 인스턴스에 에이전트가 게시됩니다.
  4. 에이전트를 게시한 후 공유를 선택하여 다른 Looker 사용자에게 데이터 에이전트에 대한 액세스 권한을 부여하거나 대화 시작을 선택하여 데이터 에이전트와의 새 대화를 열 수 있습니다.

Gemini Enterprise에 에이전트 추가

이 섹션에 설명된 단계를 완료하려면 Gemini Enterprise 엔진이 포함된 Google Cloud 프로젝트에 대한 검색 엔진 관리자 Identity and Access Management 역할이 있어야 합니다.

검색 엔진 관리자는 Google Cloud 콘솔에서 다음 단계를 완료해야 합니다.

  • 에이전트를 Gemini Enterprise 인스턴스로 가져옵니다.
  • 사용자에게 데이터 에이전트에 대한 액세스 권한을 부여합니다.

데이터 에이전트를 Gemini Enterprise 인스턴스로 가져오려면 Google Cloud 콘솔에서 다음 단계를 따르세요.

  1. Gemini Enterprise 엔진이 포함된 Google Cloud 프로젝트로 이동합니다.
  2. Gemini Enterprise 페이지를 엽니다.
  3. 기본 탐색 메뉴에서 에이전트 를 선택합니다.
  4. + 에이전트 추가 를 선택합니다. 그러면 에이전트 추가 창이 열립니다.
  5. 에이전트 추가 창의 에이전트 레지스트리에서 가져오기 에서 에이전트를 찾아 + 사용 설정 을 선택합니다.

사용자에게 데이터 에이전트에 대한 액세스 권한을 부여하려면 에이전트 공유 안내를 따르세요. 사용자가 에이전트에 액세스하고 에이전트와 채팅하려면 검색 엔진 사용자 역할이 부여되어야 합니다.

Gemini Enterprise에서 에이전트와 채팅

이 섹션에 설명된 단계를 완료하려면 Gemini Enterprise 엔진이 포함된 Google Cloud 프로젝트에 대한 검색 엔진 사용자 Identity and Access Management 역할이 있어야 합니다.

Gemini Enterprise 인스턴스에서 데이터 에이전트와 채팅하려면 다음 단계를 따르세요.

  1. Gemini Enterprise 인스턴스를 엽니다.
  2. 기본 탐색 메뉴에서 에이전트 를 선택합니다.
  3. 에이전트 페이지에서 채팅하려는 에이전트를 선택합니다. 에이전트를 선택하면 데이터에 관해 질문할 수 있는 대화창이 열립니다.

데이터 에이전트 삭제

데이터 에이전트를 삭제하려면 다음 단계를 따르세요.

1.대화 페이지의 왼쪽 패널에서 spark에이전트 관리를 클릭합니다. 1. 옵션 더보기 아이콘을 클릭하여 선택한 에이전트의 메뉴를 연 다음 삭제를 클릭합니다. 1. 에이전트를 삭제하시겠습니까? 창에서 휴지통으로 이동 을 클릭하여 데이터 에이전트를 삭제합니다.

휴지통으로 이동된 에이전트는 30일 후에 영구적으로 삭제됩니다. 데이터 에이전트를 수동으로 영구 삭제하거나 영구 삭제되기 전에 휴지통에서 데이터 에이전트를 복원할 수 있습니다. 아무 조치를 취하지 않으면 30일 후에 에이전트가 자동으로 영구 삭제됩니다.

데이터 에이전트 영구 삭제

데이터 에이전트를 영구적으로 삭제하려면 다음 단계를 따르세요.

  1. 대화 페이지로 이동합니다.
  2. 왼쪽 탐색 패널에서 휴지통 섹션을 펼칩니다.
  3. 선택한 에이전트의 메뉴를 열려면 아이콘을 선택한 다음 영구 삭제 를 클릭합니다.
  4. 정말 삭제하시겠습니까? 창에서 완전히 삭제 를 클릭합니다.

휴지통에서 데이터 에이전트 복원

휴지통에서 데이터 에이전트를 복원하려면 다음 단계를 따르세요.

  1. 대화 페이지로 이동합니다.
  2. 왼쪽 탐색 패널에서 휴지통 섹션을 펼칩니다.
  3. 선택한 에이전트의 메뉴를 열려면 아이콘을 선택한 다음 복원 을 클릭합니다.