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

基于意图的网络:代理网络自动化

MongoDB Atlas作为基于意图的代理网络的统一操作数据层,使AI代理能够实时自主配置、监控和修复复杂的网络。

使用案例: Gen AI

行业: 电信

产品: MongoDB Atlas、 MongoDB Search、 MongoDB Atlas Vector Search、Voyage AI

电信和媒体以及软件和金融科技都是引领AI采用的行业。然而,领先者与其他公司之间的差距却在不断拉大:处于AI功能前沿的公司的收入增长大约是同行的两倍,而近四分之三的公司尚未从其AI投资中显示出任何有形价值。电信业在一个领域尤其领先——它的代理AI采用率是所有行业中最高的。差距不在于模型。这是代理处理实时网络数据所需的一切:

  • 数据管道

  • Vector Search

  • 嵌入

  • 短期和长期记忆

  • 实时处理

代理网络自动化弥补了这一差距。工程师无需手动将请求转换为设备配置,而是由自主代理解释目标、计划变更、作用于网络并验证结果。 IBN 是这种模式最清晰的表达式。您用通俗易懂的业务术语陈述网络结果,系统无需进一步干预即可交付和保护它。

通过 IBN,运营商的客户可以描述他们的需求,而不是如何构建需求。示例:新开一家旗舰存储。为 POS 流量提供优先级,将访客 WiFi 严格分开,添加摄像头上行链路,并将 POS延迟控制在 毫秒以下。40

中央代理将该意图转换为网络策略,提供服务并持续监控它们。当网络偏离承诺时,代理会诊断原因并自行修复。

MongoDB Atlas充当驱动此工作流程的操作数据层。它将代理所需的所有资源整合到一个数据库中,提供对当前网络状态、客户协议、事件历史和操作符见解的实时查询。 AI层直接连接到数据,消除了消息总线、缓存或 ETL 管道。参考架构部分详细展示了该框架的工作原理。

该解决方案在MongoDB Atlas支持的单个代理上运行。图 1 显示了主要组件:

  • 基于 ReAct 的协调器

  • 两阶段语义路由器

  • 一设立专门的 MCP 微服务

  • 存储网络数据和代理内存的Atlas集合

每个服务都会读取和写入Atlas,从而无需维护消息总线、缓存或 ETL 管道。该基础是可扩展的:通过添加 MCP 服务和集合,相同的协调器、路由器和内存层可用于新域。该框架为未来的使用案例奠定了基础,例如用于假设容量规划的数字网络双胞胎。

代理网络的高级架构

图 1。协调器通过MongoDB Atlas路由每个查询,MongoDB Atlas 存储服务目录、IBN 集合和代理的内存。

随着服务数量的增长,代理需要一种可靠的方法来选择合适的服务。路由分两个阶段运行,均由MongoDB支持。

首先,小型法学硕士根据简短的域分类法对查询进行分类,每个域而不是每个服务使用几行。随着服务的增加,该框架可保持路由的准确性。其次,筛选到所选域的Atlas $vectorSearch 会检索最匹配的服务。服务目录位于Atlas中,查询通过它进行路由。

网络结果意图从初始请求到最终解决通过以下服务:

  • 意向服务:使用 LLM 将自然语言请求解析为结构化字段。它跟踪意图在已提交、可行、已计划、活动、已违反和已关闭阶段的状态。

  • 库存服务:保存物理网络,使用地理空间坐标映射站点以及每个位置的可用资源。当站点需要备用设备时,它会通过地理空间查询找到最近的可用设备。

  • 可行性服务:将意图与当前清单进行匹配,构建具体的服务计划,并写入该计划的不可变快照。每次更改都会创建一个新快照,因此完整的计划历史记录保持可审核状态。

  • 保证服务:针对商定目标监控实时遥测。当指标超过阈值时,它会记录合规事件并将实时推送到仪表盘。

  • 遥测模拟器:按需注入事件,以便您可以在受控设置中测试完整的违规、诊断和修复周期。

实时违规创造了最苛刻的时刻。假设新存储的 POS延迟超过其 40 毫秒目标。保障代理运行单个Atlas聚合管道,而不是打开票证,该管道对知识库应用特定的筛选器,从而针对四个维度创建单个诊断查询:

  • 语义相似度: $vectorSearch 查找其描述与当前违规情况最接近的过去事件,例如队列调度冲突、严格访客分段处于活动状态、链路利用率低。

  • 结构化过滤:将结果限制为过去的事件,因此 Runbook 和策略模板不会削弱匹配。

  • 时间窗口:排除超过 180天的事件,因此早期网络状态的结论不会误导结果。

  • 地理空间边界:保持搜索本地化,这样一个城市的事件不会影响另一个城市的诊断。

这些操作作为Atlas Vector Search索引中的预过滤器运行,在相似性计算运行之前缩小候选设立的范围。响应会同时返回最近发生的事件、其根本原因以及经过验证的操作手册。代理应用 Runbook,记录恢复事件,仪表盘变为绿色。 Atlas中的一个管道取代了跨不同系统的多个协调查询传递。

IBN 可处理不同的数据结构, MongoDB Atlas将所有数据结构保存在一个位置。以下每个集合都映射到工作流程的一部分:

  • ibn_intents:存储解析的意图及其生命周期状态。它包含请求中指定的每个字段,例如延迟上限或分段策略。

  • ibn_sites:包含具有 2dsphere 索引坐标的网络站点,用于地理空间查找。

  • ibn_resources:包含每个站点可用的网络资源。

  • ibn_policy_snapshots:存储可保留完整计划历史记录的不可变计划快照。

  • ibn_telemetry。将指标样本存储在时间序列集合中。

  • ibn_compliance_events:存储每次违规和恢复的记录。

  • ibn_knowledge_chunks:存储过去的事件、操作手册和模板,自动嵌入用于向量搜索的 Voyage AI 。

助手的内存也位于MongoDB中,与网络数据一起存储在专用集合中:

  • agent_workstreams:存储当前工作线程的短期上下文。

  • agent_memories:在工作流关闭时提取长期事实,并进行向量索引以便跨会话调用。

  • user_preferences:存储工程师向代理传授的指令。

单个Atlas Vector Search索引使四维诊断查询成为可能。通过Atlas自动嵌入,您点索引文本字段, Atlas会为您生成并存储嵌入内容。您不需要单独的嵌入管道或服务来运行.该索引将自动嵌入的文本字段与结构化、时间和地理空间筛选器配对。因此,一个 $vectorSearch 阶段会承担多个查询引擎的工作:

{
"fields": [
{
"type": "autoEmbed",
"modality": "text",
"path": "text",
"quantization": "float",
"model": "voyage-4"
},
{
"type": "filter",
"path": "kind"
},
{
"type": "filter",
"path": "segment"
},
{
"type": "filter",
"path": "market"
},
{
"type": "filter",
"path": "plan_id"
},
{
"type": "filter",
"path": "ts"
},
{
"type": "filter",
"path": "lng"
},
{
"type": "filter",
"path": "lat"
}
]
}

GitHub存储库提供了完整的演示。克隆存储库,然后按照以下步骤操作。

1

为演示调用的外部服务设置环境变量:

  • OpenAI 的语言模型

  • 数据层的MongoDB Atlas

  • 用于嵌入的 Voyage AI

export OPENAI_API_KEY="<your openai api token>"
export MONGODB_URI="<your mdb connection string>"
export VOYAGE_API_KEY="<your voyage api token>"
2

安装Python 3.13 并将其添加到您的路径中。然后,创建并激活虚拟环境。最后,安装依赖项。

brew install python@3.13
export PATH="$(brew --prefix)/opt/python@3.13/libexec/bin:$PATH"
python -m venv <dir>
source <dir>/bin/activate
cd agentic-mcp-demo
pip install -r requirements.txt
3

启动 Web 服务器并在浏览器中点 http://localhost:8070 / 以获取交互式Shell。

./bin/start.sh

通过顶部导航栏中的按钮,您可以:

  • 将种子数据输入MongoDB集合。

  • 重置数据以重新进行演示。

  • 打开另一个浏览器窗口以显示 IBN仪表盘。

  • 实时查看受监控站点的活动状态。

4

从浏览器中的聊天中,引导代理完成从请求到恢复的完整意图。诊断违规提示会触发四维诊断查询。

-I'm opening a new Alpenmarkt store at Marienplatz Munich. POS priority, guest WiFi strictly separated, camera uplink, online by 18:00, max 40ms POS latency, 99.95% availability
-feasibility check
-propose and activate
-inject morning rush
-diagnose violation
-apply runbook
  • 在一个存储中统一数据:将意图记录、地理空间站点、时间序列遥测和向量索引知识保存在单个MongoDB Atlas数据库中,可使用一个驾驶员和一个管道进行查询。

  • 在一个查询中跨维度检索:在单个Atlas Vector Search阶段中组合向量相似度、结构化筛选器、时间窗口和地理空间边界,无需应用程序端编排。

  • 流式传输实时更改:使用MongoDB Change Streams将意图激活、违规和恢复推送到仪表盘,而无需轮询。

  • 为代理提供记忆:将短期上下文、长期事实和用户偏好存储为集合,以便代理通过使用而不是重新训练来改进。

  • 实现整个意图生命周期的自动化:让一个代理以实时数据为基础,端到端地解析、规划、激活、保证和修复网络意图。

  • Benjamin Lorenz, MongoDB

  • Aditya Vikram Roy, MongoDB

  • Diego Canales, MongoDB