准备环境：你需要什么？

在开始之前，确保你的电脑上已经安装了 Python（一种简单易学的编程语言）。如果没装，可以去 python.org 下载最新版本（推荐 3.10 或更高）。安装时记得勾选“Add Python to PATH”，这样在命令行里就能直接用 python 命令了。

另外，你需要一个代码编辑器，比如 VS Code（免费又好用），或者直接用系统自带的记事本也行，但编辑器会更方便。

安装 Pydantic AI

打开命令行（Windows 用户按 Win+R，输入 cmd；Mac 用户打开“终端”）。然后输入下面这行命令，回车：

pip install pydantic-ai

pip 是 Python 的包管理器，帮我们下载和安装别人写好的代码库。等待安装完成，如果看到“Successfully installed”就说明成功了。

运行你的第一个智能体

新建一个文件，命名为 first_agent.py，用编辑器打开，复制以下代码：

from pydantic_ai import Agent

agent = Agent(
    'openai:gpt-4o',
    system_prompt='你是一个友好的助手。'
)

result = agent.run_sync('你好，请介绍一下你自己。')
print(result.data)

这段代码创建了一个 智能体（可以理解为一个能对话的 AI 程序），并让它回答一个问题。注意：你需要一个 OpenAI API 密钥才能运行。把密钥设为环境变量：在命令行输入 set OPENAI_API_KEY=你的密钥（Windows）或 export OPENAI_API_KEY=你的密钥（Mac/Linux）。

然后运行脚本：

python first_agent.py

如果看到 AI 的回答，恭喜你，第一次跑通啦！

下一步可以做什么

• 试试修改 system_prompt，让 AI 扮演不同角色。
• 学习如何让智能体使用工具（比如计算或搜索）。
• 了解 类型安全（Type-Safe）：Pydantic AI 能确保 AI 返回的数据格式正确，避免程序出错。

现在你已经迈出了 AI 开发的第一步，继续探索吧！