Выбор подходящего примитива

Вы знаете об инструментах, ресурсах и промптах. Теперь важно научиться выбирать подходящий вариант для каждой функции, которую Вы хотите предоставить. 🧭

Главное различие — это управление. Инструментами управляет модель, ресурсами — приложение, а промптами — пользователь.

Если функция выполняет действие, например отправляет письмо или записывает строку, почти всегда это инструмент. Действие — его отличительный признак.

Если модели нужно только прочитать что-либо — файл, запись или настройку, — используйте ресурс. Никаких побочных эффектов, только контекст.

Если Вам нужен повторяемый способ начать задачу одним нажатием, это промпт. Пользователь запускает его и заполняет несколько входных данных.

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

README Вашего проекта — это статический контекст, который должна видеть система ИИ. Это классический ресурс: приложение подключает его, а модель не запускает.

Повторно используемая команда «суммируйте это», которую пользователь выбирает в меню, — это prompt. Она задаёт шаблон инструкции, поэтому каждое резюме начинается одинаково.

Настоящие серверы объединяют все три компонента: ресурс передаёт контекст, промпт задаёт запрос, а инструмент выполняет получившееся действие.

Не уверены, выбрать инструмент или ресурс? Спросите себя, изменяет ли он что-либо. Если да, это инструмент; если только сообщает информацию — ресурс.

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

Отличная работа! Спросите, кто управляет компонентом и выполняет ли он действие: инструмент — для действий, ресурс — для данных только для чтения, промпт — для сохранённых запросов. ✅