Einbetten eines Genie-Agents in eine externe App

Betten Sie einen Genie Agent als iFrame in eine externe Website oder Anwendung ein, damit Benutzer innerhalb Ihrer internen Tools oder Portale mit Genie interagieren können, ohne zu Azure Databricks zu navigieren. Arbeitsbereichsadministratoren konfigurieren zulässige Einbettungsoberflächen; Eingebettete Benutzer können Eingabeaufforderungen senden, aber die Agentkonfiguration nicht bearbeiten.

Hinweis

Genie Agents waren früher als Genie Spaces bekannt.

Anforderungen

Bevor Sie einen Genie Agent einbetten können, muss Folgendes vorhanden sein:

• Arbeitsbereichsadministrator: Muss zulässige Einbettungsoberflächen in Genie-Zugriffsverwaltungseinstellungen konfigurieren.
• Agent-Autor: Muss über mindestens CAN MANAGE-Berechtigung für den Genie Agent verfügen.
• Endbenutzer: Muss expliziten Zugriff auf den Genie Agent und die zugrunde liegenden Datenressourcen haben, die sie verwendet. Benutzer, die nicht bei Azure Databricks angemeldet sind, werden aufgefordert, sich zu authentifizieren, bevor sie mit dem eingebetteten Agent interagieren können.

Hinweis

Eingebettete Genie Agent-Benutzer können Eingabeaufforderungen senden, aber die Agentkonfiguration nicht bearbeiten.

Schritt 1: Konfigurieren zulässiger Einbettungsoberflächen

Ein Arbeitsbereichsadministrator muss zulässige Einbettungsoberflächen konfigurieren, bevor ein Genie-Agent eingebettet werden kann. Siehe Dashboard verwalten und Einbettung von Genie Agent.

Schritt 2: Generieren des iframe-Codes

Nachdem ein Administrator zulässige Oberflächen konfiguriert hat, können Agentautoren den iframe-Einbindungscode generieren.

1. Öffnen Sie den Genie Agent, den Sie einbetten möchten.
2. Klicken Sie auf Freigeben.
3. Gehen Sie im Dialogfeld „Freigeben“ auf Raum einbetten.
4. Kopieren Sie den generierten iframe-Code.

Schritt 3: Hinzufügen des iframes zu Ihrer Anwendung

Fügen Sie den iframe-Code in Ihre externe Website oder Anwendung ein.

Um die vollständige Funktionalität zu aktivieren, einschließlich kopieren von CSV-Daten und Kopieren von Unterhaltungslinks, fügen Sie das allow="clipboard-write" Attribut zum iframe-Element hinzu:

<iframe src="<your-genie-space-url>" allow="clipboard-write" width="100%" height="600"></iframe>

Bewährte Methoden

• Gewähren sie expliziten Datenzugriff: Stellen Sie sicher, dass Endbenutzer Zugriff auf den Genie-Agent und alle zugrunde liegenden Datenressourcen haben, die vom Agent verwendet werden. Benutzer sehen nur Daten, auf die sie über die Berechtigung zum Zugriff verfügen.
• Aktivieren Sie den Zugriff auf die Zwischenablage: Fügen Sie allow="clipboard-write" in das iframe-Element ein, damit Benutzer Abfrageergebnisse und Links zu Konversationen kopieren können.
• Zulässige Oberflächen beschränken: Fügen Sie zur Liste der zulässigen Einbettungsoberflächen Domains hinzu, denen Sie vertrauen und die Sie kontrollieren, nur.