Databricks Genie-app in Microsoft Teams

De Databricks Genie-app in Microsoft Teams brengt Genie in Microsoft Teams zodat gebruikers gegevensvragen kunnen stellen en antwoorden kunnen krijgen zonder de Microsoft Teams werkruimte te verlaten. Gebruikers kunnen chatten met de app in een direct bericht of vermelden @Databricks Genie in een Microsoft Teams kanaal of groepschat. Vragen worden beantwoord door Genie One of door een specifieke Genie Agent die een kanaaleigenaar heeft vastgezet voor consistente, gebruiksspecifieke antwoorden.

De Databricks Genie-app in Microsoft Teams vertrouwt in beide gevallen op de Genie One API; wanneer een Genie Agent wordt vastgepind, stuurt Genie One de vraag alleen naar die agent. De app gebruikt hetzelfde model van providers en vertrouwens- en veiligheidsgaranties als Genie. Zie de hostingprovider die wordt gebruikt wanneer de instelling voor door partners aangestuurde AI-functies is in- en uitgeschakeld en Databricks AI-ondersteunende functies: vertrouwen en veiligheid.

Op deze pagina wordt beschreven hoe u de Databricks Genie-app downloadt, instelt en gebruikt in Microsoft Teams.

Prerequisites

Voordat u de Databricks Genie-app installeert in Microsoft Teams:

• Een accountbeheerder moet databricks Genie inschakelen voor Microsoft Teams preview in de accountconsole.
• Als uw werkruimte gebruikmaakt van een IP-toegangslijst, voegt u de uitgaande IP-adressen van het Azure Databricks besturingsvlak toe in de regio VS - oost 2. Zie de uitgaande IP-adressen in de documentatie voor Azure Databricks.

De Databricks Genie-app installeren in Microsoft Teams

Een Microsoft 365-beheerder installeert de Databricks Genie-app in Microsoft Teams vanuit de Microsoft marketplace:

1. Zoek in de Microsoft Marketplace naar Databricks Genie en vind deze.
2. Installeer de app.
3. Keur de app-machtigingen goed wanneer u hierom wordt gevraagd tijdens de installatie.

Voor een lijst van vereiste permissies, zie Vereiste app-rechten op Microsoft.

Na de installatie kunnen gebruikers de app gaan gebruiken.

De Databricks Genie-app gebruiken in Microsoft Teams

U kunt de Databricks Genie-app in Microsoft Teams gebruiken via directe berichten of in kanaalgesprekken in uw Microsoft Teams werkruimte of vanuit Microsoft 365 Copilot.

Direct bericht

Als u de Databricks Genie-app rechtstreeks een bericht wilt sturen in Microsoft Teams:

1. Klik in Microsoft Teams op Apps in de linkerzijbalk en open de Databricks Genie-app in Microsoft Teams.

2. Voer uw vraag hier in.

3. Als je niet bent ingelogd, vraagt de Databricks Genie-app in Microsoft Teams je om in te loggen:

   1. Klik op configureren.
   2. Specificeer je Workspace-URL. Raadpleeg Namen, URL’s en ID’s van workspace-instanties om de URL van je workspace te vinden.
   3. Klik op Doorgaan om in te loggen op je Azure Databricks-account.

4. Uw vraag wordt doorgestuurd naar de meest geschikte Genie Agent en retourneert een antwoord met bronnen en voorgestelde vervolgprompts.

Om de werkruimte en Genie-scope voor alle volgende direct message-gesprekken te configureren, open je de Databricks Genie-app op de startpagina van Microsoft Teams en pas je de instellingen aan.

Kanaalgesprek

U kunt de Databricks Genie-app in Microsoft Teams toevoegen aan een kanaal. Met config kunnen eigenaren van kanalen instellingen aanpassen voor alle kanaalleden en kunnen afzonderlijke gebruikers persoonlijke instellingen aanpassen. Configuraties van kanaaleigenaars overschrijven persoonlijke configuraties.

De Databricks Genie-app configureren in Microsoft Teams in een kanaal:

1. Typ in het gewenste kanaal @Databricks Genie.

2. Als u hierom wordt gevraagd, voegt u de Databricks Genie-app in Microsoft Teams toe aan het kanaal.

3. Typ config.

4. Kies de verbonden werkruimte, de zichtbaarheid van het bericht en het Genie-bereik (Genie One of een specifieke Genie-agent).

   Als er geen Genie Agent wordt vastgezet, schakelt het kanaal standaard over naar Genie One.

5. Na de configuratie worden alle @Databricks Genie vermeldingen in de kanaalroute naar de geconfigureerde agent en werkruimte vermeld.

Configuratieniveaus en overschrijvingen

Voer config uit in een kanaal om het configuratievenster te openen. De volgende instellingen kunnen worden geconfigureerd:

• Werkruimteselectie: De Azure Databricks werkruimte waarmee de Databricks Genie-app in Microsoft Teams verbinding maakt voor het beantwoorden van vragen.
• Zichtbaarheid van berichten: of @Databricks Genie antwoorden in kanalen zichtbaar zijn voor alle kanaalleden of alleen voor de gebruiker die hier om heeft gevraagd. Antwoorden zijn standaard openbaar. Als een werkruimtebeheerder de zichtbaarheid van berichten instelt op privé, ondersteunt de werkruimte alleen directe berichten, niet kanalen of groepschats.
• Genie scope: Genie One ofwel een specifieke Genie-agent. Beide gebruiken de Genie One API; het vastpinnen van een specifieke Genie Agent geeft Genie One de opdracht om de vraag alleen naar die agent te sturen, voor consistente, gebruiksspecifieke antwoorden.

Instellingen voor zichtbaarheid van berichten kunnen op drie niveaus worden ingesteld. Hogere niveaus overschrijven lagere niveaus:

Monitor het gebruik met auditlogs

Account- en werkruimtebeheerders kunnen de systeemtabel van het auditlogboek (system.access.audit) gebruiken om het gebruik van Genie te monitoren dat afkomstig is van Microsoft Teams. Wanneer een gebruiker een bericht stuurt via de Databricks Genie-app in Microsoft Teams, registreert Genie One een createGenieChatResponse gebeurtenis onder de genieChat service en de request_params.source veldrecords teams als oorsprong. Dit stelt je in staat om verzoeken van Microsoft Teams te onderscheiden van verzoeken die worden gedaan in de Azure Databricks webinterface (webapp) of via andere integraties, zoals Slack (slack).

De volgende voorbeeldquery geeft de door Microsoft Teams veroorzaakte Genie-verzoeken van de afgelopen 5 dagen terug, inclusief de gebruiker die het vroeg en de gespreks-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

Voor het auditlog-tabel schema en meer voorbeeldvragen, zie Audit log systeem tabel referentie. Voor de volledige lijst van Genie One-chatevenementen, zie Chat-evenementen in Genie One.

Vereiste app-rechten op Microsoft

Wanneer je de Databricks Genie-app installeert in Microsoft Teams, vraagt deze om de volgende rechten. Entra ID-rechten zijn tenant-brede Microsoft Graph-rechten waar een Microsoft 365-beheerder toestemming voor geeft voor uw organisatie. Resourcespecifieke machtigingen zijn Teams-machtigingen voor resource-specifieke toestemming (RSC) die alleen gelden voor de chat, het kanaal of het team waarin de app is geïnstalleerd.

Voor meer informatie over deze toestemmingen, zie Resource-specific consent en Graph permissions in de Microsoft-documentatie.

Troubleshooting

Bericht 'Goedkeuring door beheerder nodig' bij aanmelden

Het volgende bericht 'Beheerdersgoedkeuring nodig' wordt weergegeven wanneer u zich aanmeldt bij uw Azure Databricks werkruimte omdat de Microsoft Entra tenant gebruikerstoestemming voor de Azure Databricks-toepassing blokkeert. Als er geen beheerderstoestemming wordt verleend, blijft Microsoft Entra ID de aanmeldingsstroom blokkeren, zelfs als u directe toegang tot de werkruimte hebt.

Om dit op te lossen, moet een Microsoft Entra gebruiker met de juiste beheerdersrollen voor de hele tenant toestemming geven voor de Azure Databricks bedrijfstoepassing.

Vraag de Microsoft Entra beheerder om de volgende koppeling te bezoeken. Vervang {TENANT_ID} door de tenant-id van uw Microsoft Entra:

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

Als de koppeling mislukt, kan de beheerder handmatig toestemming verlenen:

1. Ga in het Microsoft Entra-beheercentrum naar Entra ID>Bedrijfstoepassingen>Alle toepassingen en zoek de Azure Databricks bedrijfstoepassing die wordt gebruikt voor Single Sign-On. Als u de toepassing wilt identificeren, zoekt u naar de toepassings-id aaec40b0-c0ae-4211-a98b-6fc160abb71b.
2. Beheerderstoestemming verlenen voor de machtigingen die zijn aangevraagd door de Azure Databricks enterprise-app:
   1. Klik onder Beveiliging op Machtigingen.
   2. Klik op Beheerderstoestemming verlenen.

Zie de documentatie Microsoft voor gedetailleerde instructies.

Limitations

• U kunt niet opgeven welke compute (SQL Warehouse) de Databricks Genie-app in Microsoft Teams gebruikt. Azure Databricks selecteert automatisch een SQL Warehouse waartoe de gebruiker toegang heeft.
• Wanneer een specifieke Genie Agent als de Genie scope wordt vastgezet, kan Genie One de vraag herschrijven voordat deze de vastgezette agent bereikt.
• Feedback (duim omhoog of duim omlaag) wordt altijd naar Genie One gestuurd, zelfs als een specifieke Genie Agent vastgepind is.
• PrivateLink wordt niet ondersteund.
• De volgende functies worden niet ondersteund:
  • Grafieken visualiseren
  • Azure Databricks meldingen verzenden naar Teams
  • Acties activeren in Azure Databricks vanuit Teams

Aanvullende bronnen

• Genie One gebruiken
• Chatten in Genie One
• Genie One gebruiken
• Zie het Databricks-helpcentrum voor ondersteuning.