Databricks Genie App in Microsoft Teams

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. Fragen werden von Genie One oder von einem bestimmten Genie Agent beantwortet, den ein Kanalbesitzer für konsistente, anwendungsspezifische Antworten angeheftet hat.

Die Databricks Genie-App in Microsoft Teams basiert in beiden Fällen auf der Genie One API; wenn ein Genie Agent gepinnt wird, sendet Genie One die Frage nur an diesen Agenten. Die App verwendet dasselbe Modell, Anbieter 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.

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.

3. Wenn Sie nicht angemeldet sind, fordert Sie die Databricks Genie-App in Microsoft Teams auf, sich anzumelden:

   1. Klicken Sie auf Konfigurieren.
   2. Gib deine Workspace-URL an. Um Ihre Workspace-URL zu finden, siehe Workspace-Instanznamen, URLs und IDs.
   3. Klicken Sie auf Fortsetzen, um sich in Ihr Azure Databricks-Konto einzuloggen.

4. Ihre Frage wird an den am besten geeigneten Genie Agent weitergeleitet und gibt eine Antwort mit Quellen und vorgeschlagenen Nachverfolgungsaufforderungen zurück.

Um den Arbeitsbereich und den Genie-Bereich für alle nachfolgenden Direktnachrichtengespräche zu konfigurieren, öffnen Sie die Databricks Genie-App auf der Startseite von Microsoft Teams und passen die Einstellungen an.

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 Sichtbarkeit der Nachricht und den Genie-Scope (Genie One oder einen bestimmten Genie Agent).

   Wenn kein Genie Agent angeheftet wird, wechselt der Kanal standardmäßig auf Genie One.

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.
• Genie-Bereich: Genie One oder ein bestimmter Genie Agent. Beide verwenden die Genie One API; das Anpinnen eines bestimmten Genie-Agenten weist Genie One an, die Frage nur an diesen Agenten zu senden, um konsistente, auf den Anwendungsfall zugeschnittene Antworten zu erhalten.

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

Überwachen Sie die Nutzung mit Auditprotokollen

Administratoren von Konten und Arbeitsbereichen können die Systemtabelle des Audit-Logs (system.access.audit) nutzen, um die über Microsoft Teams erfolgende Nutzung von Genie zu überwachen. Wenn ein Nutzer eine Nachricht über die Databricks Genie-App in Microsoft Teams sendet, protokolliert Genie One ein createGenieChatResponse-Ereignis im Dienst genieChat, und das Feld request_params.source erfasst teams als Ursprung. Dadurch können Sie Microsoft Teams-Anfragen von Anfragen unterscheiden, die in der Azure Databricks-Weboberfläche (webapp) oder über andere Integrationen wie Slack (slack) gestellt werden.

Die folgende Beispielanfrage liefert die von Microsoft Teams erstellten Genie-Anfragen der letzten 5 Tage, einschließlich des Nutzers, der gefragt hat, und der Konversations-ID:

SELECT
  event_time,
  user_identity.email AS user_email,
  request_params.conversation_id AS conversation_id
FROM system.access.audit
WHERE service_name = 'genieChat'
  AND action_name = 'createGenieChatResponse'
  AND request_params.source = 'teams'
  AND event_date >= date_add(current_date(), -5)
ORDER BY event_time DESC

Für das Schema der Audit-Log-Tabelle und weitere Beispielabfragen siehe Tabellenreferenz für Audit-Log-System. Die vollständige Liste der Genie One Chat-Events finden Sie unter Chat-Events in Genie One.

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.

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.
• Wenn ein bestimmter Genie Agent als Genie-Bereich angeheftet ist, könnte Genie One die Frage umformulieren, bevor sie den angehefteten Agent erreicht.
• Feedback (Daumen hoch oder Daumen runter) wird immer an Genie One gesendet, selbst wenn ein bestimmter Genie Agent angeheftet ist.
• 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.