Devolver mensajes, no solo texto
Dé forma a la salida del prompt como mensajes de chat estructurados.
Devolver mensajes, no solo texto es una lección gratuita de MCP Academy en CoddyKit. Esta es la lección 3 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.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
Beyond a Single String
A prompt can do more than return one line. It can return a list of messages to seed a richer, multi-turn opener. 🗂️
Messages Have Roles
Each message carries a role, usually user or assistant. Roles let you stage a short back-and-forth before the user even types.
The Message Helpers
The SDK gives you UserMessage and AssistantMessage helpers so you can build chat turns without hand-writing the raw structure.
from mcp.server.fastmcp.prompts import base
@mcp.prompt()
def ask() -> list[base.Message]:
return [base.UserMessage("Help me debug.")]Return a List
To send several turns, return a list of these message objects. The host replays them in order as the conversation's start.
return [
base.UserMessage("Explain this error."),
base.AssistantMessage("Sure, paste it in.")
]A Single String Still Works
Returning a plain string is just shorthand: the SDK wraps it as one user message. Lists give you finer control over the setup.
Stage the Assistant
An AssistantMessage can prime the model's persona or remind it of rules, so the conversation begins already on the right track.
Set Up Context
Use opening messages to plant context, like coding standards or a role, that the model should keep in mind throughout the task.
Mix Arguments In
You can still slot arguments into any message in the list. The user's inputs flow into a structured conversation, not just one line.
@mcp.prompt()
def debug(error: str) -> list[base.Message]:
return [base.UserMessage(f"Fix this error:\n{error}")]Order Matters
The list order is the turn order. Lead with context or a system-style note, then the user's request, so the model reads it naturally.
Why Use Messages
Structured messages shape a better starting point than one blob of text, especially for tasks that need setup before the real ask.
Keep It Lean
A couple of well-placed turns beat many. Each extra message costs tokens, so include only what truly improves the result.
Quick Check
Let's pin down the richer return type.
Recap: Message Output
Well done! Prompts can return a list of role-tagged messages built with UserMessage and AssistantMessage to stage a richer opener. ✅
Preguntas frecuentes
¿La lección «Devolver mensajes, no solo texto» es gratis?
Sí — el texto completo de «Devolver mensajes, no solo texto» 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 «Devolver mensajes, no solo texto»?
Dé forma a la salida del prompt como mensajes de chat estructurados. 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 3 de 4.
¿Cuánto tiempo toma la lección «Devolver mensajes, no solo texto»?
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
- Registrar su primer prompt
- Añadir argumentos a un prompt
- Devolver mensajes, no solo texto
- Una plantilla de prompt para revisar código