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.
• För att låta användare ladda upp filer i direktmeddelanden måste en administratör för arbetsytan aktivera förhandsvisningen av Genie One File Upload, och varje användares Microsoft Teams-konto måste ha OneDrive för företag. Se Ladda upp filer.
• För att låta användare spara dokument som PDF-filer i direktmeddelanden behöver varje användare OneDrive och version 1.0.17 och senare av Databricks Genie-appen i Microsoft Teams. Se Spara dokument som PDF:er.
• 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 starta en ny konversation i ett direktmeddelande, skicka newchat. Detta rensar den aktuella konversationskontexten så att ditt nästa meddelande startar en ny Genie-konversation. Dina befintliga Microsoft Teams-meddelanden raderas inte.

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.

Överför filer

I ett direktmeddelande kan du bifoga upp till fem PDF-, Word- eller CSV-filer på 20 MiB eller mindre till ett meddelande, och Genie använder dem som kontext när den svarar. Filuppladdning är inte tillgänglig i kanaler, gruppchattar eller Microsoft 365 Copilot.

Microsoft Teams lagrar filer som du bifogar i en chatt i din OneDrive för företag, så ditt Microsoft Teams-konto måste ha OneDrive för företag för att ladda upp filer.

Så här laddar du upp filer:

1. I ett direktmeddelande med Databricks Genie-appen i Microsoft Teams, bifoga upp till fem filer till ditt meddelande.
2. Eventuellt, ange en fråga om filerna.
3. Skicka meddelandet.

Om ditt meddelande innehåller en fråga laddar Genie upp filerna och svarar sedan på frågan med dem. Om du skickar filer utan en fråga, laddar Genie upp dem och bekräftar när de är klara. Du kan sedan ställa frågor om filerna.

Uppladdade filer finns kvar för följdfrågor i den aktuella konversationen. Efter att du skickat newchat, bifoga filerna igen för att använda dem i den nya konversationen.

Om du bifogar fler än fem filer laddar Genie upp de första fem och listar de filer den hoppade över. Om en fil inte kan laddas upp, listar Genie den med orsaken. Så länge minst en fil laddas upp svarar Genie fortfarande på din fråga.

Om Genie svarar att Azure Databricks inte kunde godkänna uppladdningen, be en workspace-administratör att bekräfta att Genie One File Upload-förhandsvisningen är aktiverad för din workspace.

Spara dokument som PDF-filer

När Genie skriver ett dokument i ett direktmeddelande erbjuder Databricks Genie-appen i Microsoft Teams dokumentet som en PDF på ett filkort. För att lära dig hur man ber Genie att utarbeta ett dokument, se Dokument i Genie One.

För att spara PDF:en på din OneDrive, klicka på Tillåt på filkortet. Appen ersätter kortet med PDF:en i chatten. För att avvisa erbjudandet klickar du på Avböj.

För att spara PDF:er behöver du OneDrive och version 1.0.17 och senare av Databricks Genie-appen i Microsoft Teams. Om det inte går att klicka på Tillåt eftersom OneDrive är inaktiverat för ditt konto, öppna dokumentet i Genie One istället.

• PDF-filen är uppkallad efter dokumentets titel.
• Om ett svar innehåller mer än ett dokument erbjuder appen endast det första.
• Erbjudandet går ut 15 minuter efter att appen publicerat det. Om PDF-leveransen är upptagen eller inte kan starta, uppmanar kortet dig att klicka på Tillåt igen. Gör det innan erbjudandet går ut. För att få en PDF efter att erbjudandet gått ut, be Genie att generera dokumentet igen.
• PDF-filer större än 20 MiB kan inte sparas. Öppna dokumentet i Genie One istället.

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.

Visualizations

När en Genie-respons innehåller en visualisering visas diagrammet som en bild i svaret.

Visualiseringar visas inte när meddelandesynligheten är inställd på privat, eftersom privata meddelanden endast är synliga för användaren som frågat.

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

Dataroutning

Genie bearbetar dina frågor och lagrar konversationshistorik i din arbetsplatss område. Förfrågningar mellan Microsoft Teams och din arbetsyta går via en central Azure Databricks-tjänst i Azure Databricks kontrollplan. Den centrala tjänsten går i East US 2-regionen, oavsett vilken region din arbetsyta befinner sig i. Den centrala tjänsten sparar permanent eller loggar inte något förfrågnings- eller svarsinnehåll. Den lagrar endast mappningen mellan din Microsoft Teams-tenant och din Azure Databricks-arbetsyta.

Microsoft Teams behöver en fast slutpunkt för att ta emot förfrågningar, så appen använder en central tjänst.

När du ställer en fråga i Microsoft Teams:

1. Microsoft Teams skickar din fråga till den centrala tjänsten.
2. Den centrala tjänsten vidarebefordrar förfrågan till din Azure Databricks workspace.
3. Genie bearbetar förfrågan och genererar ett svar i din arbetsyta.
4. Svaret återvänder till Microsoft Teams via den centrala tjänsten.

När du sparar ett dokument som PDF laddar appen ner PDF:en från din arbetsyta och laddar upp den till din OneDrive via East US 2. Appen lagrar inte PDF:en.

Ö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.
• Filuppladdning stöds endast i direktmeddelanden. I kanaler, gruppchattar och Microsoft 365 Copilot svarar Genie inte på ett meddelande som innehåller bilagor. Istället svarar den att uppladdningar endast fungerar i ett direktmeddelande.
• Filuppladdning stödjer endast PDF-, Word (.docx)- och CSV-filer på 20 MiB eller mindre, upp till fem filer per meddelande.
• Att spara dokument som PDF-filer är endast tillgängligt i direktmeddelanden. Genie erbjuder inte PDF:er i kanaler, gruppchattar eller Microsoft 365 Copilot. OneDrive och version 1.0.17 och senare av Databricks Genie-appen i Microsoft Teams krävs. PDF-filer större än 20 MiB kan inte sparas.
• Att trigga åtgärder i Azure Databricks från Teams stöds inte.

Ytterligare resurser

• Använda Genie One
• Chatta i Genie One
• Destinationer för Genie-appen för Slack och Microsoft Teams
• Support finns i hjälpcentret för Databricks.