> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/pre-basic/providers/azure-openai.md).

# Azure OpenAI

Azure OpenAI は Microsoft が Azure 上でホストする OpenAI モデルサービスで、企業コンプライアンス、データ所在地の保証、または Microsoft エコシステムを必要とするチームに適しています。

## 事前準備

* Azure サブスクリプションを開通済み
* Azure Portal で Azure OpenAI Service へのアクセス申請が承認済み
* 少なくとも1つ作成済み **リソース（Resource）** と **デプロイ（Deployment）**

## API Keyを取得

* Azure Portal → あなたの Azure OpenAI リソース → `キーとエンドポイント`
* コピー `キー 1` または `キー 2`をメモする `Endpoint`（次のような形式 `https://<your-name>.openai.azure.com/`）

## Cherry Studioで設定

* 開く `設定 → モデルサービス`、見つけて **Azure OpenAI** Providerを開いて詳細ページへ
* **API キー**：コピーした KEY を入力
* **API アドレス**：リソースの Endpoint を入力（末尾のパスは不要）
* **API バージョン**：専用フィールドにあなたのデプロイの API バージョンを入力（例： `2024-08-01-preview`）
* クリック **モデル一覧を取得**、または Azure にデプロイ済みのモデル名を手動で追加します（つまり Deployment Name であり、OpenAI の元のモデル ID ではありません）

{% hint style="warning" %}
**Deployment Name と Model ID の違い**：Azure ではデプロイに付けた名前を使います（例： `gpt-4o-prod`）、 `gpt-4o` のような元の ID ではありません。誤って入力すると 404 になります。
{% endhint %}

## 推奨の使い方

* **gpt-4o / gpt-4o-mini**：一般的な対話、Agent
* **gpt-4 turbo**：長文コンテキスト
* **text-embedding-3-**\*：埋め込みモデル。ナレッジベースに利用可能

## よくある質問

* **401 Unauthorized**：Key が正しいか、Endpoint の末尾に余分なスラッシュがないか確認
* **404 Not Found**：Deployment Name が Azure 上のものと一致しているか、API Version が入力されているか確認
* **429 Throttled**：Azure のクォータ（Quota & Limits ページ）を確認

***

### ヘルプの取得とフィードバックの送信

設定や使用中に疑問、バグ、または機能改善の提案がある場合は、 [フィードバックと提案](https://docs.cherryai.com.cn/docs/jp/question-contact/suggestions.md) に記載の公式チャネルをご参照ください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cherryai.com.cn/docs/jp/pre-basic/providers/azure-openai.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
