AI 入门:一步步搭好环境,第一次跑通你的智能体
从零开始,教你安装 Python、配置 API 密钥,并运行一个简单的 AI 智能体循环,理解如何防止失控。
想试试 AI 智能体,但不知从何下手?别担心,这篇教程会带你一步步装好环境、跑通第一个程序。你不需要任何 AI 经验,只要会基本电脑操作就行。
准备环境:先装 Python
AI 程序大多用 Python 写,它是一种简单易学的编程语言。如果你还没装,去 python.org 下载最新版本(3.12 或更高)。安装时记得勾选“Add Python to PATH”,这样后面用起来更方便。
- 下载后双击安装,一路默认即可。
- 装完打开终端(Windows 按 Win+R,输入 cmd;Mac 打开“终端”),输入
python --version,看到版本号就成功了。
获取 API 密钥:让程序能调用 AI
智能体需要调用大模型(比如 Anthropic 的 Claude),这需要一个 API 密钥——相当于你的专属通行证。去 console.anthropic.com 注册账号,创建一个密钥并复制保存(关闭后就看不到了)。
- 把密钥设为环境变量:在终端输入
set ANTHROPIC_API_KEY=你的密钥(Windows)或export ANTHROPIC_API_KEY=你的密钥(Mac/Linux)。 - 常见坑:密钥不要硬编码在代码里,也不要分享给别人。
下载示例代码:跑第一个智能体
我们用一个现成的项目,它包含防止智能体失控的基本组件。打开终端,运行以下命令:
git clone https://github.com/dannwaneri/production-safe-agent-loop.git—— 下载代码。cd production-safe-agent-loop—— 进入文件夹。pip install -r requirements.txt—— 安装依赖(自动装好所需库)。python main.py—— 启动程序。
你会看到程序让你输入一个任务描述(比如“列出当前目录的文件”),然后智能体开始工作,最后输出结果。如果一切顺利,恭喜你,第一个 AI 智能体跑通了!
验证是否成功:看日志和输出
程序运行时会打印日志,显示每一步做了什么。你还会在文件夹里看到一个 SQLite 数据库文件(比如 agent_ledger.db),它记录了所有操作,方便你回头检查。
- 如果报错,常见原因是 API 密钥没设对或网络问题。检查环境变量,或者试试用 VPN。
- 成功标志:程序正常结束,没有无限循环或疯狂调用 API。
接下来你可以试着修改任务描述,或者看看代码里的 spec_writer.py 是怎么定义任务结束条件的。祝你上手愉快!
内容来源
freeCodeCamp
发布时间
2026-06-17 01:30