Configuración para Introducción a Agentes de IA

Construir un agente requiere sorprendentemente poca configuración. Necesitas un lugar adonde enviar una solicitud, permiso para enviarla, y un modelo del otro lado que pueda llamar herramientas.

Son tres valores. El resto de esta guía te ayuda a configurarlos bien desde la primera vez, para que nada en el curso falle por razones ajenas a los agentes.

Estas páginas acompañan el curso Introducción a Agentes de IA de Scrimba, y funcionan por sí solas. Si trabajas en el curso desde el navegador, solo necesitas las primeras tres páginas. Si prefieres tener el código en tu máquina, la última página también te cubre.

El código del curso está en JavaScript, y el manual de JavaScript está disponible si quieres repasarlo primero.

Lo que configurarás

Tres variables de entorno llevan todo lo que el código del curso necesita para llegar a un modelo:

Variable	Qué contiene
AI_URL	La URL base de la API del proveedor, a donde se envían las solicitudes
AI_KEY	Tu clave de API, que es lo que autoriza esas solicitudes
AI_MODEL	El ID del modelo específico con el que quieres hablar

Deben estar sincronizadas entre sí. Una clave válida apuntada a la URL incorrecta del proveedor falla, y un proveedor correcto con un ID de modelo que ese proveedor no sirve también falla. Siempre que cambies de proveedor, modifica los tres valores juntos.

¿Vienes de Introducción a Ingeniería de IA?

Estas son las mismas tres variables que usaba ese curso. Si ya las tienes guardadas en Scrimba, quizás puedas ir directo a modelos recomendados y confirmar que tu modelo soporta llamadas de herramientas.

JunoLo que configurarásAI_URL, AI_KEY y AI_MODEL son una configuración en tres partes. La URL dice con qué empresa estás hablando, la clave demuestra que tienes permiso, y el modelo dice qué inteligencia responde.

Solo funcionan como un conjunto coordinado, así que modifica los tres juntos cada vez que cambies de proveedor. ¡Mezclar la clave de un proveedor con la URL de otro es el error que casi todos cometen una vez!

JunoLo que configurarás Estos tres son un conjunto coordinado, y el error que realmente vas a encontrar no es un typo en uno de ellos. Es un rezago: una clave del proveedor que usaste el mes pasado enviada a la URL que configuraste hoy.

Así que trata el cambio de proveedor como una edición con tres partes. Si obtienes un error de autenticación o un error de modelo no encontrado, relee los tres antes de releer tu propio código.

JunoLo que configurarás La razón por la que vale la pena prestar tanta atención a una discrepancia es que los mensajes de error mienten sobre dónde está el problema. Una clave enviada a la URL base incorrecta vuelve como un 401, que se lee como "tu clave es mala" cuando la clave está bien. Un modelo que tu proveedor no sirve vuelve como un 404 en el nombre del modelo, que se lee como un typo.

Ambos son el mismo fallo subyacente, y ningún mensaje apunta a él. Mantener los tres valores juntos en tu mente como una unidad es lo que te ahorra media hora.

Las páginas en orden

Configuración del proveedor te guía por crear una cuenta con OpenAI u OpenRouter, generar una clave de API, y guardar los tres valores.

Modelos recomendados cubre el único requisito difícil, las llamadas de herramientas, y te da una lista probada para que no tengas que adivinar.

Chat Completions y Responses explica las dos APIs de OpenAI que verás en la práctica, cómo difieren sus formas de solicitud y respuesta, y por qué este curso usa Responses.

Ejecutar el código localmente es para cuando quieres sacar el proyecto de Scrimba y llevarlo a tu máquina, cubriendo la descarga, el archivo .env, instalar dependencias, y las colisiones de puertos que atrapan a la gente.

Una cosa que decidir desde el principio

Casi todo en este curso funciona con cualquier proveedor que hable la forma de API de OpenAI. Lo que no varía es el requisito de que tu modelo pueda llamar herramientas.

Un agente es un modelo que decide usar una herramienta, así que un modelo sin llamadas de herramientas no puede convertirse en uno sin importar cómo esté escrito el resto del código. Ten esto en mente si exploras más allá de la lista recomendada, porque una limitación del modelo y un bug en tu código se ven idénticos en la consola.

JunoUna cosa que decidir desde el principio Las llamadas de herramientas son lo único que un modelo tiene que poder hacer aquí. Todo lo demás es preferencia: qué tan rápido es, cuánto cuesta, qué tan conversador es.

Un agente es un modelo que le pide a tu código que ejecute algo, así que un modelo que no pueda hacer esa solicitud no puede ser un agente en absoluto. La lista corta en la página de modelos ya tiene esto verificado, así que no tienes que trabajarlo por tu cuenta.

JunoUna cosa que decidir desde el principio Las llamadas de herramientas son el requisito difícil, y es lo primero que debes verificar cuando te salgas de la lista recomendada. Las fichas de modelo lo indican, usualmente como "function calling" o "tools".

Construye el hábito ahora: cuando una lección se comporta mal y tu código coincide con la solución, cambia a un modelo conocido y confiable antes de releer tu propio trabajo. Es una prueba de treinta segundos que descarta la causa que la gente verifica al último.

JunoUna cosa que decidir desde el principio Las llamadas de herramientas son una capacidad del endpoint servido, no solo del modelo, que es la parte que atrapa a la gente. Los mismos pesos detrás de una ruta diferente pueden volver sin soporte de herramientas, y un nivel gratuito puede servir una variante cuantizada o de otro modo reducida sin la característica.

Por eso la lista corta nombra rutas y no solo familias de modelos. Cuando un modelo que debería soportar herramientas parece no hacerlo, verifica qué ruta estás golpeando realmente antes de concluir que el modelo es el culpable.

Otros cursos de IA de Scrimba

Cada otro curso y proyecto de IA tiene su propia guía de configuración local. Ejecutar un proyecto de curso de IA localmente es el índice para esos, cubriendo la Ruta del Ingeniero de IA, Chef Claude, e Introducción a Mistral AI.

Toma la Ruta del Ingeniero de IA en ScrimbaLa Ruta del Ingeniero de IA de Scrimba te lleva desde tu primera llamada LLM hasta agentes, RAG y MCP en nueve módulos interactivos.→