配置 Azure OpenAI 的 API 密钥

[Discourse]

本指南介绍如何为 Azure OpenAI 配置 API 密钥，以启用需要第三方 LLM 密钥的 Discourse AI 功能。

所需用户级别：管理员

在本示例中，我们使用 Azure OpenAI 来生成密钥。

:note: 您很可能需要付费套餐，并且需要按使用量付费。请参阅此处了解最新的详细信息和定价。

平台总会发生变化，因此本指南可能无法100%反映实际流程。

为了使用某些 AI 模块，用户必须拥有来自第三方提供商（如 OpenAI (ChatGPT)、Anthropic (Claude)、Stability AI (Stable Diffusion) 等）的 API 密钥。

请检查每个 AI 模块，了解可用于它的第三方提供商。

获取 API 密钥

1. 请参阅此处文档，根据您选择的 OpenAI 模型和使用的 Discourse AI 模块/功能获取必要的 API 密钥。
2. 获取密钥后，请将其存储在安全的地方并复制。

将 API 密钥用于 Discourse AI

1. 转到“Admin”设置 → “Plugins” → “AI” → “LLMs”选项卡。
2. 点击“+ New Model”按钮。
3. 从列表中选择合适的模型。
   
   
4. 从“Service hosting the model”列表中选择“Azure”。
5. 输入“URL of the service hosting the model”。

示例 URL：https://{RESOURCE_NAME}.openai.azure.com/openai/deployments/{DEPLOYMENT_NAME}/chat/completions?api-version=2024-02-15-preview，其中

• RESOURCE_NAME 是您的 Azure OpenAI 资源的名称。
• DEPLOYMENT_NAME 是您的 GPT-4 Turbo with Vision 模型部署的名称。

8. 将 API 密钥粘贴到“API Key of the service hosting the model”字段中。
9. 保存 LLM。
   
   

其他设置

设置将取决于您选择的 OpenAI 模型以及使用的 Discourse AI 模块/功能。以下设置可以在“Admin”设置 → “Plugins” → “AI” → “Settings”选项卡中找到：

• ai openai API key：OpenAI API 的 API 密钥。
• ai openai embeddings url：用于 OpenAI embeddings API 的自定义 URL（请使用 Azure 的特定 URL）。
• ai openai dall e 3 url：用于 DALL-E 3 图像生成的自定义 URL。

[Zak]

您好，

我在使用 OpenAI Azure 端点时遇到问题。以下 URL 似乎无法按预期工作：

https://***.openai.azure.com/openai/deployments/DEPLOYMENT_NAME/chat/completions?api-version=2023-07-01-preview

其中 DEPLOYMENT_NAME 设置为 gpt-4-32k。

您能否协助解决此问题？任何指导或建议都将不胜感激。

此外，我还有一些关于 Discourse 插件的疑问：

1. 如何 Fork Discourse 插件：您能否提供有关如何 Fork 现有 Discourse 插件的详细说明或指南？
2. 测试 Forked 插件：一旦我 Fork 了插件，在我的 Discourse 实例上测试这个 Forked 版本有哪些步骤？
3. 上传和激活插件：测试后，如何将这个 Forked 插件上传并激活到我的 Discourse 实例？

您对这些问题的协助将非常有帮助。感谢您的时间和支持。

此致，