LookML 대시보드 데이터 에이전트 만들기 및 관리

Gemini for Google Cloud를 기반으로 하는 대화형 분석을 사용하면 직관적인 채팅 인터페이스를 통해 대화형 언어로 질문하여 데이터를 조사할 수 있습니다. LookML 대시보드에서 대화형 분석을 사용하면 버전 제어 LookML 코드에서 직접 대시보드 데이터 에이전트를 정의하고 맞춤설정할 수 있습니다.

LookML 대시보드 에이전트를 사용하면 개발자가 맞춤형 비즈니스 로직, 맞춤 안내, 분석 설정을 LookML 관리 대시보드에 삽입할 수 있습니다. LookML 대시보드는 조직 전반에서 관리되는 버전 제어된 신뢰할 수 있는 소스를 나타내므로 LookML 대시보드 에이전트는 AI 상호작용이 환경 전반에서 일관되게 유지되고 조직 데이터 표준을 준수하도록 합니다.

이 페이지에서는 다음 주제에 대해 설명합니다.

시작하기 전에

LookML 대시보드 에이전트를 구성하거나 사용하려면 다음 요구사항을 충족해야 합니다.

  • 인스턴스 요구사항: Looker 관리자는 Looker의 Gemini 관리 페이지에서 대화형 분석을 사용 설정해야 합니다. 관리자는 신뢰할 수 있는 테스터 기능 사용 설정 및 대시보드 에이전트 사용 설정 설정도 사용 설정해야 합니다. 대시보드 에이전트의 고급 분석인 고급 분석 관리 설정도 사용 설정해야 합니다. 이 설정은 Looker 26.14의 LookML 대시보드 에이전트에 적용되지 않습니다.
  • 개발자 권한: LookML 대시보드 에이전트 및 대시보드를 만들거나 수정하거나 구성하려면 대시보드의 기본 LookML 모델에 대한 액세스 권한과 함께 develop 및 see_lookml_dashboards 권한이 있는 Looker 역할이 있어야 합니다.
  • 뷰어 권한: LookML 대시보드 에이전트와 채팅하려면 사용자에게 see_lookml_dashboards 권한과 대시보드 타일의 기본 LookML 모델에 대한 액세스 권한이 있어야 합니다.

LookML에서 대시보드 에이전트 정의

LookML에서 대시보드 에이전트를 정의하려면 LookML 모델 파일 또는 프로젝트 내의 전용 LookML 파일에서 agent 매개변수를 선언합니다.

LookML 대시보드 에이전트 정의는 다음 문법을 사용합니다.

agent: agent_name {
  advanced_analytics: yes | no
  description: "Description of the agent"
  instructions: "Custom agent prompt and instructions"
  is_dashboard_agent: yes
  show_debuginfo: yes | no
  show_thinking: yes | no
}

대시보드 에이전트는 다음 LookML 매개변수를 지원합니다.

  • agent: 새 에이전트를 선언하고 이름을 정의합니다.
  • advanced_analytics: (선택사항) yes 또는 no (기본값은 no)를 허용합니다. yes로 설정하면 에이전트가 고급 분석 을 사용하여 자연어 질문을 Python 코드로 변환하고 고급 계산 및 시각화를 위해 해당 코드를 실행할 수 있습니다. 이 매개변수는 LookML 대시보드 에이전트에 사용할 수 있지만 Looker 26.14에서는 작동하지 않습니다.
  • description: (선택사항) 에이전트에 대한 간략한 설명입니다.
  • instructions: (선택사항) 쿼리에 답변할 때 에이전트를 안내하는 자유 형식 안내 및 비즈니스 컨텍스트를 제공하는 문자열입니다. 생략하면 에이전트는 맞춤 프롬프트 컨텍스트 없이 기본 대화형 처리를 사용합니다.
  • is_dashboard_agent: (대시보드 에이전트에 필요) 에이전트를 대시보드 에이전트로 구체적으로 식별하려면 yes로 설정합니다.
  • show_debuginfo: (선택사항) yes 또는 no (기본값은 no)를 허용합니다. yes로 설정하면 에이전트가 대화 응답에 자세한 실행 및 문제 해결 정보를 표시합니다.
  • show_thinking: (선택사항) yes 또는 no (기본값은 no)를 허용합니다. yes로 설정하면 에이전트가 대화 응답에 단계별 추론 프로세스를 표시합니다.

대시보드 에이전트 정의 예

다음 예에서는 특정 필터링 규칙과 톤을 적용하는 LookML 대시보드 에이전트를 정의합니다.

agent: sales_dashboard_agent {
  instructions: "Focus on revenue metrics. Always filter by the current fiscal year unless the user specifies otherwise."
  description: "LookML Dashboard Agent for sales performance analytics."
  is_dashboard_agent: yes
  advanced_analytics: yes
  show_thinking: yes
  show_debuginfo: no
}

에이전트 안내에서 LookML 상수 사용

조직 전반에서 여러 LookML 대시보드를 관리하는 경우 LookML 상수를 사용하여 표준 비즈니스 규칙, 용어집 또는 에이전트 전반의 필터링 요구사항 정의를 텍스트를 중복하지 않고 공유할 수 있습니다.

에이전트 안내에서 상수를 사용하려면 다음 단계를 따르세요.

  1. 프로젝트의 manifest.lkml 파일에서 상수를 정의합니다.

    constant: FISCAL_YEAR_RULE {
  value: "Always filter all requests by the current fiscal year unless the user explicitly specifies a different timeframe."
}

  2. 대시보드 에이전트의 instructions 매개변수에서 상수를 참조합니다 using @{<var>CONSTANT_NAME</var>} 문법:

    agent: finance_dashboard_agent {
  instructions: "Prioritize gross margin and operating expense metrics. @{FISCAL_YEAR_RULE}"
  is_dashboard_agent: yes
  advanced_analytics: yes
}

에이전트가 쿼리를 처리할 때 Looker는 상수 문자열을 에이전트 안내에 동적으로 대체합니다.

LookML 대시보드에 대시보드 에이전트 연결

대시보드 에이전트를 LookML 대시보드에 연결하려면 .dashboard.lookml 파일에서 대시보드 수준 매개변수를 구성합니다.

다음 대시보드 매개변수는 LookML 대시보드의 에이전트 동작을 제어합니다.

  • enable_dashboard_agent: (선택사항) true 또는 false를 허용합니다. 사용자가 스파크 이 대시보드와 채팅 아이콘을 보고 대시보드 에이전트와 상호작용할 수 있는지 여부를 결정합니다. 생략하면 이 매개변수는 API 레이어에서 기본적으로 true로 설정됩니다.
  • default_dashboard_agent: (선택사항) 대시보드의 기본 에이전트 역할을 하는 LookML 에이전트 (agent 매개변수로 정의됨)의 이름을 지정합니다.
  • dashboard_agents: (선택사항) 대시보드에 사용할 수 있는 에이전트 이름 목록입니다.

LookML 대시보드 구성 예

다음 스니펫은 sales_dashboard_agent를 LookML 대시보드에 매핑하는 방법을 보여줍니다.

- dashboard: executive_sales_overview
  title: "Executive Sales Overview"
  layout: newspaper
  enable_dashboard_agent: true
  default_dashboard_agent: sales_dashboard_agent
  dashboard_agents: [sales_dashboard_agent, regional_sales_agent]

  elements:
  - name: total_revenue_by_quarter
    type: looker_column
    model: sales_ops
    explore: orders
    measures: [orders.total_revenue]
    dimensions: [orders.created_quarter]

enable_dashboard_agent가 true로 설정되고 default_dashboard_agent가 지정되지 않은 경우 사용자는 여전히 대시보드와 채팅할 수 있습니다. 에이전트는 맞춤 안내 없이 실행됩니다.

개발 모드에서 LookML 대시보드 에이전트 테스트

LookML 개발자는 변경사항을 프로덕션에 배포하기 전에 Looker UI에서 직접 에이전트 안내를 반복적으로 수정하고 응답을 테스트할 수 있습니다.

개발 모드에서 LookML 대시보드 에이전트를 테스트하려면 다음 단계를 따르세요.

  1. 개발 모드를 사용 설정합니다.
  2. LookML 파일에서 에이전트 instructions 또는 설정을 수정하고 변경사항을 저장합니다.
  3. Looker UI에서 LookML 대시보드를 엽니다.
  4. 스파크 이 대시보드와 채팅을 선택하여 채팅 패널을 엽니다.
  5. 에이전트가 프롬프트를 해석하고 응답하는 방식을 테스트하는 질문을 합니다.

개발 모드가 사용 설정되면 대화형 분석은 개발 브랜치의 인메모리 에이전트 정의, LookML 대시보드 정의, 모델 파일을 참조합니다. 개발 모드를 사용 중지하면 대화형 분석은 프로덕션 브랜치에서 배포된 정의를 참조하도록 되돌아갑니다.

개발 모드 중에 생성된 대화 기록은 지속되며 세션 전반에서 최근 대화 목록에 표시됩니다.

사용자 정의 대시보드에서 대시보드 에이전트 LookML 복사

UI에서 대시보드를 사용자 정의 대시보드로 프로토타입하는 경우 대시보드 에이전트 설정 및 안내를 포함한 전체 구성을 LookML 코드로 내보낼 수 있습니다.

사용자 정의 대시보드에서 LookML을 복사하려면 다음 단계를 따르세요.

  1. 사용자 정의 대시보드를 엽니다.
  2. 점 3개로 된 more_vert 대시보드 작업 메뉴를 선택한 후 LookML 가져오기 를 선택합니다.
  3. LookML 가져오기 대화상자에서 생성된 대시보드 LookML과 대시보드 에이전트 정의 코드를 복사합니다.
  4. 대시보드 LookML을 .dashboard.lookml 파일에 붙여넣고 agent 블록을 모델 또는 에이전트 LookML 파일에 붙여넣습니다.

내보낸 LookML은 enable_dashboard_agent 매개변수를 사용하여 대시보드와 채팅 사용 설정 전환 버튼의 상태를 유지하고 모든 맞춤 에이전트 안내를 복사합니다.

Looker UI에서 에이전트 세부정보 보기

활성 대시보드 에이전트가 있는 LookML 대시보드를 볼 때 채팅 패널에서 에이전트 구성을 검사할 수 있습니다.

  1. 스파크 이 대시보드와 채팅 을 선택합니다.
  2. 조정 에이전트 관리 를 선택합니다.

LookML 대시보드의 경우 에이전트 관리 패널에 에이전트 안내, 고급 분석 상태, 디버그 옵션이 읽기 전용 모드로 표시됩니다. UI 내에서 설정을 직접 수정할 수는 없습니다.

구성을 수정하려면 기본 모델에 대한 develop 권한이 있는 개발자가 LookML에서 수정 을 클릭하여 IDE의 관련 LookML 파일로 직접 이동할 수 있습니다.

대시보드 에이전트로 LookML 대시보드 쿼리

LookML 대시보드 에이전트와의 대화를 시작하려면 다음 단계를 따르세요.

  1. LookML 대시보드를 엽니다.
  2. 스파크 이 대시보드와 채팅 을 선택합니다.
  3. 질문하기 필드에 자연어로 쿼리를 입력합니다.
  4. 대시보드 에이전트에 show_thinking이 허용되는 경우 질문 모드를 선택할 수 있습니다.
    • 빠름: 쿼리를 직접 LookML 측정항목 조회로 빠르게 변환합니다.
    • 생각: 복잡한 분석 질문을 평가하고 단계별 추론을 표시합니다.
  5. 보내기 보내기를 클릭합니다.

진행 중인 쿼리를 취소하려면 응답 중지 를 클릭합니다.

대화 관리하기

  • 최근 대화: 이전 대화를 열려면 more_vert 메뉴 > 최근 대화를 선택합니다.
  • 대화 이름 바꾸기: 대화 옆에 있는 more_vert 를 선택하고 수정 edit 이름 바꾸기를 선택합니다.
  • 대화 삭제: 대화 옆에 있는 more_vert 를 선택하고 삭제 삭제를 선택합니다.