Connettersi a strumenti e origini esterni

Importante

Questa funzionalità è in versione beta. Gli amministratori dell'area di lavoro possono controllare l'accesso a questa funzionalità dalla pagina Anteprime . Vedere Gestire le anteprime di Azure Databricks.

È possibile connettere origini dati esterne a una conversazione di chat in Genie One. Ciò consente alla chat di cercare i documenti e i dati aziendali quando si rispondono alle domande. Ogni utente esegue l'autenticazione singolarmente. I token OAuth non vengono condivisi tra gli utenti.

Le connessioni supportate includono:

  • Google Drive: Cerca in Google Docs, Fogli e Presentazioni.
  • Gmail: cerca contenuto di posta elettronica.
  • Microsoft 365: cerca SharePoint, Teams, Outlook e Calendario.
  • Atlassian: Cerca Jira e Confluence.
  • Glean: eseguire ricerche nelle app connesse dell'organizzazione tramite Glean.
  • Slack: Cerca messaggi e canali Slack.

Connetti un'origine dati esterna

La connessione di origini dati esterne richiede che i connettori di terze parti per Agents Beta siano abilitati nell'area di lavoro. Vedere Gestire le anteprime di Azure Databricks.

  1. Nella home page di Genie One fare clic sull'icona Plus. Più icona nella parte inferiore sinistra della barra di ricerca.

  2. Selezionare un'origine dati.

    Per connettere altre origini dati, fare clic su Altre connessioni nella parte inferiore dell'elenco. È possibile creare una connessione MCP personalizzata nel catalogo unity. Consultare Usare server MCP esterni.

  3. Fare clic su Accedi e completare i passaggi per accedere.

La connessione è stata aggiunta alla tua conversazione. La chat può ora cercare i documenti quando si rispondono alle domande. Dopo la creazione di una connessione, gli amministratori del metastore e i proprietari di connessioni possono gestire o revocare le autorizzazioni utente. Vedere Passaggio 4. Concedere l'accesso ai compagni di squadra.

Annotazioni

Gli strumenti dell'origine dati potrebbero non essere sempre attivati automaticamente. Se la ricerca di documenti non viene avviata, provare a richiedere esplicitamente alla chat di usare lo strumento, ad esempio "usare Google Drive" o "usare SharePoint".

Scrivere azioni

Alcuni strumenti MCP connessi possono eseguire azioni di scrittura nell'applicazione sorgente, non solo cercare e leggere dati. Se una connessione può scrivere, e quali azioni può intraprendere, dipende dallo strumento, dall'ambito OAuth a cui acconsenti quando ti connetti e dai tuoi permessi nell'applicazione sorgente.

Ambiti di autorizzazione OAuth

Quando colleghi una fonte di dati esterna, il suo fornitore ti chiede di acconsentire a un insieme di scope OAuth. Gli scope definiscono il massimo insieme di azioni che una connessione può tentare per tuo conto. Ogni utente consente individualmente, e il contenuto a cui una connessione può accedere dipende ancora da come la tua organizzazione configura la connessione e dai tuoi permessi nell'applicazione sorgente.

Azure Databricks gestisce le credenziali OAuth per queste connessioni. Per l'elenco completo degli ambiti richieste da ciascun fornitore OAuth gestito e lo scopo di ciascun ambito, vedi Servizi esterni con OAuth gestito. Il set esatto di scopi richiesti per una connessione appare nella schermata di consenso del provider quando ti connetti.

Limitations

Le connessioni esterne sono disponibili solo nelle aree in cui è supportata la gestione dei modelli.

Vedi le regioni supportate.

Google Drive

  • Quando si autorizza Google Drive, è possibile che venga visualizzata una schermata "app non verificata". Fare clic su Avanzate e continuare il processo di autorizzazione.
  • La dimensione massima del file è 10 MB.
  • Sono supportati solo i file predefiniti di Google Docs. I file PDF, le immagini e altri formati binari non sono supportati.
  • Gli errori di scadenza della connessione o del token potrebbero essere visualizzati nell'output dell'agente. Ripetere l'autenticazione alla connessione da risolvere.

Annotazioni

L'uso e il trasferimento dei dati utente non elaborati o derivati ricevuti dalle API di Google Workspace saranno conformi ai criteri dei dati utente dei servizi API Google, inclusi i requisiti di utilizzo limitato.

Gmail

  • La chat può cercare e leggere il contenuto della posta elettronica, ma non può inviare o modificare i messaggi di posta elettronica.

Microsoft 365

  • Include SharePoint, Teams, Outlook e il Calendario.
  • La dimensione massima del file è 10 MB per i file SharePoint.
  • I tipi di file supportati da SharePoint includono documenti SharePoint integrati, fogli di calcolo e presentazioni, nonché formati comuni basati su testo, ad esempio .txt, .csv, .json, .md e altri. I file PDF, le immagini e altri formati binari non sono supportati.

Atlassian

  • Comprende Jira e Confluence.
  • Un amministratore dell'area di lavoro deve configurare la connessione Atlassian prima che gli utenti non amministratori possano usarla.

Glean

  • Un amministratore del metastore deve prima configurare l'ID tenant di Glean prima che gli utenti non amministratori possano utilizzare la connessione. L'amministratore può immettere l'ID tenant quando ci si connette per la prima volta a Glean.
  • Per connettersi a uno specifico server MCP di Glean, un amministratore del metastore può opzionalmente impostare il percorso del server MCP (ad esempio, /mcp/eng) durante la configurazione della connessione. Lascia questo campo vuoto per usare il percorso predefinito (/mcp/default). Gli utenti non amministratori non possono specificare o modificare il percorso del server MCP di Glean.

GitHub

  • Per impostazione predefinita, il connettore Databricks GitHub MCP può accedere solo ai repository pubblici. Per concedere al connettore l'accesso in lettura ai repository aziendali privati, un amministratore dell'organizzazione GitHub deve completare l'installazione aggiuntiva. Vedi Abilitare l'accesso al repository privato.
  • GitHub Enterprise Server (la versione self-hosted di GitHub) non è supportata.

Connessione MCP personalizzata

  • Databricks consiglia di usare OAuth da computer a computer (M2M) durante la configurazione della connessione. U2M OAuth richiede un'installazione aggiuntiva per registrare l'URI di reindirizzamento dell'area di lavoro in un'app OAuth personalizzata.
  • La connessione deve essere creata prima di poterla aggiungere a una conversazione di chat.