如果你在中国,用智能体编程或办公之前,务必看这个日课
让 Agent 帮你做数据分析、处理表格、生成 PPT 或者写 Python 脚本,如果你遇到过 Agent 突然卡住、然后输出一堆红色报错的情况,多半都是同一个原因:依赖包下载失败了。
让 Agent 帮你做数据分析、处理表格、生成 PPT 或者写 Python 脚本,如果你遇到过 Agent 突然卡住、然后输出一堆红色报错的情况,多半都是同一个原因:依赖包下载失败了。
Python 的 pip、Node.js 的 npm,默认都去境外服务器拉包。国内这条路不稳定,随时可能超时断掉。Agent 在执行任务途中临时需要安装某个依赖,这一步失败了,整个任务就这样中断。
最一劳永逸的解法:在第一次用 Agent 之前,先让它帮你做一次环境初始化。换掉镜像源,再把后续可能用到的包提前装好,以后跑任务遇到「找不到依赖」的概率会少很多。
把下面这段提示词,复制粘贴给你的 AI 智能体(Trae、Claude Code、Cursor、Open Code 等都可以):
帮我完成以下 AI 使用环境初始化,按顺序执行,完成后汇报每步结果,当遇到问题时可能是中国海外网络连接质量问题,帮我继续尝试或采用更多手段,安装的时候调整超时时间,尽量提升成功率:
一、检查并安装运行环境
检测 Python 版本。如果未安装或版本低于 3.11,安装最新 stable 版 Python(3.13 及以上)。 检测 Node.js 版本。如果未安装或版本低于 20,安装最新 LTS 版本的 Node.js。
二、切换为国内镜像源(永久生效)
将 pip 切换为清华大学镜像源: pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
将 npm 切换为 npmmirror 源: npm config set registry https://registry.npmmirror.com
三、批量安装常用 Python 依赖包
运行以下命令,一次性安装所有包,如果安装失败帮我重试,或者分批安装: pip install pandas numpy scipy matplotlib seaborn plotly openpyxl xlrd xlsxwriter python-docx python-pptx pdfplumber pypdf pdfminer.six pillow pyarrow polars akshare yfinance requests lxml beautifulsoup4 httpx aiohttp playwright mcp fastmcp openai anthropic langchain langchain-core langchain-community langchain-openai tiktoken pydantic pydantic-settings loguru rich tqdm click typer python-dotenv pyyaml tomlkit orjson schedule apscheduler pytz python-dateutil chardet sqlalchemy pymysql psycopg2-binary redis pymongo aiosqlite fastapi uvicorn flask starlette pydub jieba pypinyin psutil watchdog pyperclip opencv-python natsort tabulate colorama cryptography pyjwt anyio aiofiles websockets tenacity markdown jinja2 sqlmodel
四、安装 Playwright 浏览器驱动
playwright install chromium firefox webkit
如果以上任何步骤失败,请告知我具体错误信息。