Overview
在本指南中，您可以学习；了解如何在本地开发环境中手动测试Atlas Agent Engine代理。使用 agentengine dev 命令启动环境后， CLI会打印应用和本地MongoDB实例的 URL，以便您可以在构建代理并将其部署到云之前驱动请求、检查响应和调试问题。
先决条件
开始之前，请确保完成以下任务：
安装并配置agentengine CLI。
访问本地服务
当您在热重载或隔离模式下运行agentengine dev up 时， CLI会为代理构建Docker映像并启动完整堆栈。当所有服务准备就绪时， CLI会打印应用和本地MongoDB实例的URL。
使用以下 URL 执行手动测试：
应用端点URL：使用浏览器、 API客户端或命令行工具向代理发送请求。
MongoDB Atlas本地URL：使用
mongosh或其他MongoDB客户端进行连接，以检查或播种测试数据。
示例，您可以使用这些 URL 执行以下测试：
发送聊天或HTTP请求，执行特定工具调用。
将测试文档插入本地数据库，并验证代理如何使用这些文档。
检查响应的正确性、延迟和错误处理。
在热重载模式下进行测试
热重载模式将源代码安装到应用容器中，并在每次保存更改时重新加载代理进程。使用以下工作流程进行测试和迭代，而无需重建堆栈。
若要学习；了解如何以热重载模式启动环境或将VS Code附加到运行的容器，请参阅《构建本地环境》指南中的热重载模式（推荐）。
在隔离模式下进行测试
如果要验证依赖于服务边界、容器重启或网络交互的行为，请使用隔离模式。
检查日志并排除故障
测试时，使用 agentengine dev 命令检查日志并根据需要重置状态。
查看日志
要从所有运行的服务流日志，运行以下命令：
agentengine dev logs
使用此输出来调试错误、验证工具调用以及检查代理发出的跟踪消息。
重置本地状态
如果遇到与本地MongoDB副本集或数据相关的持续错误，可以通过运行以下命令来重置本地状态：
agentengine dev clean agentengine dev up
此序列会删除所有本地卷并启动新的堆栈。
警告
运行 agentengine dev clean 会永久删除存储在MongoDB Atlas Local 卷中的所有本地数据。在运行此命令之前，请备份所需的任何数据。
后续步骤
在本地验证代理后，您可以构建它并将其部署到Atlas Agent Engine云环境。要学习；了解如何包代理映像并将其部署到工作区，请参阅“部署代理”部分。