Databricks Genie App in Microsoft Teams

Important

Dieses Feature befindet sich in der Public Preview. Kontoadministratoren können den Zugriff auf dieses Feature über die Seite " Vorschauen " der Kontokonsole verwalten. Siehe Verwalten von Vorschauen auf Kontoebene.

Die Databricks Genie-App in Microsoft Teams bringt Genie in Microsoft Teams, damit Benutzer Datenfragen stellen und Antworten erhalten können, ohne den Microsoft Teams Arbeitsbereich verlassen zu müssen. Benutzer können mit der App in einer direkten Nachricht chatten oder in einem Microsoft Teams Kanal- oder Gruppenchat erwähnen@Databricks Genie. Kanalbesitzer können einen bestimmten Genie Agent an einen Kanal anheften, um konsistente, anwendungsspezifische Antworten zu erhalten. Andernfalls werden Fragen über Genie weitergeleitet.

Die Databricks Genie App in Microsoft Teams basiert auf der Genie One-API und verwendet dieselben Modellanbieter und Vertrauens- und Sicherheitsgarantien wie Genie. Siehe Hostinganbieter, der bei aktivierter bzw. deaktivierter Einstellung für partnergestützte KI-Funktionen verwendet wird und Vertrauen und Sicherheit bei den Databricks KI-Assistentfunktionen.

Auf dieser Seite wird beschrieben, wie Sie die Databricks Genie-App in Microsoft Teams herunterladen, einrichten und verwenden.

Important

Azure Databricks Agents können ungenaue Antworten generieren. Überprüfen Sie die Ausgabe eines Agenten, bevor Sie danach handeln.

Voraussetzungen

Vor der Installation der Databricks Genie-App in Microsoft Teams:

• Ein Kontoadministrator muss databricks Genie für Microsoft Teams Vorschau in der Kontokonsole aktivieren.
• Wenn Ihr Arbeitsbereich eine IP-Zugriffsliste verwendet, fügen Sie die ausgehenden IPs der Azure Databricks Steuerebene in der Region Ost-USA 2 hinzu. Die ausgehenden IP-Adressen finden Sie in der Azure Databricks-Dokumentation.

Installieren sie die Databricks Genie-App in Microsoft Teams

Ein Microsoft 365-Administrator installiert die Databricks Genie-App im Microsoft Teams aus dem Microsoft Marketplace:

1. Suchen Sie auf dem Microsoft Marketplace nach Databricks Genie, und finden Sie es.
2. Installieren Sie die App.
3. Genehmigen Sie die App-Berechtigungen, wenn Sie während der Installation dazu aufgefordert werden.

Eine Liste der erforderlichen Berechtigungen finden Sie unter Erforderliche App-Berechtigungen bei Microsoft.

Nach der Installation können Benutzer mit der Verwendung der App beginnen.

Verwenden der Databricks Genie-App in Microsoft Teams

Sie können die Databricks Genie-App in Microsoft Teams über Direktnachrichten oder in Unterhaltungen in Kanälen in Ihrem Microsoft Teams-Arbeitsbereich oder aus Microsoft 365 Copilot heraus verwenden.

Direkte Nachricht

So senden Sie die Databricks Genie-App direkt in Microsoft Teams:

1. Klicken Sie in Microsoft Teams auf "Apps" in der linken Randleiste, und öffnen Sie die Databricks Genie-App in Microsoft Teams.
2. Geben Sie Ihre Frage ein. Wenn Sie nicht angemeldet sind, werden Sie von der Databricks Genie-App in Microsoft Teams aufgefordert, sich anzumelden.
3. Ihre Frage wird an den am besten geeigneten Genie Agent weitergeleitet und gibt eine Antwort mit Quellen und vorgeschlagenen Nachverfolgungsaufforderungen zurück.

Öffnen Sie die Databricks Genie-App auf der Startseite von Microsoft Teams, und passen Sie die Einstellungen an, um den Arbeitsbereich und den Geltungsbereich des Genie-Agenten für alle nachfolgenden Unterhaltungen per Direktnachricht zu konfigurieren.

Unterhaltung im Kanal

Sie können die Databricks Genie-App in Microsoft Teams zu einem Kanal hinzufügen. Mithilfe von config können Kanalbesitzer Einstellungen für alle Mitglieder eines Kanals konfigurieren, und einzelne Benutzer können persönliche Einstellungen festlegen. Kanalbesitzerkonfigurationen setzen persönliche Konfigurationen außer Kraft.

So konfigurieren Sie die Databricks Genie-App in Microsoft Teams in einem Kanal:

1. Geben Sie im gewünschten Kanal @Databricks Genie ein.

2. Wenn Sie dazu aufgefordert werden, fügen Sie die Databricks Genie-App in Microsoft Teams zum Kanal hinzu.

3. Geben Sie config ein.

4. Wählen Sie den verbundenen Arbeitsbereich, die Nachrichtensichtbarkeit und den Bereich des Genie-Agents (einen bestimmten Bereich oder Chat in Genie) aus.

   Wenn kein Genie Agent konfiguriert ist, wird der Kanal standardmäßig in Genie chatten.

5. Nach der Konfiguration werden alle @Databricks Genie-Erwähnungen im Kanal an den konfigurierten Agent und Arbeitsbereich weitergeleitet.

Konfigurationsstufen und Außerkraftsetzungen

Führen Sie config in einem Kanal aus, um das Konfigurationsfenster zu öffnen. Die folgenden Einstellungen sind konfigurierbar:

• Arbeitsbereichauswahl: Der Azure Databricks Arbeitsbereich, mit dem die Databricks Genie-App in Microsoft Teams eine Verbindung zum Beantworten von Fragen herstellt.
• Sichtbarkeit von Nachrichten: Gibt an, ob @Databricks Genie Antworten in Kanälen für alle Kanalmitglieder oder nur für den Benutzer sichtbar sind, der gefragt hat. Standardmäßig sind Antworten öffentlich. Wenn ein Arbeitsbereichsadministrator die Nachrichtensicht auf "Privat" festlegt, unterstützt der Arbeitsbereich nur direkte Nachrichten, nicht Kanäle oder Gruppenchats.
• Geltungsbereich des Genie Agenten: Ein bestimmter Genie Agent oder alle Genie Agenten. Heften Sie einen einzelnen Bereich an, um konsistente, auf den jeweiligen Anwendungsfall zugeschnittene Antworten zu erhalten.

Die Einstellungen für die Nachrichtensichtbarkeit können auf drei Ebenen festgelegt werden. Höhere Ebenen überschreiben niedrigere Ebenen:

Grad	So richten Sie es ein	Gilt für:	Vorrang
Arbeitsbereich	Azure Databricks Arbeitsbereichsadministrator konfiguriert aus den Arbeitsbereichssicherheitseinstellungen mithilfe der Felder "Verbindung mit Zusammenarbeitsplattformen zulassen" und "Öffentliche Nachrichten in Plattformen für die Zusammenarbeit zulassen". Wenn Öffentliche Nachrichten in Kollaborationsplattformen zulassen deaktiviert ist, stehen Kanal- und Gruppennachrichten nicht zur Verfügung, und es werden nur Direktnachrichten unterstützt.	Alle Kanäle im Microsoft Teams-Arbeitsbereich	Höchste Einstellung – überschreibt Kanal- und persönliche Konfigurationen
Kanal	Der Kanalbesitzer sendet config im Kanal und wählt Als kanalweite Einstellung speichern aus.	Alle Mitglieder in diesem Kanal	Überschreibt persönliche Einstellungen
Personal	Ein einzelner Benutzer sendet config in den Kanal	Die eigenen @Databricks Genie-Erwähnungen dieses Benutzers im Kanal	Wird verwendet, wenn keine kanalweite Konfiguration festgelegt ist

Erforderliche App-Berechtigungen bei Microsoft

Wenn du die Databricks Genie-App in Microsoft Teams installierst, fordert sie die folgenden Berechtigungen an. Entra ID-Berechtigungen sind tenant-weite Microsoft Graph-Berechtigungen, denen ein Microsoft 365-Administrator für Ihre Organisation zustimmt. Ressourcenspezifische Berechtigungen sind Teams-spezifische Einwilligungsberechtigungen (RSC), die nur für den Chat, Kanal oder das Team gelten, in dem die App installiert ist.

Weitere Informationen zu diesen Berechtigungen finden Sie in der Microsoft-Dokumentation unter Resource-specific consent and Graph permissions.

Note

Die Genehmigung User.ReadBasic.All wird nicht mehr genutzt. Die App verwendet jetzt stattdessen delegierte Berechtigungen. Bis Azure Databricks es als erforderliche Berechtigung entfernt hat, könnte es sein, dass es während der Installation angefordert wird. Genehmigen Sie die Anfrage, wenn Sie dazu aufgefordert werden.

Erlaubnis	Description	Type
offline_access	Behalten Sie den Zugriff auf die Daten, auf die Sie ihm Zugriff gewährt haben.	Entra ID
User.Read	Melden Sie sich an und lesen Sie das Benutzerprofil.	Entra ID
User.ReadBasic.All	Lesen Sie die grundlegenden Profile aller Benutzer.	Entra ID
ChatMessage.Read.Chat	Lies die Nachrichten in diesem Chat.	Ressourcenspezifisch
ChatMessage.Send.Chat	Schick Nachrichten in diesen Chat.	Ressourcenspezifisch
TeamsActivity.Send.Chat	Erstellen Sie neue Benachrichtigungen in den Teamwork-Aktivitätsfeeds der Nutzer in diesem Chat.	Ressourcenspezifisch
TeamsActivity.Send.User	Senden Sie Benachrichtigungen im Aktivitätsfeed an diesen Nutzer.	Ressourcenspezifisch
ChannelMember.Read.Group	Lesen Sie die Mitglieder der Kanäle eines Teams.	Ressourcenspezifisch
ChannelMessage.Read.Group	Lesen Sie die Kanalnachrichten dieses Teams.	Ressourcenspezifisch
ChannelSettings.Read.Group	Lesen Sie die Kanalnamen, Beschreibungen und Einstellungen dieses Teams.	Ressourcenspezifisch

Problembehandlung

Meldung "Administratorgenehmigung erforderlich" bei der Anmeldung

Die folgende Meldung "Administratorgenehmigung erforderlich" wird angezeigt, wenn Sie sich bei Ihrem Azure Databricks Arbeitsbereich anmelden, da der Microsoft Entra Mandant die Zustimmung des Benutzers für die Azure Databricks Anwendung blockiert. Wenn keine Administratorzustimmung erteilt wird, blockiert Microsoft Entra ID den Anmeldefluss auch dann weiterhin, wenn Sie direkten Arbeitsbereichszugriff haben.

Um dies zu beheben, muss ein Microsoft Entra Benutzer mit entsprechenden Administratorrollen mandantenweite Administratorzustimmungen für die Azure Databricks Unternehmensanwendung erteilen.

Bitten Sie den Microsoft Entra-Administrator, den folgenden Link zu besuchen. Ersetzen Sie {TENANT_ID} durch Ihre Microsoft Entra-Mandanten-ID:

https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b

Wenn der Link fehlschlägt, kann der Administrator die Zustimmung manuell erteilen:

1. Wechseln Sie im Microsoft Entra Admin Center zu Entra ID>Enterprise apps>All applications und suchen Sie die Azure Databricks Unternehmensanwendung, die für einmaliges Anmelden verwendet wird. Um die Anwendung zu identifizieren, suchen Sie nach der Anwendungs-ID aaec40b0-c0ae-4211-a98b-6fc160abb71b.
2. Erteilen Sie der Administratorzustimmung für die berechtigungen, die von der Azure Databricks Enterprise-App angefordert werden:
   1. Klicken Sie unter "Sicherheit" auf "Berechtigungen".
   2. Klicken Sie auf " Administratorzustimmung erteilen".

Ausführliche Anweisungen finden Sie in der dokumentation Microsoft.

Einschränkungen

• Sie können nicht angeben, welches SQL Warehouse die Databricks Genie-App in Microsoft Teams verwendet. Azure Databricks wählt automatisch ein SQL Warehouse aus, auf das der Benutzer zugreifen darf.
• PrivateLink wird nicht unterstützt.
• Die folgenden Features werden nicht unterstützt:
  • Visualisieren von Diagrammen
  • Senden von Azure-Databricks-Benachrichtigungen an Teams
  • Auslösen von Aktionen in Azure Databricks aus Teams

Weitere Ressourcen

• Verwenden von Genie One
• Chat in Genie One
• Verwenden von Genie One
• Support finden Sie im Databricks-Hilfecenter.