本指南介绍如何配置 Amazon Bedrock 的 API 密钥，以启用 Discourse AI 所需的第三方 LLM 密钥功能。
所需用户级别：管理员
在本示例中，我们使用 Amazon Bedrock 来生成密钥。
注意：您需要拥有付费计划并配置好 API 密钥。
平台会不断变化，因此本指南可能无法完全反映 100% 的操作流程。
获取 API 密钥
在 Amazon Bedrock 上配置密钥比其他大多数提供商稍显复杂。您可能需要熟悉 IAM 角色等概念。有关如何获取密钥的说明，请参阅：
Discourse AI 支持哪些 Bedrock 模型？
Discourse AI 支持所有 Anthropic Claude 模型以及所有 Nova 语言模型（Micro / Lite 和 Pro）。
这些模型支持图像、视频以及工具调用（XML 和原生）。
以下是一些关键模型 ID：
Nova：
- amazon.nova-pro-v1:0
- amazon.nova-lite-v1:0
- amazon.nova-micro-v1:0
Claude：
- anthropic.claude-sonnet-4-6
- anthropic.claude-opus-4-6-v1
- anthropic.claude-haiku-4-5-20251001-v1:0
- 以及更多
有关支持的 Claude 模型 ID 的完整最新列表，请参阅源代码中的 bedrock_model_id 方法。此外，任何未明确映射的模型名称将原样传递，允许您直接使用更新的模型 ID。
请注意，并非所有模型在所有区域都可用，请检查您的 Bedrock 配置页面。
在 Discourse AI 中使用 API 密钥
- 进入
Admin→Plugins→AI→LLMs标签页 - 点击“手动配置”下的
<kbd>设置</kbd>按钮 - 输入所有模型设置：
Discourse AI 支持两种 Bedrock 身份验证方法：
- 静态访问密钥：提供 API 密钥（秘密访问密钥）、访问密钥 ID 和区域。
- 基于 IAM 角色的身份验证：提供角色 ARN 和区域。此方法使用 AWS STS AssumeRole 实现凭据自动轮换。
您必须配置访问密钥 ID 或角色 ARN（连同区域）以进行身份验证。
作为分词器，对于 Nova 模型可使用 OpenAiTokenizer，对于基于 Claude 的模型可使用 AnthropicTokenizer。
我是否应该禁用原生工具支持？
Discourse 自带基于原生工具和 XML 工具的配置文件。在某些情况下，XML 工具的表现优于原生工具实现。您应进行实验，以确定哪种配置最适合您。