准备环境和模型
做完这一节,你的电脑上有一个装好依赖的 Python 环境、一个能调用工具的模型,并且知道怎么用三个环境变量在不同模型之间切换。
1. Python 环境
需要 Python 3.10 以上。建一个虚拟环境,装两个库:
bash
python3 -m venv .venv
source .venv/bin/activate # Windows:.venv\Scripts\activate
pip install openai mcpopenai:调用模型用。虽然叫 openai,但它能连任何“OpenAI 兼容”的接口,国内的大部分模型服务都兼容。mcp:第三阶段写 MCP 服务器和客户端用。
我们用的版本:openai 3.57.0、mcp 2.3.0。
2. 选一个模型
Agent 需要模型支持工具调用(tool calling / function calling)。两条路,选一条:
查一查我想用……
点一个看看。
本课所有代码都从三个环境变量读配置,默认值就是本地 Ollama:
| 环境变量 | 本地 Ollama | 云端 |
|---|---|---|
AGENT_BASE_URL | http://localhost:11434/v1(默认) | 服务商给的接口地址 |
AGENT_API_KEY | ollama(默认,随便填) | 你的 API Key |
AGENT_MODEL | qwen3:8b(默认) | 服务商的模型名 |
用云端模型时,在终端里先设好(macOS / Linux):
bash
export AGENT_BASE_URL="服务商给的地址"
export AGENT_API_KEY="你的 key"
export AGENT_MODEL="模型名"API Key 不要写进代码,更不要提交到 Git。
3. 先确认能通
把下面存成 hello.py 运行:
python
import os
from openai import OpenAI
client = OpenAI(base_url=os.environ.get("AGENT_BASE_URL", "http://localhost:11434/v1"),
api_key=os.environ.get("AGENT_API_KEY", "ollama"))
resp = client.chat.completions.create(
model=os.environ.get("AGENT_MODEL", "qwen3:8b"),
messages=[{"role": "user", "content": "用一句话介绍你自己"}])
print(resp.choices[0].message.content)你应该看到模型回了一句自我介绍。
报错 Using SOCKS proxy, but the 'socksio' package is not installed
你的终端里设了 SOCKS 代理(环境变量 ALL_PROXY 之类),openai 库会尝试走代理。两种办法:连国内服务或本机 Ollama 不需要代理,就在运行前取消它,例如 env -u ALL_PROXY -u all_proxy python hello.py;确实需要代理,就 pip install "httpx[socks]"。我们在写这门课时就遇到了这个报错。
考考你为什么用 openai 这个库,也能调用 DeepSeek、通义千问或者本地 Ollama?
检查一下
pip list里有 openai 和 mcp- 我选好了模型,三个环境变量知道怎么填
hello.py打印出了模型的回复
下一节动手:让模型调用一个函数。