Skip to content
起步第 3 / 3 节

准备环境和模型 ​

做完这一节,你的电脑上有一个装好依赖的 Python 环境、一个能调用工具的模型,并且知道怎么用三个环境变量在不同模型之间切换。

1. Python 环境 ​

需要 Python 3.10 以上。建一个虚拟环境,装两个库:

bash
python3 -m venv .venv
source .venv/bin/activate        # Windows:.venv\Scripts\activate
pip install openai mcp
  • openai:调用模型用。虽然叫 openai,但它能连任何“OpenAI 兼容”的接口,国内的大部分模型服务都兼容。
  • mcp:第三阶段写 MCP 服务器和客户端用。

我们用的版本:openai 3.57.0、mcp 2.3.0。

2. 选一个模型 ​

Agent 需要模型支持工具调用(tool calling / function calling)。两条路,选一条:

查一查我想用……

点一个看看。

本课所有代码都从三个环境变量读配置,默认值就是本地 Ollama:

环境变量本地 Ollama云端
AGENT_BASE_URLhttp://localhost:11434/v1(默认)服务商给的接口地址
AGENT_API_KEYollama(默认,随便填)你的 API Key
AGENT_MODELqwen3: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 打印出了模型的回复

下一节动手:让模型调用一个函数。

搞懂AI关于我们怎么写隐私说明联系我们

独立的第三方教程,与文中提到的任何产品及其公司没有隶属或合作关系;产品名称和商标归各自所有者。价格和政策以官方页面为准。