Nutzung
agent: agent_name { advanced_analytics: yes | no description: "string" instructions: "string" is_dashboard_agent: yes | no show_debuginfo: yes | no show_thinking: yes | no }
|
Hierarchie
Modelldatei oder LookML-Datei
agent |
Standardwert
Keine
Akzeptiert
|
Definition
Mit dem Parameter agent wird ein Daten-Agent für ein LookML-Dashboard definiert. Entwickler können diesen Parameter und seine Unterparameter verwenden, um benutzerdefinierte Agent-Anweisungen, analytisches Verhalten und Anzeigeeinstellungen in der versionskontrollierten LookML für einen einzelnen Agent zu definieren, der einem einzelnen LookML-Dashboard zugeordnet ist.
Entwickler können einen Dashboard-Agent mit einem einzelnen LookML-Dashboard verknüpfen, indem sie den Parameter default_dashboard_agent verwenden.
Daten-Agents für benutzerdefinierte Dashboards oder für Explores können nicht in LookML definiert werden.
Ausführliche Informationen zum Konfigurieren und Verwenden von LookML-Dashboard-Agents finden Sie auf der Dokumentationsseite Daten-Agents für LookML-Dashboards erstellen und verwalten.
Unterparameter
Dashboard-Agent-Definitionen unterstützen die folgenden Unterparameter:
advanced_analytics
Mit dem Unterparameter advanced_analytics wird gesteuert, ob der Agent Advanced Analytics verwenden kann, um Python-Code für komplexe Berechnungen und benutzerdefinierte Visualisierungen zu generieren und auszuführen.
Akzeptiert yes oder no. Der Standardwert ist no.
description
Der Unterparameter description enthält eine optionale Textbeschreibung des Zwecks des KI-Agents.
agent: sales_agent {
description: "Executive sales overview dashboard agent"
is_dashboard_agent: yes
}
instructions
Der Unterparameter instructions akzeptiert einen Freiformstring, der dem Agenten Geschäftskontext, bevorzugte Felder, Filterregeln oder den gewünschten Tonfall für die Verarbeitung von Fragen im Gespräch liefert.
agent: sales_agent {
instructions: "Focus on net revenue and filter by current quarter by default."
is_dashboard_agent: yes
}
Sie können mit der @{<var>CONSTANT_NAME</var>}-Syntax in instructions auf LookML-Konstanten verweisen:
agent: sales_agent {
instructions: "Focus on net revenue. @{FISCAL_YEAR_RULE}"
is_dashboard_agent: yes
}
Wenn das Feld leer ist, wird der KI-Agent ohne benutzerdefinierten Anweisungskontext ausgeführt.
is_dashboard_agent
Der Unterparameter is_dashboard_agent gibt an, ob der Agent als Dashboard-Agent konfiguriert ist.
Akzeptiert yes oder no. Wenn Sie den Agenten mit einem LookML-Dashboard verwenden möchten, legen Sie diesen Parameter auf yes fest.
show_debuginfo
Mit dem Unterparameter show_debuginfo wird festgelegt, ob der Agent Ausführungsprotokolle und Diagnoseinformationen in Konversationsantworten anzeigt.
Akzeptiert yes oder no. Der Standardwert ist no.
show_thinking
Mit dem Unterparameter show_thinking wird festgelegt, ob der Agent seine Begründungsschritte und die Zwischenplanung von Anfragen in Konversationsantworten anzeigt.
Akzeptiert yes oder no. Der Standardwert ist no.
Beispiele
LookML-Dashboard-Agent definieren
Im folgenden Beispiel wird ein LookML-Dashboard-Agent mit benutzerdefinierten Anweisungen, aktivierter erweiterter Analyse und aktivierter Denkprozess-Sichtbarkeit definiert:
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
}
Wenn Sie diesen Agenten in einem LookML-Dashboard verwenden möchten, ordnen Sie ihn in der Datei .dashboard.lookml zu:
- 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]