Agent

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
  • advanced_analytics: yes | no (Standardwert: no).
  • description: Eine Stringbeschreibung des Agents.
  • instructions: Ein String, der benutzerdefinierte Prompts und Verhaltensregeln angibt. Unterstützt LookML-Konstanten (@{CONSTANT_NAME}).
  • is_dashboard_agent: yes | no (für Dashboard-Agents als yes erforderlich).
  • show_debuginfo: yes | no (Standardwert: no).
  • show_thinking: yes | no (Standardwert: no).

Definition

Mit dem Parameter agent wird ein Daten-Agent in LookML deklariert. Mit Dashboard-Agents können Entwickler benutzerdefinierte Agent-Anweisungen, analytisches Verhalten und Anzeigeeinstellungen in der versionsverwalteten LookML definieren und den Agent mit LookML-Dashboards mithilfe der default_dashboard_agent oder dashboard_agents Parameter verknüpfen.

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 advanced_analytics Unterparameter wird festgelegt, 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 Agents.

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

instructions

Der Unterparameter instructions akzeptiert einen Freiform-String, der dem Agent bei der Verarbeitung von Unterhaltungsfragen Geschäftskontext, bevorzugte Felder, Filterregeln oder den gewünschten Tonfall 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 Syntax @{<var>CONSTANT_NAME</var>} auf LookML-Konstanten in instructions verweisen:

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

Wenn dieser Parameter weggelassen wird, arbeitet der Agent ohne benutzerdefinierten Anweisungstext.

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 Agent mit einem LookML-Dashboard verwenden möchten, setzen Sie diesen Parameter auf yes.

show_debuginfo

Der Unterparameter show_debuginfo bestimmt, ob der Agent Ausführungsprotokolle und Diagnoseinformationen in Unterhaltungsantworten anzeigt.

Akzeptiert yes oder no. Der Standardwert ist no.

show_thinking

Der Unterparameter show_thinking bestimmt, ob der Agent seine Überlegungen und die Zwischenplanung von Abfragen in Unterhaltungsantworten 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 Advanced Analytics und aktivierter Sichtbarkeit der Überlegungen 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 Agent in einem LookML-Dashboard verwenden möchten, müssen Sie ihn in der Datei .dashboard.lookml zuordnen:

- 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]