新手小白 Agent 开发第2课:获取模型 API,写出你的第一个 AI 程序
环境搭好了接下来要给 Agent 装上「大脑」——也就是调用大模型 API。别紧张所谓 AI 应用底层很多时候就是在调用 API。这一课结束你能用 Python 让 AI 回答你的问题。一、获取模型 API你可以使用 OpenAI、Anthropic、Google 等模型。为了教学简单我们先以 OpenAI API 为例。1. 安装 OpenAI SDK回到 VS Code 终端确认前面还有(.venv)执行pip install openai检查是否安装成功pip show openai看到Name: openai和版本号就 OK。2. 设置 API Key重点千万不要把 API Key 直接写进代码里。例如不要这样api_key sk-xxxxxxxx # 危险容易泄露因为一旦上传 GitHubKey 就会被别人拿到。我们先用环境变量。Windows PowerShell$env:OPENAI_API_KEY你的API Key检查一下echo $env:OPENAI_API_KEYAPI Key 就像银行卡密码后面我们会进一步学习用.env这类更规范的管理方式。二、写出第一段 AI 程序在my-agent里创建main.pyfrom openai import OpenAI client OpenAI() response client.responses.create( model你的模型名称, input你好请介绍一下什么是人工智能。 ) print(response.output_text)运行python main.py如果一切正常你会得到类似人工智能是研究如何让计算机执行通常需要人类智能才能完成的任务……恭喜这就是你的第一个 AI 程序。这两行代码到底做了什么response client.responses.create(...)意思是「把我的问题交给大模型。」print(response.output_text)意思是「把大模型的回答打印出来。」整个链路是这样的Python → OpenAI SDK → API → 大模型 → 回答 → Python → 终端一句话概括调用大模型本质就是「发一句话过去收一句话回来」。三、想用 DeepSeek 怎么办改三个地方就行很多人以为换模型要重写代码其实不用。DeepSeek 提供了与 OpenAI 兼容的接口所以我们可以继续用openai这个 SDK只改三个参数。1. 获取 DeepSeek API Key到 DeepSeek 开放平台platform.deepseek.com创建 API Key。同样不要写进代码用环境变量$env:DEEPSEEK_API_KEY你的DeepSeek API Key2. 修改代码改用 DeepSeek 兼容的 Chat Completions 接口from openai import OpenAI import os client OpenAI( api_keyos.environ[DEEPSEEK_API_KEY], base_urlhttps://api.deepseek.com ) response client.chat.completions.create( modeldeepseek-chat, messages[ { role: user, content: 你好请介绍一下人工智能。 } ] ) print(response.choices[0].message.content)运行python main.py如果看到 DeepSeek 的回答就成功了。3. 三处变化一眼看懂变化点OpenAIDeepSeek作用api_keyOPENAI_API_KEYDEEPSEEK_API_KEY用谁的钱base_url默认https://api.deepseek.com请求发给谁model如 gpt-4odeepseek-chat用哪个模型其中base_url是最关键的地方。你可以这样理解SDK 是「电话」base_url 是「拨打哪个号码」。一句话概括换模型换的是「号码」和「名字」不是整套代码。四、一个重要的设计思想模型层与 Agent 层解耦我们最终开发 Agent 时会把模型单独抽象出来Agent │ ├── OpenAI ├── DeepSeek ├── Claude ├── Gemini └── 其他模型换供应商时主要修改API_KEY BASE_URL MODEL而 Agent 的Tool、Memory、Search、Planning 等代码尽量保持不变。这样设计的好处是今天你用 DeepSeek明天想换 GPT 或 Claude只需要改配置不用重写业务逻辑。一句话概括模型只是可替换的零件Agent 才是你要造的那台机器。总结这一课的核心就一句话AI 应用 调用 API。我们用几行代码让大模型开口说话还学会了如何从 OpenAI 平滑切换到 DeepSeek。但现在的程序有个小问题——问一次就结束而且它记不住上一句话。下一课我们把它改造成真正的聊天机器人并引入「对话历史」这个概念这是 Memory 的第一步。下一课预告第3课从一问一答到聊天机器人——对话历史与 Memory 入门。