Retornar mensagens, não apenas texto
Estruture a saída do prompt como mensagens de conversa estruturadas.
Retornar mensagens, não apenas texto é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 3 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em 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. ✅
Perguntas Frequentes
A aula “Retornar mensagens, não apenas texto” é grátis?
Sim — o texto completo de “Retornar mensagens, não apenas texto” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.
O que vou aprender em “Retornar mensagens, não apenas texto”?
Estruture a saída do prompt como mensagens de conversa estruturadas. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar MCP Academy?
Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 3 de 4.
Quanto tempo leva a aula “Retornar mensagens, não apenas texto”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de MCP Academy?
Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Registrar seu primeiro prompt
- Adicionar argumentos a um prompt
- Retornar mensagens, não apenas texto
- Um modelo de prompt para revisão de código