Tutoriales por semana
Semana 4 · Tool use y automatización
La IA actúa sobre tu producto — llama funciones reales con argumentos validados.
27 – 29 jul 2026 · Técnico
Los pasos de esta semana ya son ejecutables — el registry de tools y la pantalla de chat vienen en el boilerplate. Los prompts se irán afinando antes de la semana en vivo.
Qué vas a tener al final
- ✅ Una tool propia registrada en el registry.
- ✅ El modelo decide cuándo llamarla y con qué argumentos.
- ✅ Auditoría: cada tool call queda guardada en la tabla
tool_calls(ya la creó tusupabase db pushde la Semana 2). - ✅ Un flujo
recuperar → decidir → actuarcon LangGraph — una librería para encadenar pasos de IA, como un diagrama de flujo que el modelo recorre.
Concepto: tool use
Tool use es darle al modelo una lista de funciones que puede invocar. El modelo decide cuándo llamarlas y con qué argumentos; tú ejecutas la función y le devuelves el resultado. El loop sigue hasta que el modelo da una respuesta final.
VibeFast usa un registry: un catálogo central donde defines la tool una vez y queda disponible tanto para tool use (OpenAI) como para MCP (Sem 5). Más detalle en Features → Tool use.
Paso 1 · Conoce las tools que ya trae tu proyecto
El boilerplate incluye 3 tools de ejemplo en web/lib/tools/examples/: crearItem, buscarItems y enviarEmail. Ábrelas en Cursor y fíjate en la forma: cada una es un objeto con name, description, parameters y execute. Esa es la plantilla de la tuya.
Paso 2 · Prueba el chat con tools
- Verifica que
features.aiChatesté entrueenweb/config.js(viene activado). - Abre
localhost:3000/chaty pídele algo que dispare una tool, por ejemplo: "créame un item que se llame Prueba".
✅ El chat responde y la acción se ejecuta (el item aparece en tu dashboard).
✅ En Supabase → Table Editor → tabla tool_calls quedó registrada la llamada — esa es tu auditoría.
Paso 3 · Crea TU tool
Piensa en UNA acción de tu producto que la IA debería poder ejecutar (ej. "cambiar el estatus de un lead", "agendar una cita"). Luego:
Crea una tool nueva en este proyecto VibeFast siguiendo el patrón de web/lib/tools/examples/ (mira crearItem.js).La tool: {qué hace, ej. "cambia el estatus de un lead"}.
Recibe: {argumentos, ej. id del lead y nuevo estatus (nuevo/contactado/cerrado)}.
Hace: {qué toca, ej. actualiza la fila en la tabla core_items}.Regístrala igual que los ejemplos para que quede disponible en /chat, y dime cómo probarla con una frase en el chat.Paso 4 · Pruébala como usuario
✅ Se lo pides en /chat con lenguaje natural y el modelo llama TU tool con los argumentos correctos.
✅ El cambio se ve en tu dashboard y la llamada queda en tool_calls.
✅ Le pides algo fuera de alcance y el modelo NO inventa una tool que no existe.
Paso 5 · (Avanzado) Encadena pasos con LangGraph
El boilerplate trae un flujo recuperar → decidir → actuar de ejemplo (web/lib/agents/examples/recoverDecideAct.js + endpoint /api/ai/agent). El concepto está en Features → Agentes con LangGraph; en la semana en vivo lo convertimos en un flujo de TU producto con 2+ tools.
Entregable
Un flujo / acción de IA que ejecuta funciones reales de tu producto: video corto mostrando la frase en /chat, la tool ejecutándose y la fila en tool_calls.