Azure OpenAIを接続する方法

Where: 設定 → コンテンツと公開 → AIアカウント

このページを開く: admin.<your-site>/settings/ai/providers (<your-site> をサイトのアドレスに置き換えてください)

事前準備

• Azure OpenAIリソースを持つAzureアカウント。
• そのリソース内にデプロイ済みのモデルが1つ以上あること。Azureではデプロイした後にモデルが実行可能になります。
• Azureでリソースのキーを表示する権限があること。
• AIの管理権限を持つメンバーのみが接続できます。また、最近サインインしている必要があります。

手順

1. Azure portal を開き、Azure OpenAIリソースを開きます。
2. リソース管理からキーとエンドポイントに移動します。
3. エンドポイントをコピーします。https://my-resource.openai.azure.com のような形式で、末尾は .openai.azure.com または .cognitiveservices.azure.com である必要があります。
4. KEY 1 をコピーします。KEY 2は予備として保管してください。管理画面では32文字（半角英数字a〜f）または84文字のキーを受け付けます。
5. デプロイ名を確認します。Azure AI Foundryポータルで、リソースのデプロイを開きます。デプロイ名とは、モデルをデプロイした際に付けた名前です。gpt-4o-mini のように、モデル自体の名前とは異なる場合があります。
6. サイトの管理画面で Settings → Content & publishing → Your AI accounts を開き、Azure OpenAI カードを見つけます。
7. Azure endpoint を貼り付けます。Deployment names の下に各デプロイを追加し、1つ入力するごとに Add をタップします。最低1つは追加してください。
8. キーを貼り付けて Test & connect をタップします。「キーを確認しています…」と表示された後、接続済み ✓ に変わります。

補足情報

• 最大2つまでのAzureリソースを接続できます。
• Azureではキーからモデル一覧を取得できないため、入力したデプロイのみが管理画面に表示されます。後からモデルを追加した場合は、いつでもデプロイを追加できます。
• 料金の設定は任意です。料金を入力すると、管理画面にコストが表示されます。入力しない場合、別のアカウントでエラーが起きてもこのアカウントへ自動で切り替わりません。
• 料金はAzureから請求されます。利用コストや予算の上限はAzure portalで確認できます。AIの予算と利用制限
• APIキーはお客様専用のサーバーに安全に保管されます。Keynateがキーを見ることはありません。

トラブルシューティング

Azure OpenAIのエンドポイントを使用してください

エンドポイントの末尾は .openai.azure.com または .cognitiveservices.azure.com である必要があります。キーとエンドポイントからコピーしてください。カスタムドメインやIPアドレスは使用できません。

このモデルまたはデプロイは、お使いのAzure OpenAIアカウントでは利用できません

デプロイ名が一致していません。大文字・小文字を含め、完全に一致している必要があります。Foundryのデプロイを確認し、カード内の名前を修正して再度テストしてください。

Azure OpenAIがこのキーを拒否しました

キー全体をもう一度コピーしてください。キーはリソースごとに異なるため、エンドポイントと同じリソースのキーを使用してください。

このアドレスにアクセスできませんでした

エンドポイントに入力ミスがないか確認してください。リソースのネットワーク接続が特定のネットワークに制限されている場合、テストに失敗することがあります。リソースへのパブリックアクセスを許可するか、サーバーのアドレスを追加して再度テストしてください。

Azureのクォータまたはレート制限に達したというメッセージが表示されます

1分ほど待つか、Azureでそのデプロイのクォータ上限を引き上げてください。

よくある質問

関連記事

• 自前のAPIキーでAIを利用する
• AIの利用上限と予算
• AIが動かない場合