Připojte GitHub Copilot CLI

Používejte GitHub Copilot CLI s modely, MCP nástroji a dovednostmi prostřednictvím Unity Gateway. Unity Gateway CLI (ug) zajišťuje přihlášení a konfiguraci v pracovním prostoru. Připojení můžete také nastavit ručně.

Než začnete

Potřebujete URL pracovního prostoru Azure Databricks a přístup k modelům, MCP službám a dovednostem, které chcete používat. Pro ruční nastavení nainstalujte GitHub Copilot CLI a mějte osobní přístupový token Azure Databricks.

Pokud už váš administrátor vaše zařízení nakonfiguroval, postupujte podle pokynů vaší organizace.

Použijte Unity Gateway CLI

Instalujte , poté spusťte ugtento příkaz z adresáře vašeho projektu:

ug copilot

Postupujte podle pokynů k výběru pracovního prostoru a přihlášení. Příkaz otevře GitHub Copilot CLI s nakonfigurovaným modelem. Začněte pracovat se stejnými prompty a příkazy, které už používáte.

Začneme s jiným modelem dostupným ve vašem pracovním prostoru:

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

Použijte celý název modelu v Unity Catalog, například system.ai.claude-sonnet-4-6. Současná ug integrace konfiguruje modely Claude a GPT pro Copilot CLI.

Modely konfigurujte ručně

Nastavte tyto proměnné ve svém terminálu:

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"

Nahraďte název hostitele, token a název modelu. Typ poskytovatele openai vybírá rozhraní Chat Completions API brány, i když používáte model Claude. Offline režim deaktivuje připojení k serverům GitHub; modelové požadavky stále směřují do Unity Gateway.

Spusť Copilot CLI ze stejného terminálu:

copilot

Pro tato nastavení viz dokumentaci poskytovatele vlastních modelů GitHub.

Přidat nástroje MCP

Použijte Unity Gateway CLI

Běh:

ug mcp add --agents copilot

Vyberte služby, které chcete přidat, a pak začněte novou relaci s ug copilot. V Copilotu zadejte /mcp a zobrazte připojené servery. Požádejte agenta, aby použil nástroj a popsal, co potřebujete.

ug copilot Načte MCP spojení registrovaná pomocí ug. Pokračujte v používání na začátku svých sezení.

Ručně konfigurujte MCP služby

Sločte tento záznam do :~/.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": ["*"]
    }
  }
}

Nahraďte název hostitele a token. Pro jinou službu použijte unikátní název serveru a nahraďte system.ai.dbsql ho jeho třídílným názvem Unity Catalog. Nechte stávající serverové záznamy a pak restartujte Copilot CLI.

Viz dokumentaci MCP na GitHub.

Přidání dovedností

Použijte Unity Gateway CLI

Stáhněte si publikované dovednosti:

ug skills add

Vyberte si dovednosti, které chcete používat. Copilot CLI čte stažené soubory z ~/.agents/skills/. Začněte novou relaci nebo zadejte /skills reload a potom je zobrazte pomocí /skills list. Znovu spusťte příkaz ke stažení pro získání aktualizovaných verzí.

Manuální nastavení dovedností

Pokud už soubory skillů máte, umístěte kompletní složku včetně SKILL.md a přibalených souborů do ~/.agents/skills/ nebo do složky .github/skills/ vašeho projektu. Podívejte se na dokumentaci dovedností na GitHub.

Pro přístup k publikovanému registru dovedností přes MCP přidejte druhý server pomocí výše uvedené konfigurace MCP. Pojmenujte ho databricks-skill-registry a použijte tuto URL se stejným ověřením nositele:

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

Ponechte koncové lomítko. Restartujte Copilot CLI a požádejte ho, aby použil publikovanou dovednost pod jejím plným názvem. Dovednosti v registru jsou přístupné přes MCP; /skills list ukazuje nainstalované dovednosti.

Dovednosti Unity Gateway jsou v beta verzi. Viz Govern skills pro zpřístupnění a oprávnění.

Troubleshooting

Požadavek na model selže: Zkontrolujte URL brány, expiraci tokenu, plný název modelu a oprávnění modelu. Současná ug integrace vylučuje modely Gemini z Copilot CLI kvůli problému s kompatibilitou požadavků.

Chybí MCP server: Pokud jste ho zaregistrovali u ug, restartujte s .ug copilot Pro ruční nastavení zkontrolujte ~/.copilot/mcp-config.json a podrobnosti o připojení v /mcp.

Stažená dovednost chybí: Zkontrolujte, zda její složka obsahuje SKILL.md v podporovaném adresáři, potom zadejte /skills reload.

Pro problémy s přihlášením nebo nastavením ug v pracovním prostoru použijte ug doctor.

Další kroky

  • Last updated on