Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
I denna handledning kopplar du en extern kodagent, såsom Claude Code, Codex, GitHub Copilot, Cursor eller Gemini CLI, till stora språkmodeller (LLM) som styrs av Unity Gateway. Sedan styr du vem som kan komma åt dessa modeller och hur mycket agenten kan använda och spendera. Istället för att varje utvecklare klistrar in en leverantörs-API-nyckel i sitt verktyg, går varje förfrågan via en Unity Gateway-modelltjänst. Unity Catalog styr vem som får använda vilka modeller, och Unity Gateway upprätthåller begränsningar samt poster för användning och kostnad.
I slutet av den här självstudien har du:
- En kodagent som skickar varje modellförfrågan via Unity Gateway med dina Azure Databricks-inloggningsuppgifter, utan någon leverantörs-API-nyckel på utvecklarens dator.
- Centrala register över agentens användning och kostnader, beroende på de frekvensbegränsningar och behörigheter som du anger för modelltjänsten.
Prerequisites
- En arbetsyta aktiverad för Unity Catalog. Se Kom igång med Unity Catalog.
- En modelltjänst som dirigerar trafik till och
EXECUTEpå den. Azure Databricks värdbaserade modeller är tillgängliga som färdiga modelltjänster direkt. Se Anpassade modelltjänster. Om du vill styra en modell som du hanterar själv skapar du en först. Se Skapa en anpassad modelltjänst . - Azure Databricks CLI, autentiserad för din arbetsyta.
- URL till din Azure Databricks-arbetsyta i formatet
https://<workspace-url>.
Steg 1: Anslut kodningsagenten
Du kan ansluta agenten på något av två sätt:
- Unity Gateway CLI (rekommenderas): En öppen källkods-launcher som hanterar OAuth och skriver varje agents konfigurationsfil, inklusive modellens servicebas-URL och modell. Du hanterar inte API-nycklar eller slutpunkter för hand.
- Manuell konfiguration: Ange modelltjänstens bas-URL och modellen själv i verktygets inbyggda inställningar (Claude Code, Codex, Cursor eller Gemini CLI). Se kodnings- och arbetsagenter som stöds.
Denna sektion använder Unity Gateway CLI. Installera den och kör sedan den agent som du vill ha:
uv tool install git+https://github.com/databricks/unity-gateway
Claude Code
ug claude
Codex
ug codex
För att köra i icke-interaktivt läge, skicka agentens egen flagga genom Unity Gateway CLI:
ug codex --full-auto
Gemini CLI
ug gemini
OpenCode
ug opencode
GitHub Copilot
ug copilot
Vid första körningen begär Unity Gateway CLI din workspace-URL och autentiserar; senare körningar går direkt till agenten.
Steg 2: Hantera agentens modellåtkomst
Du kan styra en modelltjänst precis som alla andra skyddsbara objekt i Unity Catalog: bevilja EXECUTE för att kontrollera vem som kan använda den, och använd Unity Gateway för att sätta ett tak för begärandevolym och kostnader. Konfigurera något av följande:
-
Hantera vem som kan komma åt modellen: I Katalogutforskaren, öppna modelltjänsten och bevilja
EXECUTEtill användare eller grupper under fliken Behörigheter . - Begränsa begärandevolymen: I Catalog Explorer, på modelltjänstens flik Översikt, klicka på Set up under Gränser för begärandefrekvens. Ange en hastighetsgräns för begäranden per minut (QPM) eller token per minut (TPM) för alla begäranden på slutpunkten eller per användare.
- Sätt en budget: En kontoadministratör kan skapa en budget som omfattar alla Unity Gateway-endpoints. Budgeten aggregerar utgifter för dina modelltjänster. ange ett aviseringströskelvärde som ska meddelas eller blockera användning innan kostnaderna överskrider den.
Steg 3: Kontrollera att trafiken styrs
Bekräfta att agentens förfrågningar går via Unity Gateway och registreras:
Från agenten: Skicka en prompt. Agenten svarar med den modell som du konfigurerade, utan någon provider-API-nyckel på datorn.
Från systemtabellen för användning: Fråga användningsspårningen för att bekräfta att din modelltjänst registrerar förfrågningarna:
SELECT service_name, requester, status_code, COUNT(*) AS calls FROM system.ai_gateway.usage WHERE service_type = 'MODEL_SERVICE' GROUP BY service_name, requester, status_code ORDER BY calls DESC;
För att analysera utgifter mer i detalj, se Analysera kostnaden för Unity Gateway.