A Copilottal kapcsolatos problémák elhárítása az SQL Server Management Studióban

Általános naplózás

Olyan helyzetekben, ahol további részletekre van szükség a probléma kivizsgálásához, megtekintheti a Copilot-parancsokat a kimeneti ablakban aKimenet> és a Copilot kiválasztása a legördülő listából. Másik lehetőségként mentheti az adatokat a /log parancssorban található paranccsal.

Konfiguráció

Ha az első futtatáskor (a Copilot első indításakor a kezdeti párbeszédpanelen) adja meg a végpont és az üzembe helyezés értékeit, és a folyamatjelző ismétel, ellenőrizze a böngészőben a Microsoft Entra hitelesítési párbeszédpanelt.

Naplórögzítés

Ha a végpont és az üzembehelyezési értékek első futtatásakor (a Copilot első indításakor a kezdeti párbeszédpanelen) való megadása után hibaüzenet jelenik meg, a hibaüzenetek listájával háríthatja el a további hibákat, vagy rögzítheti a naplókat a kimeneti ablakban.

1. Lépjen az Eszközök > beállításai > copilot elemre a végpont és az üzembe helyezés értékeinek megadásához, majd kattintson az OK gombra.
2. Ebben a párbeszédpanelben nem történik ellenőrzés.
3. A Copilot megnyitása előtt nyissa meg a Kimenet megtekintése > lehetőséget a kimeneti megjelenítő megnyitásához.
4. Az eszköztár Copilot gombjára kattintva indítsa el a Copilotot az SSMS-ben.
5. Indításkor a rendszer kérni fogja, hogy hitelesítse magát az Azure-ban, kivéve, ha API-kulcsot használ.
6. Ha nem látja a hitelesítésre vonatkozó kérést, ellenőrizze a böngészőben a Microsoft Entra hitelesítési párbeszédpanelt.
7. Ha hibát lát a Copilot-csevegésben, válassza a Copilot elemet a kimeneti megjelenítő legördülő listájából.
8. A kimeneti megjelenítőben található információk további hibaelhárításhoz használhatók.

Hozzáférés tesztelése

Az Azure Command-Line Interfact (CLI) használatával ellenőrizheti, hogy rendelkezik-e hozzáféréssel az Azure OpenAI-erőforrásokhoz. Az Azure CLI-t ugyanazon a gépen kell telepíteni, mint az SQL Server Management Studiót (SSMS). Ha az Azure OpenAI-erőforrások Microsoft Entra-hitelesítést használnak, a PowerShell-szkript futtatása előtt be kell az loginjelentkeznie az Azure-ba . A szkripthez meg kell követelni annak az erőforráscsoportnak a nevét, amelyben az Azure OpenAI-erőforrások találhatók, valamint a végponterőforrás nevét. Ha a szkript sikeresen befejeződött, az elérhető Azure OpenAI-modellek jelennek meg kimenetként.

# Set your Azure OpenAI resource values
$resourceGroup = "msdocs-azuresql-rg-$randomIdentifier"
$resourceName = "copilot-in-ssms"

# ---- Get the endpoint ----
$endpoint = az cognitiveservices account show `
    --name $resourceName `
    --resource-group $resourceGroup `
    --query "properties.endpoint" `
    --output tsv

if (-not $endpoint) {
    Write-Host "Couldn't retrieve endpoint. Check resource group/name." -ForegroundColor Red
    exit 1
}

# ---- Get an API key for the resource ----
$apiKey = az cognitiveservices account keys list `
    --name $resourceName `
    --resource-group $resourceGroup `
    --query "key1" `
    --output tsv

if (-not $apiKey) {
    Write-Host "Couldn't retrieve API key. Check permissions." -ForegroundColor Red
    exit 1
}

# ---- Make a request to /openai/models ----
$headers = @{
    "api-key" = $apiKey
    "Content-Type" = "application/json"
}
$url = "$endpoint/openai/models?api-version=2024-02-01"

try {
    $response = Invoke-RestMethod -Method Get -Uri $url -Headers $headers
    Write-Host "✅ Successfully connected to Azure OpenAI endpoint and listed models:" -ForegroundColor Green
    $response.data | Select-Object id
}
catch {
    Write-Host "❌ Failed to connect or authenticate with Azure OpenAI endpoint." -ForegroundColor Red
    Write-Host $_.Exception.Message
    exit 1
}

Hibaüzenetek

Hiba	Következő lépések
Érvénytelen URI: az URI formátuma nem határozható meg	Győződjön meg arról, hogy a végpont és az üzembe helyezés értékei nincsenek véletlenül felcserélve.
Ismeretlen végpont: 'https://value-for-endpoint.openai.azure.com/'. Ellenőrizze a végpontot.	Győződjön meg arról, hogy rendelkezik az Azure OpenAI-végpont megfelelő értékével.
Az erőforrás API-telepítése nem létezik.	Ha az üzembe helyezés az elmúlt öt (5) percben jött létre, várjon, majd próbálkozzon újra.
	Győződjön meg arról, hogy rendelkezik a megfelelő értékkel az Azure OpenAI üzembe helyezéséhez.
	Győződjön meg arról, hogy az üzembe helyezés nevének elején vagy végén nincsenek üres szóközök.
	Ha az üzembe helyezés értéke helyes, és az üzembe helyezés nemrég lett létrehozva, várjon néhány percet, és próbálkozzon újra.
A hozzáférés érvénytelen előfizetési kulcs vagy hibás API-végpont miatt megtagadva. Győződjön meg arról, hogy érvényes API-kulcsot ad meg egy aktív előfizetéshez, és használja a megfelelő regionális API-végpontot az erőforráshoz.	Ellenőrizze a telepítés konfigurációját, és hogy a Microsoft Entra hitelesítést, vagy az API-kulcsot használja. Ez a hiba akkor jelenhet meg, ha az üzembe helyezés Microsoft Entra-hitelesítést használ, és beír egy API-kulcsot.
	Ha az üzembe helyezés API-kulcsot használ, győződjön meg arról, hogy az API-kulcs helyes, és nem váltott új értékre.
HTTP 400-hiba	Az üzembe helyezés nincs konfigurálva a gpt-4o modellel.
HTTP 429-hiba	A végpont szabályozása megtörtént.