에이전트

사용

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 매개변수를 사용하여 대시보드 에이전트를 단일 LookML 대시보드와 연결할 수 있습니다.

사용자 정의 대시보드 또는 Explore의 데이터 에이전트는 LookML에서 정의할 수 없습니다.

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
}

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

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
  enabled_dashboard_agents: true
  default_dashboard_agent: customer_insights_agent

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