Databricks Genie-appen i Microsoft Teams

Databricks Genie-appen i Microsoft Teams ger Genie Microsoft Teams så att användarna kan ställa datafrågor och få svar utan att lämna Microsoft Teams arbetsytan. Användare kan chatta med appen i ett direktmeddelande eller nämna @Databricks Genie i en Microsoft Teams kanal eller gruppchatt. Frågor besvaras av Genie One eller av en specifik Genie Agent som en kanalägare har fäst för konsekventa svar anpassade för specifika användningsfall.

Databricks Genie-appen i Microsoft Teams använder Genie One-API:et i båda fallen; när en Genie-agent har fästs skickar Genie One frågan bara till den agenten. Appen använder samma modell av leverantörer och förtroende- och säkerhetsgarantier som Genie. Se Värdtjänstleverantör som används när inställningen för partnerbaserade AI-funktioner är aktiverad respektive inaktiverad och Tillit och säkerhet för Databricks AI-assisterande funktioner.

Den här sidan beskriver hur du laddar ned, konfigurerar och använder Databricks Genie-appen i Microsoft Teams.

Förutsättningar

Innan du installerar Databricks Genie-appen i Microsoft Teams:

• En kontoadministratör måste aktivera Databricks Genie för Microsoft Teams förhandsversion i kontokonsolen.
• Om din arbetsyta använder en IP-åtkomstlista, lägger du till de utgående IP-adresserna för Azure Databricks kontrollplan i East US 2-regionen. Se utgående IP-adresser i dokumentationen för Azure Databricks.

Installera Databricks Genie-appen i Microsoft Teams

En Microsoft 365 administratör installerar Appen Databricks Genie i Microsoft Teams från Microsoft Marketplace:

1. På Microsoft marketplace söker du efter och hittar Databricks Genie.
2. Installera appen.
3. Godkänn appbehörigheterna när du uppmanas att göra det under installationen.

För en lista över nödvändiga behörigheter, se Required app-behörigheter på Microsoft.

Efter installationen kan användarna börja använda appen.

Använda Databricks Genie-appen i Microsoft Teams

Du kan använda Appen Databricks Genie i Microsoft Teams via direktmeddelanden eller i kanalkonversationer på din Microsoft Teams arbetsyta eller från Microsoft 365 Copilot.

Direktmeddelande

Så här gör du för att skicka ett direkt meddelande till Databricks Genie-appen i Microsoft Teams:

1. I Microsoft Teams klickar du på Appar i det vänstra sidofältet och öppnar appen Databricks Genie i Microsoft Teams.

2. Ange din fråga.

3. Om du inte är inloggad ber Databricks Genie-appen i Microsoft Teams dig att logga in:

   1. Klicka på Konfigurera.
   2. Ange din arbetsplats-URL. För att hitta URL:en till din arbetsyta, se Instansnamn för arbetsytor, URL:er och ID:n.
   3. Klicka på Fortsätt för att logga in på ditt Azure Databricks-konto.

4. Din fråga dirigeras till den lämpligaste Genie-agenten och returnerar ett svar med källor och föreslagna uppföljningsprompter.

För att konfigurera arbetsytan och Genie-scope för alla efterföljande direktmeddelandekonversationer, öppna Databricks Genie-appen på Microsoft Teams startsida och justera inställningarna.

Kanalkonversation

Du kan lägga till Databricks Genie-appen i Microsoft Teams till en kanal. Med kan configkanalägare konfigurera inställningar för alla medlemmar i en kanal och enskilda användare kan konfigurera personliga inställningar. Kanalägarkonfigurationer åsidosätter personliga konfigurationer.

Så här konfigurerar du Databricks Genie-appen i Microsoft Teams i en kanal:

1. I önskad kanal skriver du @Databricks Genie.

2. Om du uppmanas att göra det lägger du till Appen Databricks Genie i Microsoft Teams till kanalen.

3. Skriv config.

4. Välj det anslutna arbetsutrymmet, meddelandets synlighet och Genie-omfattning (Genie One eller en specifik Genie-agent).

   Om ingen Genie Agent är fastnålad, går kanalen automatiskt till Genie One.

5. Efter konfigureringen dirigeras alla omnämnanden av @Databricks Genie i kanalen till den konfigurerade agenten och arbetsytan.

Konfigurationsnivåer och åsidosättningar

Kör config i en kanal för att öppna konfigurationsfönstret. Följande inställningar kan konfigureras:

• Val av arbetsyta: Azure Databricks-arbetsytan databricks Genie-appen i Microsoft Teams ansluter till för att besvara frågor.
• Meddelandesynlighet: Om @Databricks Genie svar i kanaler är synliga för alla kanalmedlemmar eller bara för användaren som frågade. Som standard är svaren offentliga. Om en administratör för arbetsytan anger meddelandesynlighet till privat stöder arbetsytan endast direktmeddelanden, inte kanaler eller gruppchatter.
• Genie-omfattning: Genie One eller en specifik Genie-agent. Båda använder Genie One API; att fästa en specifik Genie-agent instruerar Genie One att skicka frågan endast till den agenten, för konsekventa, användningsfallsspecifika svar.

Inställningarna för meddelandesynlighet kan anges på tre nivåer. Högre nivåer åsidosätter lägre nivåer:

Övervaka användningen med revisionsloggar

Konto- och arbetsytadministratörer kan använda revisionsloggens systemtabell (system.access.audit) för att övervaka Genie-användning som kommer från Microsoft Teams. När en användare skickar ett meddelande via Databricks Genie-appen i Microsoft Teams, loggar Genie One en createGenieChatResponse händelse under genieChat tjänsten och request_params.source fältet registrerar teams som ursprung. Detta låter dig skilja Microsoft Teams-förfrågningar från förfrågningar som görs i Azure Databricks webbgränssnitt (webapp) eller via andra integrationer, såsom Slack (slack).

Följande exempelfråga returnerar Microsoft Teams-initierade Genie-förfrågningar från de senaste 5 dagarna, inklusive användaren som frågade och konversations-ID:t:

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 schemat för granskningsloggstabellen och fler frågeexempel, se Referens för systemtabellen för granskningslogg. För hela listan över Genie One-chattevenemang, se Chatt-evenemang i Genie One.

Nödvändiga appbehörigheter på Microsoft

När du installerar Databricks Genie-appen i Microsoft Teams begär den följande behörigheter. Entra ID-behörigheter är tenant-omfattande Microsoft Graph-behörigheter som en Microsoft 365-administratör samtycker till för din organisation. Resursspecifika behörigheter är Teams resursspecifika samtyckesrättigheter (RSC) som endast gäller för chatten, kanalen eller teamet där appen är installerad.

För mer information om dessa behörigheter, se Resursspecifikt samtycke och grafbehörigheter i Microsoft-dokumentationen.

Felsökning

Meddelandet "Behöver administratörsgodkännande" vid inloggning

Följande meddelande "Behöver administratörsgodkännande" visas när du loggar in på din Azure Databricks arbetsyta eftersom Microsoft Entra klientorganisation blockerar användarens medgivande för Azure Databricks-programmet. Om administratörsmedgivande inte beviljas fortsätter Microsoft Entra ID att blockera inloggningsflödet även om du har direkt åtkomst till arbetsytan.

För att lösa detta måste en Microsoft Entra användare med lämpliga administratörsroller bevilja administratörsmedgivande för hela klientorganisationen till Azure Databricks företagsprogram.

Be Microsoft Entra administratören att besöka följande länk. Ersätt {TENANT_ID} med ditt Microsoft Entra klient-ID:

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

Om länken misslyckas kan administratören bevilja medgivande manuellt:

1. I Microsoft Entra administrationscenter går du till Entra ID>Enterprise-appar>Alla program och hittar det Azure Databricks företagsprogram som används för enkel inloggning. Om du vill identifiera programmet söker du efter program-ID: t aaec40b0-c0ae-4211-a98b-6fc160abb71b.
2. Bevilja administratörsmedgivande för de behörigheter som begärs av Azure Databricks enterprise-appen:
   1. Under Säkerhet klickar du på Behörigheter.
   2. Klicka på Bevilja administratörsmedgivande.

Detaljerade anvisningar finns i dokumentationen Microsoft.

Limitations

• Du kan inte ange vilken beräkning (SQL Warehouse) databricks Genie-appen i Microsoft Teams använder. Azure Databricks väljer automatiskt ett SQL-lager som användaren har behörighet att komma åt.
• När en specifik Genie Agent är fastnålad som Genie scope kan Genie One skriva om frågan innan den når den fastnålade agenten.
• Feedback (tummen upp eller tummen ner) skickas alltid till Genie One, även när en specifik Genie Agent är fastnad.
• PrivateLink stöds inte.
• Följande funktioner stöds inte:
  • Visualisera diagram
  • Skicka Azure Databricks meddelanden till Teams
  • Utlösa åtgärder i Azure Databricks från Teams

Ytterligare resurser

• Använda Genie One
• Chatta i Genie One
• Använda Genie One
• Support finns i hjälpcentret för Databricks.