Preparar el entorno y el modelo
Al terminar esta sección, tu computadora tendrá un entorno Python con las dependencias instaladas, un modelo capaz de llamar herramientas, y sabrás cómo usar tres variables de entorno para cambiar entre distintos modelos.
1. Entorno Python
Se necesita Python 3.10 o superior. Crea un entorno virtual e instala dos librerías:
python3 -m venv .venv
source .venv/bin/activate # Windows:.venv\Scripts\activate
pip install openai mcpopenai: para llamar al modelo. Aunque se llame openai, puede conectarse a cualquier interfaz “compatible con OpenAI”, y la mayoría de los servicios de modelos nacionales son compatibles.mcp: se usa en la tercera etapa para escribir el servidor y el cliente MCP.
Versiones que usamos: openai 3.57.0, mcp 2.3.0.
2. Elige un modelo
El Agent necesita un modelo que admita la llamada a herramientas (tool calling / function calling). Hay dos caminos, elige uno:
BuscarQuiero usar…
Toca uno para ver.
Todo el código de esta lección lee la configuración de tres variables de entorno, y los valores por defecto corresponden a Ollama local:
| Variable de entorno | Ollama local | En la nube |
|---|---|---|
AGENT_BASE_URL | http://localhost:11434/v1 (por defecto) | La dirección de la interfaz que da el proveedor |
AGENT_API_KEY | ollama (por defecto, pon cualquier cosa) | Tu API Key |
AGENT_MODEL | qwen3:8b (por defecto) | El nombre del modelo del proveedor |
Al usar un modelo en la nube, configúralo primero en la terminal (macOS / Linux):
export AGENT_BASE_URL="服务商给的地址"
export AGENT_API_KEY="你的 key"
export AGENT_MODEL="模型名"No escribas la API Key en el código, y mucho menos la subas a Git.
3. Primero confirma que la conexión funciona
Guarda lo siguiente como hello.py y ejecútalo:
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)Deberías ver que el modelo responde con una breve presentación de sí mismo.
error Using SOCKS proxy, but the 'socksio' package is not installed
Tu terminal tiene configurado un proxy SOCKS (la variable de entorno ALL_PROXY o similar), y la librería openai intentará pasar por el proxy. Dos soluciones: si conectas a un servicio nacional o a Ollama en tu máquina no necesitas proxy, desactívalo antes de ejecutar, por ejemplo env -u ALL_PROXY -u all_proxy python hello.py; si de verdad necesitas el proxy, entonces pip install "httpx[socks]". A nosotros nos apareció este error mientras escribíamos este curso.
Pon a prueba tus conocimientos¿Por qué con la biblioteca openai también se puede llamar a DeepSeek, Qwen o un Ollama local?
Comprueba
- En
pip listaparecen openai y mcp - Ya elegí el modelo y sé cómo rellenar las tres variables de entorno
hello.pyimprimió la respuesta del modelo
En la próxima sección, manos a la obra: hacer que el modelo llame a una función.