Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Rede baseada em intenção: automação de rede Agent

O MongoDB Atlas serve como a camada de dados operacional unificada para a rede baseada em intenção do agente, permitindo que os agentes de IA configurem, monitorem e reparem de forma autônoma redes complexas em tempo real.

Casos de uso: Gen AI

Setores: Telecomunicações

Produtos: MongoDB Atlas, MongoDB Search, MongoDB Atlas Vector Search, Voyage AI

Telecomunicações e mídia estão entre os setores que Lideram a adesão à IA, ao lado de software e tecnologia. No entanto, a lacuna entre os principais e todas as outras continua aumentando: as empresas na linha de frente da capacidade de IA geram aproximadamente o dobro do crescimento da receita de suas pares, enquanto quase três quartos de todas as empresas ainda precisam mostrar qualquer valor tangível de seus projetos de IA. A Telecom está à frente em uma frente em particular – ela tem a maior taxa de aprovação de IA por agentes de qualquer setor. A lacuna não é o modelo. É tudo por baixo que os agentes precisam para agir com base nos dados da rede ao vivo:

  • Pipelines de dados

  • Pesquisa vetorial

  • Embeddings

  • Memória de curto e longo prazo

  • Processamento em tempo real

A automação de rede agente preenche essa lacuna. Em vez de engenheiros traduzindo solicitações em configurações de dispositivos manualmente, agentes autônomos interpretam metas, planejam alterações, agem na rede e verificam o resultado. IBN é a expressão mais clara desse padrão. Você declara um resultado de rede em termos comerciais simples e o sistema o entrega e o protege sem intervenção adicional.

Com o IBN, o cliente de uma operadora descreve o que precisa, não como construí-lo. Por exemplo: Abra uma nova loja principal. Dê prioridade ao tráfego do PDV, mantenha o Wi-Fi dos convidados estritamente separado, adicione um uplink para a gravação e mantenha a latência do PDV abaixo de 40 ms.

Um agente central traduz essa intenção em políticas de rede, provisiona os serviços e os monitora continuamente. Quando a rede se desvio da promessa, o agente diagnostica a causa e aplica uma correção por conta própria.

O MongoDB Atlas serve como a camada de dados operacional que impulsiona esse fluxo de trabalho. Ele consolida todos os recursos que o agente precisa em um banco de dados, fornecendo queries em tempo real no estado atual da rede, acordos com cliente , histórico de evento e insights de operadores. A camada de IA se conecta diretamente aos dados, eliminando pipelines de barramento de mensagens, cache ou ETL. A seção Arquiteturas de referência mostra como essa estrutura funciona em detalhes.

A solução é executada em um único agente apoiado pelo MongoDB Atlas. A figura 1 mostra os principais componentes:

  • Um orquestrador baseado no ReAct

  • Um roteador semântica de dois estágios

  • Um conjunto de microsserviços MCP especializados

  • Collections do Atlas armazenando os dados da rede e a memória do agente

Cada serviço lê e grava no Atlas, eliminando a necessidade de manter pipelines de barramento de mensagens, cache ou ETL. Essa base é extensível: o mesmo orquestrador, roteador e camada de memória assume novos domínios adicionando serviços e coleções de MCP. Essa estrutura define o estágio para futuros casos de uso, como um Digital Network Gêmeo, para o planejamento de capacidade hipotética.

Arquitetura de alto nível da rede de agentes

figura 1. O orquestrador roteia cada query por meio do MongoDB Atlas, que armazena o catálogo de serviços, as collections de IBN e a memória do agente.

À medida que o número de serviços cresce, o agente precisa de uma maneira confiável de escolher o caminho certo. O roteamento é executado em duas etapas, ambas apoiadas pelo MongoDB.

Primeiro, um pequeno LLM classifica a query em relação a uma curta classificação de domínios, usando algumas linhas por domínio em vez de por serviço. Essa estrutura mantém o roteamento preciso à medida que os serviços se multiplicam. Em segundo lugar, um Atlas $vectorSearch, filtrado para o domínio selecionado, recupera o serviço de melhor correspondência. O catálogo de serviços reside no Atlas e as queries são roteadas por ele.

Uma intenção de resultado de rede passa pelos seguintes serviços de uma solicitação inicial até uma resolução final:

  • Serviço de intenção: analisa a solicitação de linguagem natural em campos estruturados com um LLM. Ele rastreia o estado da intenção à medida que ela passa pelos estágios enviado, executável, planejado, ativo, violado e fechado.

  • Serviço de inventário: Contém a rede física, mapeando locais com coordenadas geoespaciais e os recursos disponíveis em cada local. Quando um site precisa de um dispositivo sobressalente, ele encontra o mais próximo disponível com uma query geoespacial.

  • Serviço de viabilidade: compara a intenção com o inventário atual, cria um plano de serviço concreto e escreve um snapshot imutável desse plano. Cada alteração cria um novo snapshot, para que todo o histórico de planejamento permaneça auditável.

  • Serviço de garantia: monitora a telemetria ao vivo em relação às metas acordadas. Quando uma métrica ultrapassa seu limite, ela registra um evento de compliance e o envia para o dashboard em tempo real.

  • Simulador de telemetria: injeta eventos sob demanda, para que você possa testar o ciclo completo de violação, diagnóstico e correção em um ambiente controlado.

Violações ao vivo criam o momento mais exigente. Suponha que a latência do PDV na nova loja ultrapasse seu alvo de 40 ms. Em vez de abrir um ticket, o agente de garantia executa um único pipeline de agregação do Atlas que aplica filtros específicos na base de conhecimento, criando uma única query de diagnóstico em quatro dimensões:

  • Semântica semântica: $vectorSearch encontra instâncias anteriores cuja descrição é mais próxima da violação atual, como colisão de agendamento de fila, segmentação rigorosa de convidados ativa, baixa utilização de link.

  • Filtro estruturado: limita os resultados a instâncias anteriores, de modo que os runbooks e os modelos de políticas não reduzam a correspondência.

  • Janela de tempo: exclui incidentes com mais de 180 dias, portanto, as Conclusões de estados de rede anteriores não manipulam os resultados.

  • Limites geoespaciais: mantenha a pesquisa local, para que um incidente em uma cidade não envie um diagnóstico em outra.

Essas operações são executadas como pré-filtros dentro do índice do Atlas Vector Search , restringindo o conjunto de candidatos antes da execução do cálculo de similaridade. As respostas retornam o incidente passado mais próximo, sua causa raiz e seu runbook testado juntos. O agente aplica o runbook, registra um evento de recuperação e o dashboard fica verde. Um pipeline no Atlas substitui várias passagens de query coordenadas em sistemas separados.

O IBN trabalha com diferentes formas de dados, e o MongoDB Atlas mantém todos em um só lugar. Cada uma das seguintes coleções mapeia para uma parte do fluxo de trabalho:

  • ibn_intents: Armazena a intenção analisada e seu estado de ciclo de vida. Ele contém todos os campo especificados na solicitação, como o teto de latência ou a política de segmentação.

  • ibn_sites: contém os sites da rede comcoordenadas indexadas pelo 2dsphere para pesquisas geoespaciais.

  • ibn_resources: contém os recursos de rede disponíveis em cada site.

  • ibn_policy_snapshots: Armazena snapshots de planos imutáveis que preservam todo o histórico de planejamento.

  • ibn_telemetry. Armazena amostras de métricas em uma coleção de séries temporais.

  • ibn_compliance_events: armazena o registro de cada violação e recuperação.

  • ibn_knowledge_chunks: Armazena instâncias anteriores, runbooks e modelos, auto-incorporados com Voyage AI para pesquisa vetorial.

A memória do agente também reside no MongoDB, armazenado em coleções dedicadas ao lado dos dados de rede:

  • agent_workstreams: Armazena o contexto de curto prazo para o thread de trabalho atual.

  • agent_memories: extrai fato de longo prazo quando um fluxo de trabalho é fechado, indexado por vetor para recuperação entre sessões.

  • user_preferences: Armazena instruções que o engenheiro ensina ao agente.

Um único índice do Atlas Vector Search torna possível a query de diagnóstico quadridimensional. Com a incorporação automática do Atlas , você ponto o índice em um campo de texto e o Atlas gera e armazena as incorporações para você. Você não precisa de um pipeline ou serviço de incorporação separado para ser executado. Esse mesmo índice emparelha o campo de texto incorporado automaticamente com filtros estruturados, de tempo e geoespaciais. Como resultado, um estágio $vectorSearch realiza o trabalho de vários mecanismos de query:

{
"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"
}
]
}

A demonstração completa está disponível neste repositório do GitHub. Clone o repositório e siga estas etapas.

1

Defina as variáveis de ambiente para os serviços externos que a demonstração chama:

  • OpenAI para o modelo de idioma

  • MongoDB Atlas para a camada de dados

  • Voyage AI para incorporações

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

Instale o Python 3.13 e adicione-o ao seu caminho. Em seguida, crie e ative um ambiente virtual. Por fim, instale as dependências.

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

Inicie os servidores da web e ponto seu navegador para http://localhost:8070/ para o shell interativo.

./bin/start.sh

Os botões na navegação superior permitem:

  • Alimente os dados iniciais nas coleções MongoDB .

  • Redefinir os dados para refazer a demonstração.

  • Abra outra janela do navegador para exibir o dashboard do IBN.

  • Veja o estado ao vivo dos sites monitorados em tempo real.

4

No chat do navegador, acompanhe o agente por uma intenção completa, da solicitação à recuperação. O prompt de violação de diagnóstico aciona a query de diagnóstico quadridimensional.

-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
  • Unifique seus dados em um armazenamento: mantenha registros de intenção, locais geoespaciais, telemetria de séries temporais e conhecimento indexado por vetores em um único banco de dados MongoDB Atlas , consultável com um driver e um pipeline.

  • Recuperar entre dimensões em uma query: Combine similaridade vetorial, filtros estruturados, uma janela de tempo e limites geoespaciais em um único estágio do Atlas Vector Search , sem orquestração do lado do aplicativo.

  • Transmitir alterações em tempo real: use o MongoDB Change Streams para enviar ativações de intenção, violações e recuperações para painéis sem pesquisa.

  • Dê ao seu agente uma memória: armazene o contexto de curto prazo, dados de longo prazo e as preferências do usuário como coleções, para que o agente melhore com o uso, em vez de com o retreinamento.

  • Automatize o ciclo de vida completo da intenção: deixe um agente analisar, planejar, ativar, garantir e corrigir as intenções de rede de ponta a ponta, com base em dados em tempo real.

  • Benjamin Lorenz, MongoDB

  • Aditya Vikram Roy, MongoDB

  • Diego Canales, MongoDB