에이전트

사용

agent: agent_name {
  advanced_analytics: yes | no
  description: "string"
  instructions: "string"
  is_dashboard_agent: yes | no
  show_debuginfo: yes | no
  show_thinking: yes | no
}
계층 구조
모델 파일 또는 LookML 파일
agent
기본값
없음

허용
  • advanced_analytics: yes | no (기본값은 no).
  • description: 에이전트를 설명하는 문자열입니다.
  • instructions: 맞춤 프롬프트 및 동작 규칙을 지정하는 문자열입니다. LookML 상수 (@{CONSTANT_NAME})를 지원합니다.
  • is_dashboard_agent: yes | no (대시보드 에이전트의 경우 yes가 필요함).
  • show_debuginfo: yes | no (기본값은 no).
  • show_thinking: yes | no (기본값은 no).

정의

agent 매개변수는 LookML에서 데이터 에이전트를 선언합니다. 대시보드 에이전트를 사용하면 개발자가 버전 관리 LookML에서 맞춤 에이전트 안내, 분석 동작, 표시 환경설정을 정의하고 에이전트를 LookML 대시보드와 연결할 수 있습니다. default_dashboard_agent 또는 dashboard_agents 매개변수를 사용합니다.

LookML 대시보드 에이전트 구성 및 사용에 대한 자세한 내용은 LookML 대시보드 데이터 에이전트 만들기 및 관리 문서 페이지를 참고하세요.

하위 매개변수

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

advanced_analytics

advanced_analytics 하위 매개변수는 에이전트가 고급 분석 을 사용하여 복잡한 계산 및 맞춤 시각화를 위한 Python 코드를 생성하고 실행할 수 있는지 여부를 제어합니다.

yes 또는 no를 허용합니다. 기본값은 no입니다.

description

description 하위 매개변수는 에이전트의 목적에 대한 선택적 텍스트 설명을 제공합니다.

agent: sales_agent {
  description: "Executive sales overview dashboard agent"
  is_dashboard_agent: yes
}

instructions

instructions 하위 매개변수는 대화형 질문을 처리할 때 에이전트에게 비즈니스 컨텍스트, 선호하는 필드, 필터링 규칙 또는 어조를 제공하는 자유 형식 문자열을 허용합니다.

agent: sales_agent {
  instructions: "Focus on net revenue and filter by current quarter by default."
  is_dashboard_agent: yes
}

LookML 상수 를 instructions 내에서 @{<var>CONSTANT_NAME</var>} 구문을 사용하여 참조할 수 있습니다.

agent: sales_agent {
  instructions: "Focus on net revenue. @{FISCAL_YEAR_RULE}"
  is_dashboard_agent: yes
}

생략하면 에이전트가 맞춤 안내 컨텍스트 없이 작동합니다.

is_dashboard_agent

is_dashboard_agent 하위 매개변수는 에이전트가 대시보드 에이전트로 구성되었는지 여부를 지정합니다.

yes 또는 no를 허용합니다. LookML 대시보드에서 에이전트를 사용하려면 이 매개변수를 yes로 설정하세요.

show_debuginfo

show_debuginfo 하위 매개변수는 에이전트가 대화 응답에 실행 로그 및 진단 정보를 표시하는지 여부를 결정합니다.

yes 또는 no를 허용합니다. 기본값은 no입니다.

show_thinking

show_thinking 하위 매개변수는 에이전트가 대화 응답에 추론 단계 및 중간 쿼리 계획을 표시하는지 여부를 결정합니다.

yes 또는 no를 허용합니다. 기본값은 no입니다.

예시

LookML 대시보드 에이전트 정의

다음 예에서는 맞춤 안내, 고급 분석 사용 설정, 생각 가시성이 사용 설정된 LookML 대시보드 에이전트를 정의합니다.

agent: customer_insights_agent {
  instructions: "Address the user politely. Prioritize active subscriber metrics and churn analysis."
  description: "Dashboard agent for Customer Insights dashboard."
  is_dashboard_agent: yes
  advanced_analytics: yes
  show_thinking: yes
  show_debuginfo: no
}

LookML 대시보드에서 이 에이전트를 사용하려면 .dashboard.lookml 파일에서 매핑하세요.

- dashboard: customer_insights
  title: "Customer Insights"
  layout: newspaper
  enable_dashboard_agent: true
  default_dashboard_agent: customer_insights_agent
  dashboard_agents: [customer_insights_agent]

  elements:
  - name: active_subscribers
    type: single_value
    model: subscriptions
    explore: customers
    measures: [customers.count]