Herramientas: acciones que realiza el modelo
Funciones que la IA invoca para realizar una acción.
Herramientas: acciones que realiza el modelo es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de MCP Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de MCP Academy incluye 4 lecciones en total.
Conozca la primera primitiva
MCP proporciona al modelo tres bloques de construcción. El primero es la tool: una función que la IA puede ejecutar para hacer algo en el mundo real. 🔧
Las herramientas realizan acciones
Una tool sirve para actuar, no solo para saber. Enviar un correo, consultar una base de datos o crear un archivo son casos adecuados, porque cada uno modifica u obtiene datos del estado actual.
El modelo decide
Usted expone la herramienta, pero el model decide cuándo llamarla. Según la conversación, la IA elige la herramienta adecuada y completa sus argumentos por usted.
Una herramienta es solo una función
En el SDK de Python, una herramienta es una función normal. Márquela con el decorador @mcp.tool() y el servidor la anunciará a los clientes.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bToda herramienta necesita un nombre
Cada herramienta tiene un name que el modelo utiliza para llamarla. De forma predeterminada, el nombre de la función se convierte en el nombre de la herramienta, por lo que add y get_weather funcionan directamente.
Las descripciones guían a la IA
El modelo lee su docstring para saber qué hace una herramienta. Un resumen claro de una sola frase ayuda a la IA a elegir la herramienta adecuada en el momento adecuado.
@mcp.tool()
def add(a: int, b: int) -> int:
"""Add two numbers together."""
return a + bLos argumentos se convierten en un esquema
Los parameters de su función se convierten en un esquema de entrada. El modelo ve los nombres y los tipos, así que sabe exactamente qué datos debe enviar.
Los resultados regresan
Todo lo que su herramienta returns vuelve al modelo como contexto. Después, la IA integra ese resultado en su respuesta al usuario.
Las herramientas pueden tener efectos secundarios
Como una herramienta ejecuta código real, puede cambiar cosas: escribir en el disco, cobrar una tarjeta o publicar un mensaje. Precisamente por eso las herramientas están bajo el control del usuario. ⚠️
Controladas por el modelo por diseño
MCP denomina a las herramientas model-controlled. El modelo inicia la llamada, aunque la aplicación host todavía puede pedir al usuario que la apruebe antes de ejecutar nada.
Una herramienta, una tarea
Mantenga cada tool centrada en una sola acción clara. Las herramientas pequeñas y bien nombradas son mucho más fáciles de elegir correctamente para el modelo que una herramienta enorme que lo abarque todo.
Comprobación rápida
Fijemos qué convierte a una herramienta en una herramienta.
Repaso: herramientas
¡Buen trabajo! Una tool es una función controlada por el modelo que hace algo. Usted le da un nombre, la describe, tipa sus argumentos y devuelve un resultado que la IA puede utilizar. ✅
Aprende Python con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 30
- Lecciones
- 120
Preguntas frecuentes
¿La lección «Herramientas: acciones que realiza el modelo» es gratis?
Sí — el texto completo de «Herramientas: acciones que realiza el modelo» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de MCP Academy, actualiza a CoddyKit PRO. El curso de MCP Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Herramientas: acciones que realiza el modelo»?
Funciones que la IA invoca para realizar una acción. Practicas MCP Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar MCP Academy?
No se requiere experiencia previa. MCP Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.
¿Cuánto tiempo toma la lección «Herramientas: acciones que realiza el modelo»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de MCP Academy?
Sí. Cada lección de MCP Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Herramientas: acciones que realiza el modelo
- Recursos: datos que lee el modelo
- Prompts: instrucciones reutilizables
- Elegir la primitiva adecuada