Cerca il codice su GitHub con Genie Code

Genie Code può cercare nei repository GitHub quando lo colleghi tramite il connettore GitHub nativo di Databricks o un server MCP GitHub personalizzato. Usare il connettore nativo per la maggior parte dei casi. L'accesso al repository privato richiede che un amministratore dell'organizzazione GitHub installi l'app di connessione GitHub di Databricks.

Usare il connettore nativo (scelta consigliata)

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. Vedere Gestire le anteprime di Azure Databricks.

Per connettere Genie One o Genie Code a GitHub, usare il connettore di terze parti Databricks. Vedi Usa connettori nativi per fonti dati di terze parti e Collega Genie One a strumenti e sorgenti esterni. Per i repository privati, gli amministratori devono abilitare l'accesso.

Registra un server MCP personalizzato su GitHub (non consigliato)

Salta questa sezione se il tuo workspace Azure Databricks ha già un servizio MCP del GitHub Unity Catalog disponibile da usare. Se hai bisogno solo di accedere a repository pubblici e alle informazioni del tuo account, usa OAuth gestito e vai a Registrare una connessione Unity Catalog come servizio MCP.

Segui i passaggi seguenti per registrare un server GitHub MCP personalizzato come Servizio MCP per le tue specifiche esigenze di dati e sicurezza. Per prima cosa, scegli come il tuo servizio MCP si autentica:

  • Managed OAuth: Databricks gestisce l'app GitHub OAuth e le credenziali. Salta l'app GitHub e i passaggi client secret qui sotto, poi scegli il provider gestito quando crei la connessione.
  • OAuth personalizzato: crea la tua app GitHub e fornisci le sue credenziali quando crei la connessione.

Crea un'app GitHub (solo OAuth personalizzato)

  1. Crea un'app GitHub. Per le codebase aziendali, un amministratore dell'organizzazione GitHub deve completare questo passaggio.

    • Passare a Impostazioni > profilo > Impostazioni sviluppatore > GitHub App e fare clic su Nuova app GitHub.
    • Compilare i campi richiesti. L'URL di callback deve essere https://<your-databricks-workspace-url>/login/oauth/http.html. Questo è il modo in cui GitHub esegue l'autenticazione con l'area di lavoro di Databricks.
      • L'URL della home page non influisce sul server MCP e può essere impostato su qualsiasi valore preferito.
      • Deselezionare la casella di controllo Attiva per impostare l'URL del webhook come campo facoltativo.
    • Concedere all'app GitHub le autorizzazioni necessarie per accedere al repository e all'organizzazione.
    • Fare clic su Crea app GitHub.

  2. Nell'app appena creata, in Segreti client, fare clic su Genera un nuovo segreto client. Copiare questo valore.

Registra una connessione Unity Catalog come Servizio MCP

  1. Crea o riutilizza una connessione HTTP del Catalogo Unity per GitHub. Devi avere CREATE CONNECTION privilegi sullo schema per crearne uno. Se riutilizzi una connessione esistente, devi avere USE CONNECTION su di essa. Continua a registrare quella connessione come Servizio MCP nel prossimo passo. Per una nuova connessione, utilizza una delle seguenti opzioni di autenticazione:

    • OAuth gestito: Seleziona il tipo di autenticazione OAuth User to Machine Per User e il provider OAuth di GitHub. Databricks fornisce l'host GitHub, il percorso base e le credenziali OAuth.
    • OAuth personalizzato: seleziona il tipo di autenticazione OAuth da utente a macchina per utente e il provider OAuth configurazione manuale. Immettere i valori seguenti:
      • Conduttore: https://api.githubcopilot.com
      • Ambito OAuth: ambiti di accesso dell'app. Ad esempio, mcp:access read:user user:email repo read:org
      • Client secret e client ID: generati nei passaggi precedenti dell'app GitHub
      • Endpoint di autorizzazione: https://github.com/login/oauth/authorize
      • Endpoint del token: https://github.com/login/oauth/access_token
      • Percorso di base: /mcp
    • Fai clic su Crea connessione.

  2. Registra un servizio MCP che utilizza la connessione HTTP. Per i permessi richiesti, vedi Server MCP esterni.

    • Nel tuo spazio di lavoro Azure Databricks, vai su Catalogo, seleziona uno schema e fai clic su Crea>Servizio MCP.
    • Inserisci il catalogo, lo schema e il nome del Servizio MCP.
    • Seleziona la connessione HTTP che hai creato o riutilizzato, seleziona gli strumenti da esporre e clicca su Crea.

  3. Se hai scelto OAuth per utente, apri il Servizio MCP in Esplora cataloghi e clicca su Login per autorizzare il tuo account GitHub.

  4. Concedere agli utenti o ai gruppi EXECUTE sul Servizio MCP, oltre a USE CATALOG e USE SCHEMA nel catalogo e nello schema padre. Non concedere agli utenti USE CONNECTIONfinali. Vedi Condividi un MCP.

Il tuo servizio GitHub MCP è pronto all'uso. Aggiungilo a Genie Code.

  • Ultimo aggiornamento: