針對 SQL Server Management Studio 中的 Copilot 問題進行疑難解答

一般記錄

在需要更多詳細數據調查問題的案例中，您可以使用 [ 檢視>輸出 ]，並從下拉式清單中選取 [Copilot ] 來檢視輸出視窗中的 Copilot 命令。 或者，您可以使用 /log 命令在提示方塊中儲存資訊。

設定

如果您在初次執行體驗中輸入端點和部署值（第一次啟動 Copilot 時的初始對話框）和進度列重複，請檢查瀏覽器是否有Microsoft Entra 驗證對話框。

日誌擷取

如果您在第一次執行體驗中輸入端點和部署值之後收到錯誤（第一次啟動 Copilot 時的初始對話方塊），請使用錯誤訊息清單進一步進行疑難解答，或擷取輸出視窗中的記錄。

1. 移至 工具>選項>Copilot 以輸入端點和部署值，然後選取 確定。
2. 此對話框中不會發生任何驗證。
3. 開啟 Copilot 之前，請移至 [檢視>輸出] 以開啟輸出檢視器。
4. 選取工具列上的 [Copilot ] 按鈕，以在 SSMS 中啟動 Copilot。
5. 啟動時，除非您使用 API 金鑰，否則系統會提示您向 Azure 進行驗證。
6. 如果您沒有看到驗證提示，請檢查瀏覽器是否有Microsoft Entra 驗證對話方塊。
7. 如果您在 Copilot 聊天中看到錯誤，請從輸出查看器中的下拉式清單中選取 Copilot 。
8. 輸出查看器中的資訊可用於進一步的疑難解答。

測試存取

使用 Azure Command-Line Interfact （CLI） 來確認您可以存取 Azure OpenAI 資源。 Azure CLI 必須安裝在與 SQL Server Management Studio （SSMS） 相同的電腦上。 如果 Azure OpenAI 資源使用 Microsoft Entra 驗證，您必須先使用登入 Azure，然後才能執行 PowerShell 腳本。 腳本需要裝載 Azure OpenAI 資源的資源群組名稱，以及端點資源的名稱。 如果腳本順利完成，可用的 Azure OpenAI 模型會列為輸出。

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

錯誤訊息