排查 SQL Server Management Studio 中 Copilot 的问题

常规日志记录

在需要更多详细信息来调查问题的情况下，可以使用 “查看>输出 ”并从下拉列表中选择 Copilot 来查看输出窗口中的 Copilot 命令。 或者，可以使用提示框中的 /log 命令保存信息。

配置

如果在首次运行体验中输入终结点和部署值（首次启动 Copilot 时的初始对话框）和进度栏重复，请检查浏览器是否有Microsoft Entra 身份验证对话框。

日志捕获

如果在首次运行体验中输入终结点和部署值后收到错误（首次启动 Copilot 时的初始对话框），请使用错误消息列表进一步进行故障排除，或在输出窗口中捕获日志。

1. 转到 工具 > 选项 > Copilot 以输入终结点和部署值，然后选择“ 确定”。
2. 此对话框中不会发生验证。
3. 打开 Copilot 之前，请转到 “查看 > 输出 ”以打开输出查看器。
4. 选择工具栏上的 Copilot 按钮以在 SSMS 中启动 Copilot。
5. 启动时，系统会提示你向 Azure 进行身份验证，除非使用的是 API 密钥。
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 身份验证，则在运行 PowerShell 脚本之前，必须使用 az login登录到 Azure。 该脚本需要托管 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
}

错误消息