配置 Azure OpenAI 的 API 密钥

[Discourse]

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

所需用户级别：管理员

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

注意：您很可能需要付费计划，并且需要按使用量付费。请点击此处查看最新的详细信息和定价。

平台总是在变化，因此本指南可能无法 100% 反映当前流程。

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

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

获取 API 密钥

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

添加凭据

API 密钥通过 凭据 (Credentials) 页面集中管理。在配置 LLM 之前，您必须创建一个凭据。

1. 前往 管理 (Admin) → 插件 (Plugins) → AI → 凭据 (Credentials)
2. 点击 新建凭据 (New credential)
3. 为其提供一个描述性名称（例如：“Azure OpenAI API 密钥”）
4. 将您的 Azure API 密钥粘贴到 值 (Value) 字段中
5. 保存凭据

将 API 密钥用于 Discourse AI

1. 前往 管理 (Admin) → 插件 (Plugins) → AI → LLMs
2. 点击 + 新模型 (+ New Model) 按钮。
3. 从列表中选择适当的模型。
   
   
4. 从 提供商 (Provider) 列表中选择 Azure
5. 输入 托管模型的 URL (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 是您的 Azure OpenAI 模型部署的名称

6. 从凭据下拉列表中选择您之前创建的凭据

7. 保存 LLM
   
   

[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 实例？

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

此致，