对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

管理自动嵌入

您可以从Atlas用户界面管理自动嵌入。

要启用自动嵌入,您必须创建 autoEmbed 类型的MongoDB 向量搜索索引。要学习;了解更多信息,请参阅创建自动嵌入索引。

To disable Automated Embedding at the organization level, use an Atlas Resource Policy. You can disable Automated Embedding entirely or disable it with project-level exceptions.

要完全禁用自动嵌入,请在 Atlas 资源策略中使用以下语法:

forbid (
principal,
action == ResourcePolicy::Action::"search.index.modify",
resource
)
when {
context.search.index.isAutoEmbed
};

To disable Automated Embedding with exceptions for specific projects, use the following syntax in your Atlas Resource Policy. Replace each <project-id> with the ID of the project to exempt. To find your project ID, see: Manage Project Settings.

forbid (
principal,
action == ResourcePolicy::Action::"search.index.modify",
resource
)
when {
context.search.index.isAutoEmbed
}
unless {
resource in ResourcePolicy::Project::"<project-id-1>" ||
resource in ResourcePolicy::Project::"<project-id-2>"
};

当激活时,这些策略可防止创建新的 autoEmbed 类型索引。在资源策略激活之前创建的索引不受影响,必须手动删除才能保持合规。

要将此策略应用于您的组织,请应用以下操作:

1
  1. 如果尚未显示,组织从导航栏中的Organizations菜单。

  2. 在侧边栏中,单击 Organization Settings

2

在侧边栏中,单击 Configurations 标题下的 Resource Policies

3
4
  1. 为策略指定唯一名称。

  2. (可选)添加说明。

  3. Cedar Policy字段中,粘贴 Cedar 策略。将 <project-id> 替换为您的项目ID。

5

要启用自动嵌入,您必须执行以下操作:

1

To learn more, see Manage Voyage AI Model API Keys.

2

To learn more, see Manage Voyage AI Model API Keys.

3

To learn more, see Voyage AI API Keys.

4

要学习;了解更多信息,请参阅创建自动嵌入索引。

要查看自动嵌入服务的聚合令牌使用情况和嵌入模型请求,可以使用 MongoDB 向量搜索仪表盘或 Atlas 指标。

1
2

您可以从 Search & Vector Search 选项或 Data Explorer go 到 MongoDB搜索页面。

  1. 如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含项目的组织。

  2. 如果尚未显示,请从导航栏的 Projects 菜单中选择您的项目。

  3. 在侧边栏中,单击 Database 标题下的 Search & Vector Search

  4. 如果您的项目有多个集群,请从 Select cluster 下拉列表中选择要使用的集群,然后单击 Go to Atlas Search

    The Search & Vector Search page displays.

  1. 如果尚未显示,请从导航栏上的 Organizations 菜单中选择包含项目的组织。

  2. 如果尚未显示,请从导航栏的 Projects 菜单中选择您的项目。

  3. 在侧边栏中,单击 Database 标题下的 Data Explorer

  4. 展开数据库并选择集合。

  5. 单击该集合的 Indexes 标签页。

  6. 单击横幅中的 Search and Vector Search 链接。

    The Search & Vector Search page displays.

3
4

The Automated Embedding Usage page displays. The Automated Embedding Usage page displays the following information:

部分
说明

使用情况摘要

自动嵌入使用情况概述,包括已使用的令牌总数和剩余的免费令牌。

按模型或索引使用

在选定的时间段内,按嵌入模型或选定索引分解总令牌使用情况。

按操作划分的使用量

按操作类型(索引和查询)分析令牌请求。

5

The following procedure only applies to API keys created from the Atlas UI. For API keys created directly from Voyage AI, see Rate Limits.

1
2
  1. 如果尚未显示,组织从导航栏中的Organizations菜单。

  2. 在组织级别,单击导航栏 AI Model APIs 标题下的 Usage

3
4

Usage 页面显示组织中所有模型API密钥的使用指标。该页面提供以下标签页:

  • Usage Activity:显示组织的详细使用指标和图表。

  • Free Usage:按模型显示免费配额消耗情况。

  • Paid Usage: 显示按模型和 API 密钥付费的使用情况。

要学习;了解更多信息,请参阅“使用情况”页面功能。

使用指标监控自动嵌入使用情况:

1
2
  1. 如果尚未显示,组织从导航栏中的Organizations菜单。

  2. 如果尚未显示,请从导航栏的Projects菜单中选择所需的项目。

  3. 单击集群名称以打开 Cluster 侧边栏。

  4. 在侧边栏中,单击 Metrics

3

您可以通过 Auto Embedding Metrics 部分中的以下指标监控自动嵌入使用情况:

衡量标准
说明
Auto Embedding Index Embedding Request

“自动嵌入索引嵌入请求”图表显示用于索引操作生成嵌入的请求数。显示每个使用中的嵌入模型的速率。

Auto Embedding Index Tokens

自动嵌入索引令牌图表显示用于索引操作的令牌数量。

Auto Embedding Query Embedding Request

自动嵌入查询嵌入请求图表显示了为查询操作生成嵌入的请求数。

Auto Embedding Query Tokens

自动嵌入查询令牌图表显示用于查询操作的令牌数。

Auto Embedding Replication Lag

自动嵌入复制延迟图表以毫秒为单位显示自动嵌入索引操作的复制延迟。

对于每个集群,Atlas 会显示一个图表,该图表会汇总集群上所有自动嵌入索引的令牌使用情况。该图表包括初始同步和稳定状态更新的令牌使用情况,并为索引使用的每个嵌入模型显示一条独立的线,以便您按模型比较令牌使用情况。

如果为工作负载隔离部署了搜索节点,Atlas 将在每个搜索节点的 Search Nodes 指标视图中显示此图表,而不是集群指标视图。

自动嵌入指标不适用于自管理部署。

可以从 Atlas 用户界面管理自动嵌入的速率限制。

要查看自动嵌入的速率限制:

1
2
  1. 如果尚未显示,组织从导航栏中的Organizations菜单。

  2. 如果尚未显示,请从导航栏的Projects菜单中选择所需的项目。

  3. 在侧边栏中,单击 Database 标题下的 Search & Vector Search

    The Search & Vector Search page displays.

3
4

页面显示以下信息:

名称
说明
Model

Voyage AI嵌入模型列表。

Tokens Per Minute (TPM)

每分钟可以进程的令牌数量。

Requests Per Min (RPM)

每分钟可以发送的API请求数。

The following procedure only applies to API keys created from the Atlas UI. For API keys created directly from Voyage AI, see Rate Limits.

1
2
  1. 如果尚未显示,组织从导航栏中的Organizations菜单。

  2. 在组织级别,单击导航栏 AI Model APIs 标题下的 Rate Limits

3

页面显示以下信息:

名称
说明
Model

Voyage AI嵌入模型列表。

Tokens Per Minute (TPM)

每分钟可以进程的令牌数量。

Requests Per Min (RPM)

每分钟可以发送的API请求数。

If you are on the Free Tier and need to increase rate limits for Automated Embedding, add a payment method to upgrade to a paid tier. To learn more, see Set Payment Method.

If you are on a Paid Tier, MongoDB automatically increases rate limits as your usage increases. If you still need a higher rate limit, contact MongoDB Support.