Collega Genie One a strumenti e fonti esterne

Collega fonti di dati esterne a una chat su Genie One per cercare i documenti e i dati aziendali quando rispondi alle domande. Ogni utente esegue l'autenticazione singolarmente. I token OAuth non vengono condivisi tra gli utenti.

Queste connessioni utilizzano connettori MCP forniti da Databricks, quindi non c'è un server da ospitare né un'app OAuth da registrare. Azure Databricks governa ogni connessione tramite Unity Catalog e Unity Gateway. Il gateway autorizza ogni chiamata a uno strumento in base alle autorizzazioni di Unity Catalog, applica criteri integrati e requisiti di approvazione e registra i log di utilizzo e di audit nelle tabelle di sistema. Vedi Server MCP esterni.

Le connessioni supportate includono:

• Google Drive: Cerca e crea Google Docs, Sheets e Slides; modifica i documenti che ha creato.
• Gmail: Cerca, leggi e redige le email.
• Google Calendar: Cerca e crea eventi nel calendario.
• Microsoft 365: cerca SharePoint, Teams, Outlook e Calendar; redigi email di Outlook.
• Atlassian: Cerca e aggiorna Jira e Confluence.
• Glean (Beta): Cerca tra le app connesse della tua organizzazione usando Glean.
• Slack: Cerca messaggi e canali di Slack e invia messaggi.
• GitHub: Cerca e aggiorna i repository, le issue e le pull request.

Connetti un'origine dati esterna

1. Nella home page di Genie One fare clic 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. Puoi creare un servizio MCP personalizzato nel Catalogo Unity. Vedi 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. Vedi Condividi un MCP.

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 richiesti da ciascun provider OAuth gestito e lo scopo di ciascun ambito, vedi Managed OAuth providers. Il set esatto di scopi richiesti per una connessione appare nella schermata di consenso del provider quando ti connetti.

Per le linee guida sulla conformità per applicazioni connesse, vedi Requisiti fornitori esterni.

Limitations

Le connessioni esterne sono disponibili solo nelle regioni supportate da Unity Gateway.

Vedi le regioni supportate.

Compiti programmati e autenticazione

• La chat non ti avvisa quando l'autenticazione di una connessione scade. Potresti scoprirlo solo quando una chiamata di uno strumento fallisce o quando apri la lista delle connessioni. Ripetere l'autenticazione per la risoluzione.
• Modificare i permessi di una connessione richiede che ogni utente si riautentichi. I compiti programmati che utilizzano la connessione falliscono finché l'utente non si riautentica.

Google Drive

• Quando autorizzi Google Drive, potresti vedere una schermata App non verificata. Fare clic su Avanzate e continuare il processo di autorizzazione.
• La dimensione massima del file è di 25 MB.
• Sono supportati solo i file nativi di Google Workspace (Docs, Sheets, Slides). I file PDF, le immagini e altri formati binari non sono supportati.
• Il connettore può creare Google Docs, Sheets e Slides, e modificare Google Docs che ha creato. Non può modificare documenti creati al di fuori del connettore, né modificare fogli o slide esistenti.
• Leggere un documento molto grande può essere lento.

Gmail

• Il connettore può cercare, leggere e redigere email, ma non può inviare email o modificare messaggi esistenti.
• Il connettore non può aggiungere file Drive come allegati nativi di Gmail. Come soluzione alternativa, includere i link ai file nel corpo dell'email.

Microsoft 365

• Include SharePoint, Teams, Outlook e il Calendario.
• Il connettore può rediggere l'email di Outlook ma non può inviarla.
• La dimensione massima del file è di 25 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.

Glean (Beta)

• Glean è solo per la ricerca. Non può leggere un documento da un collegamento diretto.
• 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.

Slack

• Il connettore non può modificare o cancellare un messaggio dopo averlo inviato.

GitHub

• Le scritture sono limitate al contenuto dei file, ai problemi e alle pull request.
• 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 in scrittura a GitHub e l'accesso al repository privato".
• GitHub Enterprise Server (la versione self-hosted di GitHub) non è supportata.

Servizio MCP personalizzato

Crea il Servizio MCP prima di aggiungerlo a una conversazione in chat. Se il servizio utilizza OAuth per utente, ogni utente deve accedere prima di utilizzarlo. Vedi Server MCP esterni.