Verbind GitHub Copilot CLI

Gebruik GitHub Copilot CLI met modellen, MCP-tools en vaardigheden via Unity Gateway. De Unity Gateway CLI (ug) verzorgt het aanmelden en instellen van werkruimtes. Je kunt de verbindingen ook handmatig configureren.

Prerequisites

Je hebt je Azure Databricks workspace-URL nodig en toegang tot de modellen, MCP-services en vaardigheden die je wilt gebruiken. Voor handmatige installatie installeer je GitHub Copilot CLI en heb je een Azure Databricks persoonlijke toegangstoken.

Als je beheerder je apparaat al heeft geconfigureerd, volg dan de installatie-instructies van je organisatie.

Gebruik de Unity Gateway CLI

Installeer ugen voer vervolgens dit commando uit vanuit je projectmap:

ug copilot

Volg de instructies om je werkruimte te selecteren en in te loggen. Het commando opent GitHub Copilot CLI met een geconfigureerd model. Begin met dezelfde prompts en commando's die je al gebruikt.

Om te beginnen met een ander model dat beschikbaar is in uw werkplek:

ug copilot --model "<model-name>"

Gebruik de volledige Unity Catalog-naam van het model, zoals system.ai.claude-sonnet-4-6. De huidige ug integratie configureert de Claude- en GPT-modellen voor Copilot CLI.

Modellen handmatig configureren

Stel deze variabelen in in je terminal:

export COPILOT_PROVIDER_TYPE="openai"
export COPILOT_PROVIDER_BASE_URL="https://<workspace-hostname>/ai-gateway/mlflow/v1"
export COPILOT_PROVIDER_BEARER_TOKEN="<databricks-pat>"
export COPILOT_MODEL="system.ai.claude-sonnet-4-6"
export COPILOT_OFFLINE="true"

Vervang de hostnaam, token en modelnaam. Het openai type provider selecteert de Chat Completions API van de gateway, ook wanneer je een Claude-model gebruikt. Offline modus schakelt de verbindingen met de servers van GitHub uit; modelverzoeken gaan nog steeds naar Unity Gateway.

Start Copilot CLI vanaf dezelfde terminal:

copilot

Zie de documentatie van GitHub's custom model provider voor deze instellingen.

Voeg MCP-tools toe

Om system.ai.sandbox, system.ai.web_search of system.ai.dbsql te gebruiken, moet een accountbeheerder de Unity Gateway-bèta inschakelen via de pagina Previews van de accountconsole. Zie Voorbeelden van accounts beheren.

Gebruik de Unity Gateway CLI

Uitvoeren:

ug mcp add --agents copilot

Selecteer de diensten die je wilt toevoegen en start vervolgens een nieuwe sessie met ug copilot. Binnen Copilot, ga in /mcp om verbonden servers te zien. Vraag de makelaar om een hulpmiddel te gebruiken door te beschrijven wat je nodig hebt.

ug copilot laadt de MCP-verbindingen die door ugworden geregistreerd. Blijf het gebruiken om je sessies te starten.

Configureer MCP-services handmatig

Voeg deze vermelding samen in ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "dbsql": {
      "type": "http",
      "url": "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql",
      "headers": {
        "Authorization": "Bearer <databricks-pat>"
      },
      "tools": ["*"]
    }
  }
}

Vervang de hostnaam en token. Voor een andere dienst gebruik je een unieke servernaam en vervang system.ai.dbsql deze door de driedelige Unity Catalog-naam ervan. Behoud bestaande serververmeldingen en start dan Copilot CLI opnieuw.

Zie de MCP-documentatie van GitHub.

Vaardigheden toevoegen

Gebruik de Unity Gateway CLI

Download gepubliceerde vaardigheden:

ug skills add

Kies de vaardigheden die je wilt gebruiken. Copilot CLI leest de downloads uit ~/.agents/skills/. Start een nieuwe sessie, of voer /skills reload in en gebruik vervolgens /skills list om deze te bekijken. Voer het downloadcommando opnieuw uit om bijgewerkte versies te krijgen.

Configureer vaardigheden handmatig

Voor vaardigheidsbestanden die je al hebt, plaats je de volledige map, inclusief SKILL.md en gebundelde bestanden, in ~/.agents/skills/ of in die .github/skills/van je project. Zie de vaardighedendocumentatie van GitHub.

Om toegang te krijgen tot het gepubliceerde vaardigheidsregister via MCP, voeg je een tweede server toe met de MCP-configuratie hierboven. Geef hem databricks-skill-registry een naam en gebruik deze URL met dezelfde dragerauthenticatie:

https://<workspace-hostname>/ai-gateway/skills/

Houd de trailing slash aan. Start Copilot CLI opnieuw en vraag het om een gepubliceerde vaardigheid te gebruiken met zijn volledige naam. Registervaardigheden zijn toegankelijk via MCP; /skills list toont geïnstalleerde vaardigheden.

Unity Gateway-vaardigheden bevinden zich in de bètafase. Zie Vaardigheden beheren voor inschakelen en machtigingen.

Troubleshooting

Een modelverzoek faalt: Controleer de gateway-URL, tokenvervaldatum, volledige modelnaam en modelrechten. De huidige ug integratie sluit Gemini-modellen uit van Copilot CLI vanwege een compatibiliteitsprobleem met verzoeken.

Een MCP-server ontbreekt: Als je hem hebt geregistreerd bij ug, start opnieuw op met ug copilot. Voor handmatige configuratie controleert u ~/.copilot/mcp-config.json en de verbindingsdetails in /mcp.

Een gedownloade vaardigheid ontbreekt: Controleer of de map SKILL.md bevat en zich in een ondersteunde map bevindt, en voer daarna /skills reload in.

Voor aanmeldings- of installatieproblemen met de werkruimte, voer ug doctor uit.

Volgende stappen 

  • Laatst bijgewerkt om