SQL Server Management Studio での Copilot に関する問題のトラブルシューティング

一般的なログ記録

問題を調査するために詳細が必要なシナリオでは、View> を使用して出力ウィンドウで Copilot コマンドを表示し、ドロップダウン リストから Copilot を選択できます。 または、プロンプト ボックスの /log コマンドを使用して情報を保存することもできます。

コンフィギュレーション

初回実行時エクスペリエンスでエンドポイントとデプロイの値を入力し (Copilot を初めて起動したときの初期ダイアログ)、進行状況バーが繰り返し表示される場合は、ブラウザーで Microsoft Entra 認証ダイアログを確認します。

ログ キャプチャ

初回実行時エクスペリエンスでエンドポイントとデプロイの値を入力した後にエラーが発生する場合 (Copilot を初めて起動したときの初期ダイアログ)、エラー メッセージの一覧を使用してトラブルシューティングを行うか、出力ウィンドウでログをキャプチャします。

1. [ツール>オプション>Copilot に移動してエンドポイントとデプロイの値を入力し、[OK] を選択します。
2. このダイアログでは検証は行われません。
3. Copilot を開く前に、[ 表示>出力] に移動して出力ビューアーを開きます。
4. ツール バーの [Copilot ] ボタンを選択して、SSMS で Copilot を起動します。
5. 起動時に、API キーを使用していない限り、Azure に対する認証を求められます。
6. 認証のプロンプトが表示されない場合は、ブラウザーで Microsoft Entra 認証ダイアログを確認します。
7. Copilot チャットにエラーが表示された場合は、出力ビューアーのドロップダウン リストから Copilot を選択します。
8. 出力ビューアーの情報は、さらにトラブルシューティングを行う際に使用できます。

アクセスをテストする

Azure Command-Line インターフェイス (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
}

エラー メッセージ