Collega un Genie Agent a strumenti e fonti esterne

Un Genie Agent può utilizzare connettori MCP (Model Context Protocol) forniti da Databricks per estrarre contesto e agire su strumenti e fonti esterne durante una conversazione in modalità Agente . Un agente autore collega i connettori e ogni utente si autentica a ciascuno di essi individualmente. Ogni chiamata allo strumento viene eseguita con i permessi dell'utente che pone la domanda.

Come funzionano i connettori MCP in un Genie Agent

I connettori MCP permettono a un Genie Agent di combinare le sue analisi SQL e dei file con le applicazioni esterne già utilizzate dalla tua organizzazione. Ad esempio, una singola conversazione può analizzare una tabella di vendita, estrarre contesto correlato da Google Drive e redigere un'email riassuntiva. Azure Databricks governa ogni chiamata di strumento tramite Unity Catalog e Unity Gateway. Consulta Governare un MCP.

Gli strumenti MCP si dividono in due categorie:

• Gli strumenti di sola lettura (ricerca, recupero e lista) funzionano automaticamente.
• Gli strumenti di scrittura (ad esempio, inviare un messaggio o scrivere un'email) mettono in pausa e chiedono all'utente di approvare l'azione prima che venga eseguita.

Gli Agenti Genie supportano i seguenti connettori MCP forniti da Databricks:

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

Requirements

I requisiti seguenti si applicano all'agente e ai relativi utenti:

• Catalogo Unity abilitato nell'area di lavoro.
• Modalità Agente disponibile nella tua regione. Vedere Servizi designati di Databricks.

• Unity Gateway disponibile nella tua regione. Vedi le regioni supportate.

• Sia l'accesso all'area di lavoro sia le autorizzazioni di accesso a Databricks SQL per ciascun utente dell'agente. Gli utenti solo Consumer, solo Databricks SQL e con solo account non possono usare gli strumenti MCP. Vedere Diritti di accesso.
• Un account per ogni utente dell'agente in ogni sistema esterno connesso

Aggiungi connettori a un Genie Agent

Per collegare connettori a un Genie Agent:

1. Apri il tuo Genie Agent.
2. Aprire la scheda Origini , quindi fare clic su Aggiungi.
3. Seleziona uno o più servizi MCP.

Per collegare un connettore, devi disporre di EXECUTE nel servizio MCP del connettore nel Catalogo Unity, oltre a USE CATALOG e USE SCHEMA nel catalogo e nello schema padre. I connettori che non sei autorizzato a eseguire non sono disponibili. Vedi gli MCP forniti da Databricks.

Configurare gli strumenti

Dopo aver collegato un connettore, configura come l'agente lo utilizza:

• Aggiungi una descrizione chiara che spieghi come e quando l'agente dovrebbe utilizzare gli strumenti del connettore. Ad esempio, puoi indicare all'agente un formato richiesto per il titolo del ticket o dirgli di consultare il profilo di un utente all'inizio di ogni conversazione.
• Abilita o disabilita i singoli strumenti all'interno di un connettore per determinare quali azioni l'agente può intraprendere.

Usa gli strumenti MCP in una conversazione

Per usare gli strumenti MCP in un Genie Agent:

1. Apri un Genie Agent con connettori MCP collegati.
2. Attivare la modalità agente nella casella di chat.
3. Autenticati al connettore dal pannello Configura. Se l'agente ha bisogno di un collegamento che non hai autorizzato, o la tua autenticazione è scaduta, l'agente ti chiede di accedere.
4. Invia un prompt che usa il connettore. Quando l'agente chiama uno strumento di scrittura, scegli Consenti una volta per approvare l'azione singola, Consenti sempre in questa chat per approvare quello strumento per il resto della conversazione, oppure Rifiuta per rifiutarlo.

Per confermare che un connettore funzioni, fai una domanda che lo richieda, ad esempio "Cerca nel mio Google Drive il piano vendite del Q3." L'agente cita la risorsa esterna utilizzata nella risposta.

Limitations

Si applicano le limitazioni seguenti:

• Gli strumenti MCP funzionano solo in modalità Agent. Non girano in modalità Chat.
• Attraverso le API della modalità Agente, funzionano solo gli strumenti di lettura e gli utenti non possono autenticarsi su un connettore. Completa l'autenticazione e approva lo strumento di scrittura nell'interfaccia utente.
• Per le linee guida sulla conformità per applicazioni connesse, vedi Requisiti fornitori esterni.

Le sezioni seguenti descrivono le limitazioni per connettori specifici.

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.

Risorse aggiuntive

Per informazioni correlate, vedere le risorse seguenti:

• Collega Genie One a strumenti e fonti esterne
• MCP forniti da Databricks
• Provider OAuth gestiti
• Server MCP esterni
• Governance dell'IA con Unity Gateway