Объявление параметров с подсказками типов
Используйте подсказки типов Python, чтобы задать схему инструмента.
«Объявление параметров с подсказками типов» — бесплатный урок MCP Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения MCP Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс MCP Academy содержит 4 уроков всего.
Параметры становятся схемой
Каждый аргумент функции инструмента становится частью входной схемы, которой модель должна следовать при вызове инструмента. 🧩
Аннотации типов делают всю работу
FastMCP читает Ваши Python-аннотации типов и создаёт для Вас схему JSON, поэтому Вам редко приходится писать схему вручную.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bstr, int, float, bool
Базовые типы сопоставляются напрямую: str становится строкой, int и float — числом, а bool — логическим значением в схеме.
Без типа всё неоднозначно
Если пропустить аннотацию типа, модель видит лишь произвольное значение без правил, что повышает вероятность неправильных или недопустимых входных данных.
def add(a, b):
return a + bПо умолчанию обязательно
Параметр без значения по умолчанию считается обязательным, поэтому модель всегда должна передавать его при вызове инструмента.
Значения по умолчанию делают параметр необязательным
Задайте параметру значение по умолчанию, и он станет необязательным. Модель может не указывать его, а функция использует запасное значение.
@mcp.tool()
def greet(name: str, formal: bool = False) -> str:
...Списки и словари
Можно также указывать типы коллекций. Аргумент список сопоставляется с массивом JSON, а словарь — с объектом, который может заполнить модель.
def tag(items: list[str]) -> int:
return len(items)Необязательные значения
Используйте Optional, когда аргумент может содержать значение или None. Это сообщает, что модель может намеренно оставить его пустым.
from typing import Optional
def find(q: str, limit: Optional[int] = None):
...Понятно называйте параметры
Модель видит в схеме имя каждого параметра, поэтому city лучше, чем c, а start_date — лучше, чем arg2. Понятные имена помогают выполнять вызовы точнее.
Аннотации обеспечивают проверку
Поскольку аннотации определяют схему, MCP может отклонить вызовы с неправильным типом ещё до запуска Вашего кода и обнаружить ошибки на раннем этапе.
Сохраняйте сигнатуру небольшой
Меньшее количество хорошо типизированных параметров проще правильно заполнить модели, чем длинный список слабо связанных аргументов.
Быстрая проверка
Что делает параметр инструмента необязательным в FastMCP?
Итоги
Ваши аннотации типов создают схему инструмента: базовые типы сопоставляются напрямую, значения по умолчанию делают параметры необязательными, а понятные имена направляют модель. ✅
Изучай Python с ИИ-репетитором — бесплатно
Пиши и запускай код прямо в браузере, получай мгновенную помощь от ИИ-репетитора 24/7 и продолжи учиться на сайте или в приложении.
- Курсы
- 30
- Уроки
- 120
Часто задаваемые вопросы
Урок «Объявление параметров с подсказками типов» бесплатный?
Да — полный текст урока «Объявление параметров с подсказками типов» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс MCP Academy, подпишись на CoddyKit PRO. Курс MCP Academy содержит 4 уроков всего.
Чему я научусь в уроке «Объявление параметров с подсказками типов»?
Используйте подсказки типов Python, чтобы задать схему инструмента. Ты практикуешь MCP Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать MCP Academy?
Предыдущий опыт не требуется. MCP Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.
Сколько времени занимает урок «Объявление параметров с подсказками типов»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке MCP Academy?
Да. Каждый урок MCP Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Грамотное имя и описание инструмента
- Объявление параметров с подсказками типов
- Возврат полезных результатов
- Инструмент-калькулятор от начала до конца