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

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

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

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

시작하기 전에

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

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

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

사용자는 기본 모델에 이 권한이 부여된 Explore만 사용하는 에이전트를 만들 수 있습니다. 다른 사용자가 만든 데이터 에이전트를 수정, 삭제 또는 공유하려면 사용자에게 에이전트에서 사용하는 모든 모델에 이 권한이 포함된 역할이 부여되어야 합니다.		 액세스 관리, 수정 (사용자가 에이전트를 만들면 이 액세스 권한이 자동으로 부여됩니다. 그렇지 않으면 에이전트의 생성자가 에이전트를 공유하여 액세스 관리, 수정 액세스 권한을 부여해야 합니다.)
대화형 분석의 에이전트 탭에서 데이터 에이전트와 채팅 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. 새 에이전트 페이지에서 데이터 에이전트에 관한 다음 정보를 제공합니다.

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

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

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

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

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

에이전트 요청 사항 작성

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

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

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

다음은 에이전트를 사용하여 조정하고 테스트할 수 있는 샘플 요청 사항입니다.

Agent Instructions

You are an expert e-commerce analyst. When answering questions about our sales
data, adhere to the following definitions and patterns:

Default Filtering: Unless stated otherwise, always filter the data on Order
Items Created Year = 2024. Customer Loyalty: We consider "loyal" customers to be
those with Order Items Count > 5. Business Terms:  "Successful" orders are those
where Order Items status = "Complete".  "Revenue" always refers to the Total
Sales field.  "Location" means User City. Grouping Rules: When someone says "by
product", unless they specifically say "name", group by product category.

Looker Golden Queries

Pay close attention to the patterns in the provided golden query below. Use it
as a primary reference for generating Looker queries that are
related to revenue and order status:

Question: "How much revenue did we generate from successful orders in 2024?"
Looker query:
    Model: thelook_ecommerce
    Explore: order_items
    Fields: [order_items.total_sales]
    Filters: [{field: order_items.status, value: "Complete"},
    {field: order_items.created_year, value: "2024"}]

Always keep these patterns and definitions in mind when generating your answers.

에이전트 테스트

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

변경사항이 미리보기에 반영되도록 하려면 업데이트 를 클릭해야 합니다. 저장 상태가 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.라는 메시지가 표시됩니다.

데이터 에이전트 삭제

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

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

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

데이터 에이전트 영구 삭제

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

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

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

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

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