App Databricks Genie in Microsoft Teams

L'app Databricks Genie in Microsoft Teams porta Genie in Microsoft Teams in modo che gli utenti possano porre domande sui dati e ottenere risposte senza uscire dall'area di lavoro Microsoft Teams. Gli utenti possono chattare con l'app in un messaggio diretto o menzionare @Databricks Genie in un canale Microsoft Teams o in una chat di gruppo. Le domande vengono risposte da Genie One o da un Agente Genie specifico che il proprietario del canale ha fissato per risposte coerenti e specifiche per ogni caso d'uso.

L'app Genie di Databricks in Microsoft Teams utilizza l'API Genie One in entrambi i casi; quando viene fissato un Genie Agent, Genie One inoltra la domanda solo a quell'agente. L'app utilizza gli stessi modelli di fornitori e garanzie di fiducia e sicurezza di Genie. Vedi Provider di hosting utilizzato quando l'impostazione delle funzionalità di IA basate su partner è attivata e disattivata e Attendibilità e sicurezza delle funzionalità di assistenza IA di Databricks.

Questa pagina descrive come scaricare, configurare e usare l'app Databricks Genie in Microsoft Teams.

Prerequisiti

Prima di installare l'app Databricks Genie in Microsoft Teams:

• Un amministratore dell'account deve abilitare Databricks Genie per Microsoft Teams anteprima nella console dell'account.
• Se l'area di lavoro usa una lista di accesso IP, aggiungi gli indirizzi IP in uscita del control plane di Azure Databricks nell'area East US 2. Vedi gli IP in uscita nella documentazione di Azure Databricks.

Installare l'app Databricks Genie in Microsoft Teams

Un amministratore di Microsoft 365 installa l'app Databricks Genie in Microsoft Teams dal marketplace di Microsoft:

1. Nel marketplace Microsoft cercare e trovare Databricks Genie.
2. Installare l'app.
3. Approvare le autorizzazioni dell'app quando richiesto durante l'installazione.

Per un elenco dei permessi richiesti, vedi Permessi richieste di app su Microsoft.

Dopo l'installazione, gli utenti possono iniziare a usare l'app.

Usare l'app Databricks Genie in Microsoft Teams

È possibile usare l'app Databricks Genie in Microsoft Teams tramite messaggi diretti o conversazioni di canale nell'area di lavoro Microsoft Teams o da Microsoft 365 Copilot.

Messaggio diretto

Per inviare direttamente un messaggio all'app Databricks Genie in Microsoft Teams:

1. In Microsoft Teams fare clic su App nella barra laterale sinistra e aprire l'app Databricks Genie in Microsoft Teams.
2. Immetti la domanda. Se non si è connessi, l'app Databricks Genie in Microsoft Teams chiede di eseguire l'accesso.
3. La domanda viene instradata all'agente Genie più appropriato e restituisce una risposta con fonti e richieste di follow-up suggerite.

Per configurare lo spazio di lavoro e l'ambito di Genie per tutte le successive conversazioni di messaggio diretto, apri l'app Databricks Genie nella home page di Microsoft Teams e regola le impostazioni.

Conversazione nel canale

È possibile aggiungere l'app Databricks Genie in Microsoft Teams a un canale. Usando config, i proprietari di canali possono configurare le impostazioni per tutti i membri di un canale e i singoli utenti possono configurare le impostazioni personali. Le configurazioni del proprietario del canale sostituiscono le configurazioni personali.

Per configurare l'app Databricks Genie in Microsoft Teams all'interno di un canale:

1. Nel canale desiderato digitare @Databricks Genie.

2. Se richiesto, aggiungere l'app Databricks Genie in Microsoft Teams al canale.

3. Digitare config.

4. Seleziona lo spazio di lavoro connesso, la visibilità del messaggio e l'ambito Genie (Genie One o un Agente Genie specifico).

   Se non è stato aggiunto alcun Genie Agent ai preferiti, il canale usa automaticamente Genie One.

5. Dopo la configurazione, tutte le @Databricks Genie menzioni nella route del canale vengono indirizzate all'agente e all'area di lavoro configurati.

Livelli di configurazione e sovrascritture

Eseguire config in un canale per aprire la finestra di configurazione. Le impostazioni seguenti sono configurabili:

• Selezione dell'area di lavoro: area di lavoro di Azure Databricks a cui si connette l'app Databricks Genie in Microsoft Teams per rispondere alle domande.
• Visibilità dei messaggi: indica se @Databricks Genie le risposte nei canali sono visibili a tutti i membri del canale o solo all'utente che ha chiesto. Per impostazione predefinita, le risposte sono pubbliche. Se un amministratore dell'area di lavoro imposta la visibilità dei messaggi su privato, l'area di lavoro supporta solo messaggi diretti, non canali o chat di gruppo.
• Ambito di Genie: un Genie One o uno specifico Genie Agent. Entrambi utilizzano l'API di Genie One; fissare un Genie Agent specifico indica a Genie One di inviare la domanda solo a quell'agente, per risposte coerenti e specifiche per ogni caso d'uso.

Le impostazioni di visibilità dei messaggi possono essere impostate a tre livelli. I livelli più elevati sostituiscono livelli inferiori:

Permessi di app richiesti su Microsoft

Quando installi l'app Databricks Genie in Microsoft Teams, richiede i seguenti permessi. I permessi Entra ID sono permessi Microsoft Graph a livello di tenant a cui un amministratore Microsoft 365 acconsente per la tua organizzazione. I permessi specifici per risorsa sono permessi di consenso specifico per risorse (RSC) di Teams che si applicano solo alla chat, al canale o al team dove l'app è installata.

Per maggiori informazioni su questi permessi, vedi Permessi specifici per risorse e Grafi nella documentazione Microsoft.

Risoluzione dei problemi

Messaggio "Need admin approval" (Richiesta approvazione amministratore) all'accesso

Quando si accede all'area di lavoro di Azure Databricks, viene visualizzato il messaggio "Richiesta approvazione amministratore" seguente perché il tenant Microsoft Entra blocca il consenso dell'utente per l'applicazione Azure Databricks. Se il consenso dell'amministratore non viene concesso, Microsoft Entra ID continua a bloccare il flusso di accesso anche se si dispone dell'accesso diretto all'area di lavoro.

Per risolvere questo problema, un utente Microsoft Entra con ruoli di amministratore appropriati deve concedere il consenso dell'amministratore a livello di tenant all'applicazione aziendale Azure Databricks.

Chiedere all'amministratore Microsoft Entra di visitare il collegamento seguente. Sostituire {TENANT_ID} con l'ID tenant Microsoft Entra:

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

Se il collegamento non riesce, l'amministratore può concedere il consenso manualmente:

1. Nel Interfaccia di amministrazione di Microsoft Entra passare a Entra ID>Enterprise apps>Tutte le applicazioni e trovare l'applicazione aziendale Azure Databricks usata per l'accesso Single Sign-On. Per identificare l'applicazione, cercare l'ID applicazione aaec40b0-c0ae-4211-a98b-6fc160abb71b.
2. Concedere il consenso amministratore per le autorizzazioni richieste dall'app aziendale Azure Databricks:
   1. In Sicurezza fare clic su Autorizzazioni.
   2. Fare clic su Concedi consenso amministratore.

Per istruzioni dettagliate, vedere la documentazione Microsoft.

Limitations

• Non è possibile specificare il calcolo (SQL Warehouse) usato dall'app Databricks Genie in Microsoft Teams. Azure Databricks seleziona automaticamente un'istanza di SQL Warehouse a cui l'utente è autorizzato ad accedere.
• Quando uno specifico agente Genie viene bloccato come ambito Genie, Genie One potrebbe riscrivere la domanda prima che raggiunga l’agente bloccato.
• Il feedback (pollice in alto o in giù) viene sempre inviato al Genio Uno, anche quando un agente Genio specifico è bloccato.
• PrivateLink non è supportato.
• Le funzionalità seguenti non sono supportate:
  • Visualizzazione dei grafici
  • Invio di notifiche Azure Databricks a Teams
  • Attivazione di azioni in Azure Databricks da Teams

Risorse aggiuntive

• Usa Genie One
• Chat in Genie One
• Usa Genie One
• Per il supporto, vedere il Centro assistenza di Databricks.