エージェント

用途

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 でカスタム エージェントの指示、分析動作、表示設定を定義し、default_dashboard_agent パラメータまたは dashboard_agents パラメータを使用して、エージェントを 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
}

instructions 内で LookML 定数を参照するには、@{<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]