排查 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 身份验证，则必须在 az login 运行 PowerShell 脚本之前 登录到 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
}

错误消息