Overview
El clúster Atlas vinculado a su espacio de trabajo forma parte de la política de salida base de la plataforma. Una vez que vincule un clúster, su agente podrá acceder a él tanto en el modo deny_all como en el modo allow_list, y no necesitará agregarlo como destino de salida.
En esta guía, aprenderá cómo vincular un clúster de Atlas a su espacio de trabajo mediante la interfaz de línea de comandos agentengine, verificar la vinculación y modificar el clúster vinculado posteriormente.
Al vincular un clúster, también se agregan las direcciones IP de conexión de Atlas Agent Engine a la lista de acceso IP del clúster. No es necesario agregar estas direcciones IP manualmente.
Para obtener información sobre cómo permitir los destinos que la política base no cubre, como las API de los proveedores de LLM y otros servicios de terceros, consulte la guía "Administrar políticas de salida de red".
Requisitos previos
Antes de comenzar, asegúrese de cumplir con los siguientes requisitos previos:
Tienes instalada la versión 0.1.54-alpha o posterior de la interfaz de línea de comandos (CLI)
agentengine, y está disponible en tu variable de entornoPATH. Para obtener más información, consulta la guía de instalación y autenticación.Puedes autenticarte en la plataforma utilizando el comando
agentengine auth login.Dispones de un proyecto de Atlas que contiene el clúster que deseas vincular, o bien tienes permiso para crear un clúster en ese proyecto.
Crear una cuenta de servicio de Atlas
La CLI agentengine se autentica en Atlas mediante una cuenta de servicio. Cree una cuenta de servicio en el proyecto de Atlas que contiene su clúster y, a continuación, asígnele cualquiera de las siguientes configuraciones de rol:
Project OwnerrolCluster CreatorrolesCluster Manager,Database Access AdminyNetwork Access Manager
Para saber cómo la CLI almacena y resuelve las credenciales de las cuentas de servicio, consulte la guía "Configurar recursos de Atlas".
Vincula el clúster
Seleccione o cree un clúster.
Cuando la interfaz de línea de comandos (CLI) se lo solicite, seleccione el clúster que desea vincular. Si prefiere crear un clúster, elija la opción correspondiente. Los clústeres nuevos se configuran de forma predeterminada en el nivel Flex.
Nota
No utilice los niveles M0 ni compartidos. Para obtener más información sobre los requisitos de los niveles de clúster, consulte la guía Configurar recursos de Atlas.
Verificar el enlace
La interfaz de línea de comandos (CLI) muestra dos vistas diferentes de la configuración de Atlas: el estado local de la CLI y el estado de la plataforma. Dado que estos estados pueden diferir, verifique ambos al solucionar un problema de conexión.
Estado CLI local
Para revisar la configuración de Atlas registrada en su máquina, ejecute el siguiente comando:
agentengine atlas setup
Este comando lee el estado local que la CLI almacena en el archivo .agentengine/state.json. En una nueva copia o en una máquina diferente, es posible que el comando le pida que ejecute la configuración completa de nuevo, incluso si su espacio de trabajo ya está vinculado. Este comportamiento es normal y no desvincula el clúster.
Estado de la plataforma
Para revisar el enlace que registró Atlas Agent Engine, ejecute el siguiente comando:
agentengine atlas status
Este comando informa sobre el entorno Atlas vinculado y el ID del proyecto, el estado de sincronización de salida y la hora de la última sincronización exitosa. La siguiente tabla describe los valores del estado de sincronización:
Estado | Descripción |
|---|---|
| Atlas Agent Engine tiene la política de clúster actual. |
| Atlas Agent Engine está aplicando un cambio de política. |
| Atlas Agent Engine no puede recuperar la política del clúster. |
Cambiar el clúster vinculado
Para conectar un clúster diferente, ejecute nuevamente el comando agentengine atlas setup y seleccione el nuevo clúster. Este comando reconfigura el enlace de salida y la lista de acceso IP de Atlas del nuevo clúster.
Nota
Si el nuevo clúster pertenece a un proyecto de Atlas diferente, su cuenta de servicio también debe tener el rol Project Owner en ese proyecto.
Solución de problemas
Esta sección describe los problemas que puede encontrar al vincular un clúster de Atlas.
La instalación falla con un error de permisos.
Confirme que su cuenta de servicio de Atlas tiene el rol Project Owner en el proyecto de Atlas que contiene su clúster.
El programa de configuración no puede vincular su proyecto Atlas.
El comando agentic atlas setup vincula automáticamente tu proyecto de Atlas con tu espacio de trabajo. Si la vinculación falla, el comando imprime una nota y finaliza. Para volver a intentar la vinculación, ejecuta agentic atlas link y luego agentic atlas status para confirmar que la vinculación se realizó correctamente.
Tu agente no puede acceder a un clúster que no has vinculado.
La política base solo cubre el clúster vinculado. Para acceder a otro clúster de MongoDB, agréguelo como destino de salida en el puerto 27017. Para obtener más información, consulte la guía "Administrar políticas de salida de red".
Tu agente no usa memoria pero aún así no puede llegar a Atlas.
Deshabilitar la memoria no elimina el requisito de Atlas. Si su espacio de trabajo se conecta a Atlas, vincule el clúster como se describe en esta guía.
Próximos pasos
Después de vincular su clúster, habilite los demás destinos a los que llama su agente, como las API del proveedor LLM. Para obtener más información, consulte el tutorial "Primeros pasos con la salida de red".