Azure OpenAI
Azure OpenAI 通过 Microsoft Azure 提供企业级的 OpenAI 模型访问。
设置
- 在 Azure 门户 中设置 Azure OpenAI
- 在 Azure OpenAI Studio 中部署模型
- 获取你的端点和 API 密钥
- 在 Alma 中，前往 设置 → 服务商 → 添加服务商
- 选择 Azure 作为服务商类型
- 配置你的设置（见下文）
- 点击 保存
配置
必需设置
| 设置 | 描述 | 示例 |
|---|---|---|
| Base URL | 你的 Azure 端点 | https://your-resource.openai.azure.com |
| API Key | Azure OpenAI 密钥 | abc123... |
| API Version | Azure API 版本 | 2024-08-01-preview |
API 版本
使用较新的 API 版本以获得最佳兼容性。常用版本：
2024-08-01-preview- 推荐2024-02-15-preview- 稳定版2023-12-01-preview- 旧版
Responses API
Azure 现在支持 Responses API（类似于 OpenAI 的）。如果你的部署使用它，请启用此选项。
模型名称
在 Azure 中，模型名称是你的 部署名称，而不是基础模型名称。例如：
- 如果你将 GPT-4 部署为 "gpt4-deployment"，则使用 "gpt4-deployment"
功能
企业安全
- VNet 集成
- 私有端点
- Azure AD 认证
- 合规认证
区域可用性
在离用户更近的 Azure 区域部署模型，以降低延迟。
内容过滤
Azure 提供可配置的内容过滤器，以满足企业合规要求。
故障排除
"Resource Not Found"（找不到资源）
- 检查端点 URL 是否包含资源名称
- 在 Azure OpenAI Studio 中验证部署是否存在
"Authentication Failed"（认证失败）
- 确保使用正确的 API 密钥
- 在 Azure 门户中检查密钥是否过期
"Model Not Available"（模型不可用）
- 验证模型是否已部署在你的 Azure 资源中
- 检查部署名称是否完全匹配