As habilidades do MongoDB Agent são instruções pré-criadas e reutilizáveis que ajudam os agentes de codificação de IA a executar tarefas comuns do MongoDB de forma eficiente. Essas habilidades fornecem aos agentes conhecimento especializado sobre as melhores práticas do MongoDB , permitindo que eles o ajudem a criar aplicativos com mais rapidez e menos erros.
Quais são as habilidades do agente?
As habilidades do agente são instruções especializadas que ensinam os agentes de codificação de IA como:
Instalar e configurar conexões MongoDB
Projetar e implementar esquemas de banco de dados
Gravar queries e agregações eficientes
Quando você instala as habilidades do agente MongoDB , seu agente de codificação de IA obtém acesso ao conhecimento específico do MongoDB e pode fornecer assistência mais precisa e sensível ao contexto para suas tarefas de desenvolvimento do MongoDB .
Habilidades disponíveis
A coleção de habilidades do agente MongoDB inclui as seguintes habilidades.
Infraestrutura
Configuração do MongoDB MCP
Orienta o agente na configuração do servidor MongoDB MCP (Model Context Protocol), que permite a interação direta com seus bancos de dados MongoDB . Essa habilidade ajuda a definir as credenciais de autenticação e as configurações de conexão.
Conexão do MongoDB
Otimize a configuração de conexão do cliente MongoDB (pools, tempos limite, padrões) para configurar pools de conexão, depurar ou solucionar erros de conexão e otimizar problemas de desempenho relacionados às conexões. Includes a criação de funções sem servidor com o MongoDB, a criação de pontos de extremidade de API que usam o MongoDB, a otimização de aplicativos MongoDB de alto tráfego, a criação de tarefas e simultaneidade de longa execução ou a depuração de falhas relacionadas à conexão.
Modelagem de dados
Design de esquema
Guia os desenvolvedores pelas melhores práticas de projeto de esquema do MongoDB. Essa habilidade ajuda a criar estruturas de documento eficientes, implementar regras de validação e otimizar esquemas para casos de uso específicos.
Recursos avançados
Atlas Stream Processing
Habilidade abrangente para criar, operar e depurar pipelines do MongoDB Atlas Stream Processing. Lida com o provisionamento de espaço de trabalho, conexões de fonte de dados/coleção, operações de ciclo de vida do processador, diagnóstico de depuração e dimensionamento de nível. Suporta Kafka, clusters Atlas , S3, HTTPS e integrações Lambda para streaming de cargas de trabalho de dados e processamento de evento .
Query de linguagem natural
Traduz descrições de linguagem natural em queries MongoDB e pipelines de agregação. Essa habilidade usa esquemas de coleção, documentos de exemplo e informações de índice para gerar queries precisas e otimizadas. Suporta operações complexas como queries geoespaciais, pesquisa de texto e junções de múltiplas coleções. Diferente do MongoDB Atlas Search e pesquisa vetorial (consulte a habilidade Recomendações de Pesquisa e IA abaixo).
otimizador de query
Analisa e otimiza o desempenho da query do MongoDB . Essa habilidade garante que as queries sejam indexadas corretamente, depura queries lentas usando o Atlas Performance Advisor e fornece recomendações de melhores práticas para pipeline de agregação.
Recomendações de pesquisa e IA
Fornece orientação para implementar recomendações do Atlas Search e IA. Essa habilidade ajuda a configurar índices de pesquisa, criar queries de pesquisa e integrar funcionalidades de IA a aplicativos.
Instalação
As habilidades do agente MongoDB estão disponíveis para várias plataformas de codificação de IA. Você pode instalar habilidades de agente MongoDB a partir de plug-ins oficiais, do Vercel Habilidades Marketplace ou manualmente a partir do repositório de habilidades de agente MongoDB.
Instalar a partir de plugins oficiais
Instale as habilidades de agente MongoDB de plug-ins oficiais para sua plataforma de codificação de IA:
Claude Code: Instalar a partir do plugin oficial MongoDB. Consulte a página Instalar o plugin MongoDB Claude para obter mais informações.
Codex: Instale a partir do plugin oficial do Codex do MongoDB. Consulte a página Instalar o plugin do MongoDB Codex para obter mais informações.
Cursor: instale a partir do mercado Cursor. Consulte a página Instalar o plugin do cursor do MongoDB para obter mais informações.
Gemini CLI: Instale como uma extensão Gemini CLI. Consulte a página Instalar a extensão MongoDB Gemini a partir da Gêmeos para obter mais informações.
VS Code Extension: Instale a partir da VS Code Extension oficial do MongoDB. Consulte a página Instalar MongoDB for VS Code Extension para obter mais informações.
Observação
Os plug-ins do MongoDB incluem o servidor MCP
Os plug-ins oficiais do MongoDB para plataformas de codificação de IA agrupam o servidor MongoDB MCP e as habilidades de agente pré-criadas. Para configurar o servidor MCP, consulte Introdução ao servidor MCP MongoDB.
Instalar a partir do diretório de habilidades do agente da Vercel
Instale as habilidades do MongoDB Agent a partir do Diretório de habilidades de agentes do Vercel usando a CLI do Vercel.
Execute o seguinte comando (requer Node.js):
npx skills add mongodb/agent-skills Siga as instruções para concluir a instalação.
Se você estiver usando o servidor MCP, configure o servidor MCP com seus detalhes de conexão MongoDB :
`npx mongodb-mcp-server@1 setup` Siga as instruções para concluir a configuração.
Instalar a partir do repositório do GitHub
Manualmente instale as habilidades do agente MongoDB a partir do repositório de habilidades do agente MongoDB.
Clone o repositório:
git clone https://github.com/mongodb/agent-skills.git Instale as habilidades na sua plataforma:
Plataformas suportadas (Claude Code, Codex, Cursor, Gemini CLI)
Copie o diretório de plugin apropriado para a raiz do seu projeto :
Para laudo código: copie o diretório
.claude-plugin/Para Codex: copie o diretório
.codex-plugin/Para cursor: copie o diretório
.cursor-plugin/Para CLI geminada: copie o diretório
skills/
Outras plataformas
Copie o diretório
skills/para a localização onde seu agente de codificação lê suas habilidades ou arquivos de contexto. Consulte a documentação do seu agente para obter o caminho correto.Copie
mcp.jsonpara a raiz do seu projeto (se estiver usando o servidor MCP).Se estiver usando o servidor MCP, configure o servidor MCP com seus detalhes de conexão MongoDB .
Configurar o servidor MCP
Configure o Servidor MongoDB MCP para as habilidades que acessam um banco de dados ativo. Você pode usar habilidades focados em design, ajuste e orientação de melhores práticas sem o MCP, embora alguns forneçam uma experiência mais rica quando você o ativar.
Para obter opções completas de configuração do servidor MCP, consulte Introdução ao MongoDB MCP Server.
Usando habilidades do agente
Depois de instaladas, as habilidades do agente funcionam automaticamente em segundo plano. Quando você solicita ajuda ao seu agente de codificação de IA com as tarefas do MongoDB , ele usa as habilidades instaladas para fornecer respostas mais precisas e úteis.
Exemplos de interações:
"Ajude-me a configurar uma conexão MongoDB em meu aplicativo Node.js "
"Criar um esquema para uma coleção de usuário com validação de e-mail"
"Escreva um pipeline de agregação para calcular os totais de vendas mensais"
"Mostre-me como implementar a paginação para esta query"
O agente usará as habilidades do MongoDB para fornecer respostas que seguem as práticas recomendadas do MongoDB e são personalizadas para seu caso de uso específico.
Invocar habilidades do agente
As habilidades do agente são invocadas automaticamente quando você solicita ajuda ao agente de codificação de IA com as tarefas do MongoDB . Algumas plataformas permitem que você invoque habilidades manualmente.
Por exemplo, você pode invocar uma habilidade diretamente no código ão usando /<skill-name>.