本页介绍如何解决在 将MongoDB Vector Search 与Amazon Bedrock 集成时可能遇到的常见问题。
如需排除本页未涵盖的问题，请联系 MongoDB 支持人员。
一般故障排除
有关一般故障排除指导，请参阅以下步骤。
知识库创建
如果您在创建知识库时遇到问题，请检查以下内容：
使用正确的主机名，并确保它包含集群上的
-pl后缀（如果使用 PrivateLink）。主机名是 Atlas 集群的 URL，位于其连接字符串中。该主机名使用以下格式：
<clusterName>.mongodb.net 请指定与您在 Atlas 中指定的相同的数据库、集合和向量索引名称。确保数据库用户可以访问 Atlas 中的数据库。
在 Secrets 经理中指定正确的用户名和密码密钥，并确保 ARN 正确。要学习；了解更多信息，请参阅Amazon Web Services Secrets 经理概念。
如果您使用 PrivateLink，请在 Amazon Bedrock 中配置知识库时输入正确的 PrivateLink 服务名称。
重要
PrivateLink 服务终结点必须与知识库位于同一账户中。
如果遇到权限相关问题，请参阅如何排查在Amazon Bedrock 中创建知识库时出现的权限错误？。
数据同步与检索问题
如果您在同步或检索知识库中的数据时遇到问题，请检查以下内容：
确保您要接收的数据采用基础模型支持的格式。例如，如果您使用的是基于文本的模型，请确保数据是文本格式。
确保您能够连接到您的集群，并且其凭证和网络访问权限没有发生变化。
确保在MongoDB Vector Search索引中指定与所选基础模型相对应的正确维数。
如果您尝试过滤数据，请确保已在索引定义中将元数据字段定义为预过滤，并确保它们与数据源中的实际字段相对应。
注意
每次您在数据源的 S3 存储桶中添加、修改或删除文件时，必须同步数据源，以便将其重新索引到知识库。同步是增量的，因此 Amazon Bedrock 仅处理 S3 存储桶自上次同步后添加、修改或删除的对象。要了解更多信息，请参阅 Amazon Bedrock 文档。
特定错误
错误消息 | 故障排除步骤 |
|---|---|
在设置知识库时：
| 确保您具有创建 IAM 角色和策略的 IAM 权限。要学习；了解更多信息，请参阅Amazon Bedrock 文档。 |
在尝试同步知识库的数据源时：
| 当您尝试同步仍在创建中的知识库的数据源时，就会发生这种情况。在同步数据源之前，确保知识库处于就绪状态。 要学习；了解如何查看知识库的状态，请参阅Amazon Bedrock 文档。 |
在尝试将知识库添加到代理时：
| 如果您在保存代理之前尝试将知识库添加到正在创建的新代理中，就会发生这种情况。您必须先保存代理，然后再将知识库添加到代理。 |
在测试代理时：
| 当您尝试使用您无权访问权限的基础模型时，会出现此错误。您必须先请求访问权限Amazon基岩模型，然后才能使用它们。要学习；了解如何请求或修改模型访问权限，请参阅Amazon Bedrock 文档。 |
使用 Amazon Titan 文本嵌入模型时：
| 这是在此模型中使用MongoDB Vector Search 时的一个已知问题。要解决此问题，联系MongoDB支持部门。 |
索引创建和过滤器字段时出错。 | 如果您按照教程操作，并且之前使用过滤字段 |