极客前沿

AI 入门:一步步搭好环境,第一次跑通你的智能体

2026-06-17 01:30
freeCodeCamp
查看原文

从零开始,教你安装 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 注册账号,创建一个密钥并复制保存(关闭后就看不到了)。

Tutorial Image
  • 把密钥设为环境变量:在终端输入 set ANTHROPIC_API_KEY=你的密钥(Windows)或 export ANTHROPIC_API_KEY=你的密钥(Mac/Linux)。
  • 常见坑:密钥不要硬编码在代码里,也不要分享给别人。

下载示例代码:跑第一个智能体

我们用一个现成的项目,它包含防止智能体失控的基本组件。打开终端,运行以下命令:

  1. git clone https://github.com/dannwaneri/production-safe-agent-loop.git —— 下载代码。
  2. cd production-safe-agent-loop —— 进入文件夹。
  3. pip install -r requirements.txt —— 安装依赖(自动装好所需库)。
  4. python main.py —— 启动程序。

你会看到程序让你输入一个任务描述(比如“列出当前目录的文件”),然后智能体开始工作,最后输出结果。如果一切顺利,恭喜你,第一个 AI 智能体跑通了!

验证是否成功:看日志和输出

程序运行时会打印日志,显示每一步做了什么。你还会在文件夹里看到一个 SQLite 数据库文件(比如 agent_ledger.db),它记录了所有操作,方便你回头检查。

  • 如果报错,常见原因是 API 密钥没设对或网络问题。检查环境变量,或者试试用 VPN。
  • 成功标志:程序正常结束,没有无限循环或疯狂调用 API。

接下来你可以试着修改任务描述,或者看看代码里的 spec_writer.py 是怎么定义任务结束条件的。祝你上手愉快!

内容来源

freeCodeCamp

发布时间

2026-06-17 01:30

返回 AI技术