MCP Academy · Урок

Возврат сообщений, а не только текста

Представьте результат запроса в виде структурированных сообщений чата.

«Возврат сообщений, а не только текста» — бесплатный урок MCP Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения MCP Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс MCP Academy содержит 4 уроков всего.

Части этого урока еще не переведены и отображаются на английском.

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. ✅

Часто задаваемые вопросы

Урок «Возврат сообщений, а не только текста» бесплатный?

Да — полный текст урока «Возврат сообщений, а не только текста» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс MCP Academy, подпишись на CoddyKit PRO. Курс MCP Academy содержит 4 уроков всего.

Чему я научусь в уроке «Возврат сообщений, а не только текста»?

Представьте результат запроса в виде структурированных сообщений чата. Ты практикуешь MCP Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать MCP Academy?

Предыдущий опыт не требуется. MCP Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «Возврат сообщений, а не только текста»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке MCP Academy?

Да. Каждый урок MCP Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к MCP Academy