Обнаружение инструментов и ресурсов

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

Вызовите session.list_tools(), и сервер вернёт все доступные ему инструменты, чтобы Ваш код мог их изучить.

Результат содержит список tools. Каждая запись включает название и понятное человеку описание, объясняющее назначение инструмента.

Каждый инструмент также предоставляет inputSchema — схему JSON Schema, описывающую принимаемые аргументы. Так Вы узнаёте, какие данные нужно передать.

Серверы могут также предоставлять данные только для чтения. Вызовите session.list_resources(), чтобы получить набор доступных для чтения ресурсов.

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

Третий примитив — подсказки. session.list_prompts() показывает повторно используемые шаблоны инструкций, опубликованные сервером.

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

Обнаружение означает, что клиент адаптируется во время выполнения. Подключите новый сервер — и его инструменты просто появятся, без изменений в коде клиента.

Обнаруженные названия инструментов, описания и схемы — это именно то, что нужно модели, чтобы позже выбрать подходящий инструмент для запроса.

Списки инструментов могут изменяться, поэтому предусмотрительный клиент после уведомления об обновлении может re-list, а не доверять устаревшему снимку.

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