MCP Academy · Урок

Регистрация первого запроса

Оформите функцию декоратором, чтобы опубликовать запрос.

Урок 1 из 413 шагов

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

Ваш первый prompt

Пора опубликовать prompt: повторно используемый шаблон, запускаемый пользователем и каждый раз начинающий задачу с тщательно составленным текстом. 💬

Декоратор

Превратите обычную функцию Python в prompt с помощью декоратора @mcp.prompt(), подобно тому как вы отмечали инструменты с помощью @mcp.tool().

@mcp.prompt()
def greet() -> str:
    return "Say hello warmly."

Имя берётся из функции

По умолчанию имя prompt совпадает с именем функции. Клиенты показывают это имя в меню команд со слешем, поэтому делайте его коротким и понятным.

Возвращаемое значение

Самый простой prompt возвращает строку. Этот текст становится начальным сообщением пользователя, которое передаётся модели при выборе prompt.

Добавьте описание

Строка документации функции становится описанием prompt. Она сообщает пользователю назначение prompt до его запуска.

@mcp.prompt()
def greet() -> str:
    """Start a friendly greeting."""
    return "Say hello warmly."

Запускается пользователем, а не автоматически

В отличие от инструментов, prompt запускается только тогда, когда его явно выбирает пользователь. Модель никогда не вызывает prompt самостоятельно.

Он находится на сервере

Ваш prompt регистрируется в том же экземпляре сервера FastMCP, где находятся инструменты и ресурсы. Один сервер, три вида примитивов.

mcp = FastMCP("my-server")

@mcp.prompt()
def greet() -> str:
    return "Say hello warmly."

Клиенты могут его перечислить

После регистрации клиенты вызывают prompts/list, чтобы обнаружить его. Так хост заполняет меню команд со слешем или шаблонов.

Выберите его и получите сообщение

Когда пользователь выбирает prompt, хост получает его и начинает чат с возвращённым вами текстом. Пользователь получает отшлифованное начальное сообщение.

Сохраняйте текст сфокусированным

Хорошее содержимое prompt даёт модели чёткие инструкции, а не перегружает её множеством вариантов. Сформулируйте цель и тон — и остановитесь.

Зачем это нужно

Зарегистрированный prompt избавляет всех от повторного ввода одного и того же запроса и сохраняет единообразные формулировки для всей команды. ✨

Быстрая проверка

Проверим, как регистрируются prompt.

Ответь в интерактивном уроке

Итоги: первый prompt

Отличная работа! Декоратор @mcp.prompt() публикует функцию как шаблон, запускаемый пользователем, а её имя и строка документации отображаются пользователям. ✅

Можно начать бесплатно

Изучай Python с ИИ-репетитором — бесплатно

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

Курсы: 30
Уроки: 120

Начать учиться бесплатно Посмотреть полный курс

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

Урок «Регистрация первого запроса» бесплатный?

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

Чему я научусь в уроке «Регистрация первого запроса»?

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

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

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

Сколько времени занимает урок «Регистрация первого запроса»?

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

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

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

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

← Назад к MCP Academy