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.
• Om gebruikers bestanden in directe berichten te laten uploaden, moet een werkruimtebeheerder de Genie One File Upload-preview inschakelen, en het Microsoft Teams-account van elke gebruiker moet OneDrive voor Bedrijven hebben. Zie Bestanden uploaden.
• Om documenten als pdf op te slaan in directe berichten, heeft elke gebruiker OneDrive en versie 1.0.17 en hoger van de Databricks Genie-app in Microsoft Teams nodig. Zie Bestanden opslaan als PDF's.
• 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 een nieuw gesprek te starten in een direct bericht, stuur newchat. Dit maakt de huidige conversatiecontext duidelijk, zodat je volgende bericht een nieuw Genie-gesprek start. Je bestaande Microsoft Teams-berichten worden niet verwijderd.

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.

Bestanden uploaden

In een direct message kun je tot vijf PDF-, Word- of CSV-bestanden van 20 MiB of kleiner aan een bericht toevoegen, en Genie gebruikt die als context wanneer hij antwoordt. Bestanden uploaden is niet beschikbaar in kanalen, groepschats of Microsoft 365 Copilot.

Microsoft Teams slaat bestanden op die je in een chat toevoegt in je OneDrive voor Bedrijven, dus je Microsoft Teams-account moet OneDrive voor Bedrijven hebben om bestanden te uploaden.

Bestanden uploaden:

1. Voeg in een direct bericht met de Databricks Genie-app in Microsoft Teams tot vijf bestanden aan je bericht toe.
2. Vul optioneel een vraag in over de bestanden.
3. Verzend het bericht.

Als je bericht een vraag bevat, uploadt Genie de bestanden en beantwoordt vervolgens de vraag op basis daarvan. Als je bestanden verstuurt zonder een vraag te stellen, uploadt Genie ze en bevestigt wanneer ze klaar zijn. Je kunt dan vragen stellen over de bestanden.

Geüploade bestanden blijven beschikbaar voor vervolgvragen in het huidige gesprek. Nadat je newchat hebt verzonden, voeg je de bestanden opnieuw toe om ze te gebruiken in het nieuwe gesprek.

Als je meer dan vijf bestanden toevoegt, uploadt Genie de eerste vijf en vermeldt de bestanden die hij heeft overgeslagen. Als een bestand niet geüpload kan worden, vermeldt Genie het met de reden. Zolang er ten minste één bestand wordt geüpload, beantwoordt Genie nog steeds je vraag zelf.

Als Genie antwoordt dat Azure Databricks de upload niet kon autoriseren, vraag dan een workspace-beheerder om te bevestigen dat de Genie One File Upload-preview is ingeschakeld voor jouw werkruimte.

Bewaar documenten als PDF's

Wanneer Genie een document opstelt in een direct bericht, biedt de Databricks Genie-app in Microsoft Teams het document als PDF op een bestandskaart aan. Om te leren hoe je Genie vraagt een document op te stellen, zie Documenten in Genie One.

Om de PDF op je OneDrive op te slaan, klik je op Toestaan op de bestandskaart. De app vervangt de kaarttegel door de PDF in de chat. Om het aanbod af te wijzen, klik op Weigeren.

Om PDF's op te slaan, heb je OneDrive en versie 1.0.17 en hoger van de Databricks Genie-app in Microsoft Teams nodig. Als het klikken op Toestaan mislukt omdat OneDrive voor je account is uitgeschakeld, open dan het document in Genie One.

• De PDF is vernoemd naar de titel van het document.
• Als een reactie meer dan één document bevat, biedt de app alleen het eerste document aan.
• Het aanbod verloopt 15 minuten nadat de app het plaatst. Als de PDF-bezorging druk is of niet kan starten, vraagt de melding je om opnieuw op Toestaan te klikken. Doe dit voordat het aanbod verloopt. Om een PDF te krijgen nadat het aanbod is verlopen, vraag Genie om het document opnieuw te genereren.
• PDF's groter dan 20 MiB kunnen niet worden opgeslagen. Open het document in plaats daarvan in Genie One.

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.

Visualizations

Wanneer een Genie-reactie een visualisatie bevat, verschijnt de grafiek als een afbeelding in het antwoord.

Visualisaties worden niet getoond wanneer de zichtbaarheid van berichten op privé is gezet, omdat privéberichten alleen zichtbaar zijn voor de gebruiker die het vroeg.

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.
• 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:

Gegevensroutering

Genie verwerkt je vragen in je werkruimte en slaat de gespreksgeschiedenis op in de regio van je werkruimte. Verzoeken tussen Microsoft Teams en je werkruimte gaan via een centrale Azure Databricks-service in de Azure Databricks control plane. De centrale dienst loopt in de regio East US 2, ongeacht de regio van je werkruimte. De centrale dienst slaat geen verzoek- of antwoordinhoud op en registreert deze ook niet. Het slaat alleen de mapping op tussen je Microsoft Teams-tenant en je Azure Databricks workspace.

Microsoft Teams heeft een vast eindpunt nodig om verzoeken te ontvangen, dus de app gebruikt een centrale service.

Wanneer je een vraag stelt in Microsoft Teams:

1. Microsoft Teams stuurt je vraag naar de centrale service.
2. De centrale service stuurt het verzoek door naar je Azure Databricks workspace.
3. Genie verwerkt het verzoek en genereert een antwoord in je werkruimte.
4. Het antwoord keert terug naar Microsoft Teams via de centrale service.

Wanneer je een document opslaat als PDF, downloadt de app de PDF van je werkruimte en uploadt deze via East US 2 naar je OneDrive. De app slaat de PDF niet op.

Waar LLM-verwerking plaatsvindt

De centrale dienst stuurt berichten tussen Microsoft Teams en je werkruimte. Genie in je werkruimte roept het grote taalmodel (LLM) aan, dus de Geo van je werkruimte en de cross-Geo verwerkingsinstelling bepalen waar de LLM je content verwerkt. Als je werkruimte bijvoorbeeld in Europa Geo staat en cross-Geo verwerking niet is ingeschakeld, verwerkt de LLM je content in Europa. Zie Databricks Designated Services.

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.
• Bestandsupload wordt alleen ondersteund in directe berichten. In kanalen, groepschats en Microsoft 365 Copilot beantwoordt Genie geen bericht met bijlagen. In plaats daarvan antwoordt het dat uploads alleen werken in een direct bericht.
• Bestandsupload ondersteunt alleen PDF-, Word- (.docx) en CSV-bestanden van 20 MiB of kleiner, tot vijf bestanden per bericht.
• Documenten opslaan als PDF is alleen mogelijk in directe berichten. Genie biedt geen PDF's aan in kanalen, groepschats of Microsoft 365 Copilot. OneDrive en versie 1.0.17 en hoger van de Databricks Genie-app in Microsoft Teams zijn vereist. PDF's groter dan 20 MiB kunnen niet worden opgeslagen.
• Het triggeren van acties in Azure Databricks vanuit Teams wordt niet ondersteund.

Aanvullende bronnen

• Genie One gebruiken
• Chatten in Genie One
• Doelen van de Genie-apps voor Slack en Microsoft Teams
• Zie het Databricks-helpcentrum voor ondersteuning.