Overview
En esta guía, aprenderá a probar manualmente su agente de Atlas Agent Engine en un entorno de desarrollo local. Tras iniciar el entorno con el comando agentengine dev, la interfaz de línea de comandos (CLI) mostrará las URL de la aplicación y de la instancia local de MongoDB para que pueda gestionar las solicitudes, inspeccionar las respuestas y depurar los problemas antes de compilar e implementar el agente en la nube.
Requisitos previos
Antes de comenzar, asegúrese de completar las siguientes tareas:
Instale y configure la interfaz de línea de comandos de agentengine.
Para crear un entorno de desarrollo local, siga los pasos de la guía "Ejecutar y probar el agente localmente".
Para obtener más información sobre cómo instalar la interfaz de línea de comandos (CLI), autenticarse y registrar el proyecto, consulte la sección Instalación y autenticación.
Acceda a los servicios locales
Al ejecutar agentengine dev up en modo de recarga en caliente o en modo aislado, la CLI crea la imagen de Docker para el agente e inicia la pila completa. Cuando todos los servicios están listos, la CLI muestra las URL de la aplicación y de la instancia local de MongoDB.
Utilice las siguientes URL para realizar sus pruebas manuales:
URL del punto final de la aplicación: Utilice un navegador, un cliente API o herramientas de línea de comandos para enviar solicitudes a su agente.
URL local de MongoDB Atlas: Conéctese usando
mongoshu otro cliente de MongoDB para inspeccionar o insertar datos de prueba.
Por ejemplo, puede utilizar estas URL para realizar las siguientes pruebas:
Envía una solicitud de chat o HTTP que ejecute una llamada a una herramienta específica.
Inserte documentos de prueba en la base de datos local y verifique cómo los utiliza el agente.
Inspeccione las respuestas para verificar su corrección, latencia y manejo de errores.
Prueba en modo de recarga en caliente
El modo de recarga en caliente monta el código fuente en el contenedor de la aplicación y recarga el proceso del agente cada vez que guardas un cambio. Utiliza el siguiente flujo de trabajo para probar e iterar sin reconstruir la pila.
Para aprender a iniciar el entorno en modo de recarga en caliente o a conectar VS Code al contenedor en ejecución, consulte el apartado Modo de recarga en caliente (recomendado) en la guía "Crea tu entorno local".
Prueba en modo aislado
Utilice el modo aislado cuando desee validar comportamientos que dependan de los límites del servicio, los reinicios de los contenedores o las interacciones de red.
Para aprender a iniciar el entorno en modo aislado, consulte la sección "Modo aislado" en la guía "Crea tu entorno local".
Aplicar cambios en el código.
Dado que el modo aislado no monta el código fuente del host, debe reconstruir las imágenes después de realizar cambios en el código. Ejecute los siguientes comandos para aplicar los cambios:
agentengine dev stop agentengine dev up --isolated
El primer comando detiene los contenedores en ejecución. El segundo reconstruye y reinicia la pila aislada con el código actualizado.
Inspeccionar registros y solucionar problemas
Mientras realizas las pruebas, utiliza los comandos agentengine dev para inspeccionar los registros y restablecer el estado según sea necesario.
Ver registros
Para transmitir los registros de todos los servicios en ejecución, ejecute el siguiente comando:
agentengine dev logs
Utilice esta información para depurar errores, verificar las llamadas a las herramientas e inspeccionar los mensajes de seguimiento emitidos por su agente.
Restablecer estado local
Si encuentra errores persistentes relacionados con el conjunto de réplicas o los datos locales de MongoDB, puede restablecer el estado local ejecutando los siguientes comandos:
agentengine dev clean agentengine dev up
Esta secuencia elimina todos los volúmenes locales y comienza una nueva pila.
Advertencia
Al ejecutar agentengine dev clean se eliminan permanentemente todos los datos locales almacenados en el volumen local de MongoDB Atlas. Realice una copia de seguridad de los datos que necesite antes de ejecutar este comando.
Próximos pasos
Tras validar el agente localmente, puede compilarlo e implementarlo en el entorno de nube de Atlas Agent Engine. Para obtener información sobre cómo empaquetar la imagen del agente e implementarla en un espacio de trabajo, consulte la sección «Implementar el agente».