Connettere Genie Code ai server MCP

Genie Code si collega a strumenti esterni, documenti e dati tramite server Model Context Protocol (MCP) e connettori nativi per Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack e GitHub. Usare i connettori nativi per origini SaaS comuni o aggiungere server MCP esterni o personalizzati dall'area di lavoro. È possibile scegliere gli strumenti da abilitare nelle impostazioni genie code.

Che cos'è MCP?

MCP è uno standard open source che connette gli agenti a strumenti, risorse, richieste e altre informazioni contestuali. MCP offre un modo standardizzato per esporre strumenti, dati e flussi di lavoro a Genie Code senza incorporare il contesto direttamente in prompt o istruzioni.

MCP è progettato per i casi in cui esiste già un contesto importante, ma è difficile da accedere da un agente, ad esempio Genie Code. MCP offre un modo sicuro per concedere a Genie Code l'accesso al contesto simile al seguente:

• Sistemi di documentazione: Teams spesso mantiene runbook o documenti operativi in strumenti come Confluence. Invece di copiare sezioni in richieste, tale contenuto può essere esposto una volta tramite un server MCP esterno e a cui viene fatto riferimento quando pertinente. I documenti potrebbero essere già presenti in Databricks come indice di ricerca di intelligenza artificiale, che Genie Code può usare per eseguire query sui documenti pertinenti.
• Strumenti e servizi: i team della piattaforma possono gestire API o script per la configurazione, la convalida o la distribuzione. MCP rende queste funzionalità direttamente disponibili per Genie Code.
• Origini dati: se si dispone già di dati in Databricks, è possibile connettere Genie Code a un agente Genie per analizzare i dati usando il linguaggio naturale. Per i dati archiviati all'esterno di Databricks, è possibile concedere a Genie Code l'accesso sicuro tramite server MCP esterni.
• App personalizzate: è anche possibile aggiungere funzionalità personalizzate ospitate tramite Databricks Apps. Ciò consente di connettere Genie Code a strumenti, flussi di lavoro o integrazioni proprietari creati in modo specifico per l'utente o l'organizzazione, tutti gestiti in modo sicuro all'interno dell'area di lavoro di Databricks.

In questi casi, MCP sostituisce il incollamento manuale con un approccio strutturato e riutilizzabile, rendendo disponibile il contesto corretto solo quando è necessario.

È possibile connettere Genie Code a qualsiasi server MCP nell'area di lavoro per cui si dispone dell'autorizzazione per l'uso. Gli amministratori dell'area di lavoro controllano quali server sono disponibili, mentre gli utenti possono selezionare le origini approvate in base alle esigenze.

Per saperne di più sui server MCP in Databricks e su come crearne uno proprio, consulta MCP e strumenti per agenti.

Usare connettori nativi per origini dati di terze parti

Genie Code fornisce connettori integrati per fonti di dati aziendali comuni:

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

Collegarsi a queste fonti di dati permette a Genie Code di cercare nei tuoi documenti e di agire tramite strumenti collegati quando risponde a domande. Ogni utente esegue l'autenticazione singolarmente e 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 Registra un server MCP esterno.

Per connettere un'origine dati di terze parti:

1. Nell'area di lavoro fare clic Genie Code nell'angolo superiore destro per aprire una chat.
2. Nella barra dei prompt fare clic su L'icona con il segno più.
3. Accanto all'origine dati a cui ci si vuole connettere, fare clic su Connetti.
4. Completare i passaggi per accedere.

Dopo l'autenticazione, Genie Code può cercare i documenti quando si rispondono alle domande. Gli amministratori e i proprietari delle connessioni metastore possono gestire o revocare le autorizzazioni utente per la connessione. Vedi Passo 4. Concedere l'accesso a un Servizio MCP.

Per connettere altre origini dati, aggiungerle manualmente a Genie Code. Vedere Aggiungere manualmente server MCP a Genie Code.

Compiti programmati e autenticazione

• Il Codice Genie 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.

Limitazioni di 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 è 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.
• Genie Code può creare Google Docs, Sheets e Slides, e modificare Google Docs che ha creato tramite il connettore. Non può modificare documenti creati al di fuori del connettore, né modificare fogli o slide esistenti.
• Leggere un documento molto grande può essere lento.

Limitazioni di Gmail

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

Limitazioni di Microsoft 365

• Include SharePoint, Teams, Outlook e il Calendario.
• Genie Code può redigere l'email di Outlook ma non può inviarla.
• La dimensione massima del file è di 25 MB per i file SharePoint.
• I tipi di file SharePoint supportati includono documenti Office (.docx, .xlsx, .pptx), così come formati comuni basati su testo come .txt, .csv, .json, .md, e altri. I file PDF, le immagini e altri formati binari non sono supportati.

Limitazioni di 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 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 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.

Limiti di flessibilità

• Genie Code non può modificare o cancellare un messaggio dopo averlo inviato.

limitazioni 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 di GitHub deve completare un'installazione aggiuntiva. Vedi Abilitare l'accesso al repository privato.
• GitHub Enterprise Server (la versione self-hosted di GitHub) non è supportata.

Aggiungere manualmente server MCP a Genie Code

Per connettere Genie Code a un server MCP, aggiungerlo nelle impostazioni di Genie Code:

1. Aprire le impostazioni di Genie Code. Nel riquadro Genie Code (Codice Genie) fare clic Impostazioni.
2. In Server MCP fare clic su Aggiungi server.
3. Selezionare i server MCP da aggiungere. È possibile selezionare server MCP gestiti di Databricks o server MCP esterni:
   • Funzione catalogo Unity: selezionare lo schema per la funzione. Ciò consente a Genie Code di usare le funzioni per eseguire query SQL predefinite.
     • Per informazioni sulla creazione di un server MCP GitHub personalizzato, vedere Search GitHub code with Genie Code.
   • Ricerca intelligenza artificiale: selezionare lo schema per l'indice. Ciò consente a Genie Code di eseguire query sull'indice di ricerca di intelligenza artificiale per trovare documenti pertinenti.
   • Agente Genie: selezionare l'agente Genie. Genie MCP richiama Genie come strumento, consentendo di eseguire query sull'agente Genie per analizzare i dati usando il linguaggio naturale.
   • Server MCP esterno: selezionare la connessione al catalogo Unity da usare come server MCP esterno. Prima di poterlo usare, è necessario accedere alla connessione.
   • Server MCP personalizzato: selezionare l'app Databricks da usare come server MCP personalizzato. In questo modo è possibile usare qualsiasi strumento personalizzato. Si applicano i requisiti seguenti:
     • L'app deve essere distribuita nella stessa area di lavoro da cui si sta provando a connettersi.
     • È necessario accedere al server MCP all'indirizzo https://<server-url>/mcp.
     • L'app deve essere senza stato. Ad esempio, impostare mcp_app = mcp_server.http_app(stateless_http=True).
     • Se si verificano errori CORS, potrebbe essere necessario aggiungere l'URL dell'area di lavoro all'elenco di origini consentite dell'app. Ad esempio, impostare app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
4. Fare clic su Salva.

Dopo l'aggiunta, i server MCP sono immediatamente disponibili per Genie Code. È possibile iniziare a usarli senza modificare le istruzioni o le richieste. Genie Code utilizza automaticamente questi server quando necessario.

È possibile scegliere quali strumenti e server abilitare o disabilitare nelle impostazioni genie Code.

Limitations

Per le linee guida di conformità per applicazioni connesse, vedi Limitazioni del servizio MCP fornito da Databricks.

• I server MCP esterni sono disponibili solo nelle aree in cui è supportata la gestione dei modelli. Vedere Disponibilità delle funzionalità di gestione dei modelli.