Elegir la primitiva adecuada

Ya conoce las herramientas, los recursos y los prompts. Ahora debe aprender a elegir el adecuado para cada funcionalidad que quiera exponer. 🧭

La diferencia más clara es el control. Las herramientas están controladas por el modelo, los recursos por la aplicación y los prompts por el usuario.

Si una funcionalidad hace algo, como enviar correo o escribir una fila, casi siempre es una herramienta. La acción es el rasgo distintivo de una herramienta.

Si el modelo solo necesita leer algo, como un archivo, un registro o una configuración, recurra a un recurso. Sin efectos secundarios, solo contexto.

Si quiere una forma repetible y de un solo clic para iniciar una tarea, se trata de un prompt. El usuario lo activa y completa algunos datos.

Obtener el tiempo actual suele corresponder a una tool, ya que el modelo decide cuándo necesita datos recientes y proporciona una ciudad como argumento.

El README de su proyecto es contexto estático que la IA debería ver. Es un resource de manual, adjuntado por la aplicación y no ejecutado por el modelo.

Un comando reutilizable para resumir algo que el usuario elige en un menú es un prompt. Estructura la instrucción para que todos los resúmenes comiencen de la misma manera.

Los servidores reales combinan los tres elementos: un recurso aporta contexto, un prompt estructura la solicitud y una herramienta ejecuta la acción resultante.

¿No está seguro de si debe usar una herramienta o un recurso? Pregúntese si cambia algo. Si la respuesta es afirmativa, es una tool; si solo informa, es un recurso.

Antes de programar, enumere cada funcionalidad y etiquétela como herramienta, recurso o prompt. Esta rápida asignación mantiene su servidor limpio y predecible.

¡Bien hecho! Pregúntese quién lo controla y si actúa: herramienta para acciones, recurso para datos de solo lectura y prompt para solicitudes guardadas. ✅