Connettere Genie Code ai server MCP

Connettere Genie Code a strumenti esterni e origini dati tramite il protocollo MCP (Model Context Protocol). Genie Code può usare tutti i server MCP che sono stati aggiunti alla tua area di lavoro e per cui si ha l'autorizzazione per l'uso.

Annotazioni

I server MCP sono supportati solo in modalità Agente codice Genie.

Che cos'è MCP?

MCP è uno standard open source che connette gli agenti di intelligenza artificiale 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 accedere da un agente di intelligenza artificiale, 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 vettoriale, 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 uno spazio 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 altre informazioni sui server MCP in Databricks e su come creare i propri, vedere Model Context Protocol (MCP) in Databricks.

Connettersi a origini dati di terze parti

Importante

Questa funzionalità è in versione beta. Per usare connettori di origine dati di terze parti, un amministratore dell'area di lavoro deve abilitare la funzione di anteprima Connettori di Terze Parti per Agenti. Consultare Gestisci anteprime Azure Databricks.

Genie Code offre connettori predefiniti per le origini dati aziendali comuni, tra cui Google Drive e SharePoint.

La connessione a queste origini dati consente a Genie Code di cercare i documenti quando si rispondono a domande. Ogni utente esegue l'autenticazione singolarmente e i token OAuth non vengono condivisi tra gli utenti.

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 metastore e i proprietari delle connessioni possono gestire o revocare le autorizzazioni utente per la connessione. Vedere Condividere la connessione al server MCP.

Annotazioni

Gli strumenti di origine dati non vengono sempre attivati automaticamente. Se la ricerca di documenti non viene avviata, provare a richiedere esplicitamente a Genie Code di usare lo strumento, ad esempio "usare Google Docs" o "usare SharePoint".

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

Limitazioni di Google Drive

• La dimensione massima del file è 10 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.
• Gli errori di scadenza della connessione o del token potrebbero essere visualizzati nell'output dell'agente. Ripetere l'autenticazione per la risoluzione.

limitazioni SharePoint

• La dimensione massima del file è 10 MB.
• I tipi di file supportati includono documenti di Office (.docx, .xlsx, .pptx), 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.

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 pannello Genie Code 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 su come aggiungere un server MCP GitHub, vedere creare un server MCP GitHub.
   • Ricerca vettoriale: selezionare lo schema per l'indice. Ciò consente a Genie Code di eseguire una query sull'indice di ricerca vettoriale per trovare i documenti pertinenti.
   • Spazio genie: selezionare lo spazio Genie. Genie MCP richiama Genie come strumento, consentendo di eseguire query sullo spazio 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 in modalità Agent senza modificare le istruzioni o le richieste. Genie Code utilizzerà automaticamente questi server quando necessario.

Attualmente, l'accesso MCP è limitato a 20 strumenti in tutti i server. È possibile scegliere quali strumenti e server abilitare o disabilitare nelle impostazioni genie Code.