SQL Server Management Studio'da Copilot ile ilgili sorunları giderme

Genel günlük kaydı

Bir sorunu araştırmak için daha fazla ayrıntıya ihtiyaç duyulan senaryolarda,Çıktıyı> ve açılan listeden Copilot'ı seçerek Çıkış penceresinde Copilot komutlarını görüntüleyebilirsiniz. Alternatif olarak, bilgi istemi kutusundaki komutu kullanarak /log bilgileri kaydedebilirsiniz.

Konfigürasyon

İlk çalıştırma deneyimine uç nokta ve dağıtım değerlerini girerseniz (Copilot'u ilk kez başlattığınızda başlangıç iletişim kutusu) ve ilerleme çubuğu yineleniyorsa, tarayıcınızda Microsoft Entra kimlik doğrulama iletişim kutusunu kontrol edin.

Kayıt yakalama

İlk çalıştırma deneyiminde (Copilot'u ilk kez başlattığınızda ilk iletişim kutusu) uç nokta ve dağıtım değerlerini girdikten sonra hata alırsanız, daha fazla sorun gidermek için hata iletileri listesini kullanın veya çıkış penceresinde günlükleri yakalayın.

1. Uç nokta ve dağıtım değerlerini girmek için Araçlar > Seçenekleri > Copilot'a gidin ve Tamam'ı seçin.
2. Bu iletişim kutusunda doğrulama gerçekleşmez.
3. Copilot'ı açmadan önce Çıkışı Görüntüle'ye > giderek çıkış görüntüleyicisini açın.
4. SSMS'de Copilot'ı başlatmak için araç çubuğundaki Copilot düğmesini seçin.
5. Başlatıldıktan sonra, API Anahtarı kullanmadığınız sürece Azure'da kimlik doğrulaması yapmanız istenir.
6. Kimlik doğrulaması istemini görmüyorsanız tarayıcınızın Microsoft Entra kimlik doğrulaması iletişim kutusunu kontrol edin.
7. Copilot sohbetinde bir hata görürseniz çıkış görüntüleyicisindeki açılan listeden Copilot'ı seçin.
8. Çıktı görüntüleyicisindeki bilgiler daha fazla sorun giderme için kullanılabilir.

Erişimi test et

Azure OpenAI kaynaklarına erişiminiz olduğunu doğrulamak için Azure Command-Line Interfact'i (CLI) kullanın. Azure CLI, SQL Server Management Studio (SSMS) ile aynı makineye yüklenmelidir. Azure OpenAI kaynakları Microsoft Entra kimlik doğrulamasını kullanıyorsa, PowerShell betiğini çalıştırmadan önce az login komutunu kullanmanız gerekir. Betik, Azure OpenAI kaynaklarının barındırıldığı kaynak grubunun adını ve uç nokta kaynağının adını gerektirir. Komut dosyası başarıyla tamamlanırsa, kullanılabilir Azure OpenAI modelleri çıktı olarak listelenir.

# 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
}

Hata iletileri

Hata	Sonraki Adımlar
Geçersiz URI: URI'nin biçimi belirlenemedi	Uç nokta ve dağıtım değerlerinin yanlışlıkla değiştirilmediğinden emin olun.
Bilinmeyen uç nokta: 'https://value-for-endpoint.openai.azure.com/'. Lütfen uç noktayı doğrulayın.	Azure OpenAI uç noktası için doğru değere sahip olduğunuzu onaylayın.
Bu kaynak için API dağıtımı yok.	Dağıtım son beş (5) dakika içinde oluşturulduysa bekleyin ve yeniden deneyin.
	Azure OpenAI dağıtımı için doğru değere sahip olduğunuzu onaylayın.
	Dağıtım adının başında veya sonunda boş boşluk olmadığını onaylayın.
	Dağıtım değeri doğruysa ve dağıtım yakın zamanda oluşturulduysa, birkaç dakika bekleyin ve yeniden deneyin.
Geçersiz abonelik anahtarı veya yanlış API uç noktası nedeniyle erişim reddedildi. Etkin bir abonelik için geçerli bir API anahtarı sağladığınızdan ve kaynağınız için doğru bölgesel API uç noktasını kullandığınızdan emin olun.	Dağıtımınızın yapılandırmasını ve Microsoft Entra kimlik doğrulamasını mı yoksa API anahtarını mı kullandığını onaylayın. Dağıtımınız Microsoft Entra kimlik doğrulaması kullanıyorsa ve bir API anahtarı girerseniz bu hata görünebilir.
	Dağıtımınız bir API anahtarı kullanıyorsa, sahip olduğunuz API anahtarının doğru olduğunu ve yeni bir değere dönmediğini onaylayın.
HTTP 400 hatası	Dağıtım, gpt-4o modeliyle yapılandırılmamış.
HTTP 429 hatası	Uç nokta kısıtlandı.