微软 OpenAI 接入
这篇解决什么
Azure OpenAI 平台字符串怎么填、密钥 url 当什么用。读完能对上 AiPlatformEnum.AZURE_OPENAI = "AzureOpenAI",以及选项字段是 deploymentName 不是 OpenAI 的 model。
默认端口 48080。开启见 AI 功能设计。官方 OpenAI 那条见 OpenAI 接入。
示意图:url 直接当 Azure 资源 endpoint。空地址不会回落到 api.openai.com。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 密钥 | @RequestMapping("/ai/api-key") | ruoyi-office/yudao-module-ai/.../controller/admin/model/AiApiKeyController.java |
| 对话工厂 | buildAzureOpenAiChatModel(apiKey, url) | AiModelFactoryImpl |
| 向量工厂 | buildAzureOpenAiEmbeddingModel | 同上 |
| 选项 | AzureOpenAiChatOptions.deploymentName | AiUtils.buildChatOptions |
官方菜单:密钥 2761,模型 2767。
url 填资源终结点,例如 https://{resource}.openai.azure.com。ai_model.model 填部署名,工厂把它写进 deploymentName。对话 type=1,向量 type=5。
/draw 没有 AzureOpenAI 分支。Azure 出图不要指望走通用绘制。
字段
| 名称 | 说明 | 仓库路径 |
|---|---|---|
platform | 必须是 AzureOpenAI | AiApiKeyDO / AiModelDO |
apiKey / url | 密钥;url 即 endpoint | AiApiKeyDO |
model | Azure 部署名 | AiModelDO |
type | 1 对话 / 5 向量 | 同上 |
不要填成 OpenAI
官方密钥那条平台是 OpenAI。微软这条必须是 AzureOpenAI,选项类也不是 OpenAiChatOptions。
url 空了建不出可用客户端
工厂把 url 原样交给 OpenAIClientBuilder.endpoint,没有默认主机。密钥行必须带资源地址。
按本仓库 DO 生成的 ER。
配置与操作
走 API 密钥(2761)建 platform=AzureOpenAI。url 必须填资源 endpoint(https://{resource}.openai.azure.com),空了不会回落到官方 OpenAI。ai_model.model 填部署名,工厂写入 deploymentName。
对话 type=1,向量 type=5。/draw 没有 Azure 分支。不要和 OpenAI 那条密钥混用。开启见 AI 功能设计。

本系统截图:AI 大模型 → 控制台 → API 密钥。各厂商共用这一页,用 platform 区分。

本系统截图:控制台 → 模型配置。keyId 必须指向同平台密钥。
