Agent Space启动报“ModuleNotFoundError”或“ImportError”时，需根据报错信息确认缺失包名或版本不兼容问题，在激活虚拟环境后执行pip install安装；若存在requirements.txt则用pip install -r requirements.txt批量安装，失败时手动指定镜像源重装；最后通过Python导入、重启服务或运行health check脚本验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当Agent Space运行时提示“ModuleNotFoundError”或“ImportError”，说明当前环境缺少某个Python包，必须补全依赖才能让Agent正常启动。
确认缺失的依赖名称
查看终端报错信息末尾的模块名，例如 ModuleNotFoundError: No module named 'langchain'，其中 【'langchain'】 就是缺失的包名。
如果报错中出现类似 ImportError: cannot import name 'ChatOpenAI' from 'langchain.chat_models'，说明包已安装但版本不兼容——此时也要按缺失处理，需重装指定版本。
使用pip安装缺失包
在Agent Space项目根目录下打开终端，执行：
pip install 包名
例如：
pip install langchain
若需指定版本（常见于Agent Space文档明确要求），则写成：
pip install langchain==0.1.16
【必须在激活对应虚拟环境后执行，否则可能装到系统Python里，Agent仍无法识别】
批量安装requirements.txt中的所有依赖
多数Agent Space项目根目录自带 requirements.txt 文件。执行以下命令可一次性补全全部依赖：
第一步：确保当前路径下存在 requirements.txt
第二步：运行 pip install -r requirements.txt
第三步：等待安装完成，过程中若某包安装失败（如因网络超时），pip会中断并报错
遇到中断时不要直接重试，先检查失败包名，手动执行 pip install 失败包名 —— 有些包（如 torch）需配合 --index-url 指定国内镜像源才可成功安装。
验证依赖是否生效
方法一：在Python交互环境中导入测试
python -c "import langchain; print(langchain.__version__)"
方法二：重启Agent Space服务，观察启动日志是否不再报ModuleNotFoundError
方法三：运行 agent space 自带的 health check 脚本（如有），通常为 python scripts/check_deps.py
