Skip to content

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:

bash
python3 -m venv .venv
source .venv/bin/activate        # Windows:.venv\Scripts\activate
pip install openai mcp
  • openai: 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 entornoOllama localEn la nube
AGENT_BASE_URLhttp://localhost:11434/v1 (por defecto)La dirección de la interfaz que da el proveedor
AGENT_API_KEYollama (por defecto, pon cualquier cosa)Tu API Key
AGENT_MODELqwen3:8b (por defecto)El nombre del modelo del proveedor

Al usar un modelo en la nube, configúralo primero en la terminal (macOS / Linux):

bash
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:

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)

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 list aparecen openai y mcp
  • Ya elegí el modelo y sé cómo rellenar las tres variables de entorno
  • hello.py imprimió la respuesta del modelo

En la próxima sección, manos a la obra: hacer que el modelo llame a una función.

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.