Как агент работает с инструментами, ресурсами и промптами

У агента с MCP три рычага: инструмент - сделать действие в CRM, ресурс - прочитать справочник, промпт - пройти знакомый маршрут. Не три buzzword из презентации, а три переключателя в карточке токена, которые админ включает осознанно - как права в Bitrix24, только для AI-клиента.

Базовое «что такое MCP» - в Что такое MCP. Отличие агента от бота - в AI-агенты vs чат-бот и скрипт.

Одна задача - три способа помочь

Представьте запрос менеджера: «Подготовь меня к созвону с клиентом из сделки 1842».

Агент может:

1. Вызвать инструмент «получить карточку сделки» - подтянуть сумму, стадию, ответственного.
2. Прочитать ресурс «справочник стадий воронки» - вспомнить, что у нас означает «Демо проведено».
3. Запустить промпт-сценарий «брифинг перед созвоном» - пройти чек-лист: история, риски, что спросить.

Три механизма, одна цель. Разберём по отдельности.

Инструменты: действия в системе

Инструмент - это именованное действие с параметрами. «Найти сделку по ID», «создать задачу», «добавить комментарий в ленту», «получить список контактов компании».

Как это выглядит для агента:

• Модель видит каталог инструментов (тот самый разрешённый список возможностей на токене).
• Решает, какой вызвать, и с какими аргументами.
• Получает ответ от MCP-сервера - JSON с данными или подтверждением действия.
• Формулирует человеку понятный итог.

Инструменты делятся по смыслу на чтение и изменение. Админ часто сначала открывает только чтение: меньше риска, проще привыкнуть.

Подробный разбор с примерами Bitrix24 - в Инструменты: чтение и изменение данных.

Кейс: бухгалтер спрашивает «есть ли счёт по сделке 1842». Агент вызывает инструмент чтения карточки, находит вкладку файлов, отвечает: «Да, счёт от 12 марта, статус сделки - ожидание оплаты».

Ресурсы: контекст без лишних вызовов

Ресурс - это данные, которые агент читает как справочник, часто по URI внутри MCP. Словарь статусов, описание полей смарт-процесса, снимок структуры каталога, выдержка из базы знаний.

Зачем отдельно от инструментов:

• Экономия: не дергать API CRM десять раз за одну и ту же схему полей.
• Стабильность: агент опирается на «как у нас заведено», а не на догадку модели.
• Прозрачность: админ понимает, какие справочники отдал агенту.

Ресурс не «нажимает кнопки» - он даёт фон. Как шпаргалка на столе у стажёра.

Разбор форматов и типовых ресурсов Bestrank - в Ресурсы: справочники и снимки данных.

Кейс: новый менеджер спрашивает «какие обязательные поля при создании лида». Агент читает ресурс со схемой CRM и перечисляет поля по-русски, без путаницы с внутренними кодами.

Промпты: готовые сценарии работы

Промпт в MCP - не «магическая фраза в чат», а зарегистрированный сценарий с названием, описанием и шаблоном шагов. Админ или платформа задаёт: «если пользователь выбрал сценарий “Разбор входящей заявки”, действуй так».

Плюсы:

• Одинаковое качество для повторяющихся задач.
• Меньше сюрпризов, чем при полностью свободном диалоге.
• Можно комбинировать с инструментами внутри сценария.

Базовые сценарии от Bestrank и свои кастомные - в Промпты: готовые сценарии работы агента и Базовые и пользовательские промпты.

Кейс: каждое входящее письмо в поддержку. Менеджер запускает промпт «классификация обращения»: агент читает текст, сверяется со справочником категорий (ресурс), при необходимости создаёт задачу (инструмент), выдаёт черновик ответа.

Как триада работает вместе

Типичная цепочка:

Запрос человека
    → (опционально) промпт задаёт рамку
    → ресурсы дают справочный контекст
    → инструменты получают и меняют данные в CRM
    → модель собирает ответ

Агент не обязан каждый раз использовать всё. Простой вопрос «сколько сделок в работе» - один инструмент списка. Сложный брифинг - промпт + несколько инструментов + ресурс воронки.

Кто решает, что доступно

Не модель и не сотрудник «на глаз», а настройки токена в админке Bestrank MCP:

• какие инструменты включены;
• какие ресурсы отдаются;
• какие промпты видны в клиенте.

Это и есть практический смысл «разрешённого списка возможностей» - без перегруза терминами протокола. Подробнее - Возможности токена: что включать агенту.

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

Ошибки, которые мы видели

Слишком много инструментов сразу. Агент путается в выборе; сотрудники не понимают, что вообще возможно. Лучше десять понятных, чем сорок «на всякий случай».

Нет ресурсов - модель выдумывает стадии. Агент назвал статус, которого нет в вашей воронке. Подключите справочники.

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

Ждут автономии без проверки. Инструменты записи в CRM - с human-in-the-loop: агент готовит, человек подтверждает важное.

Кейс: понедельник РОП - полный цикл

РОП запускает промпт «утренняя сводка продаж».

1. Промпт задаёт структуру ответа: просрочки, сделки без активности, новые лиды.
2. Ресурс «воронка Q2» напоминает названия стадий - отчёт на языке команды.
3. Инструменты выгружают списки сделок и задач из Bitrix24.
4. РОП получает текст и таблицу; спорные строки проверяет в портале.

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

Кейс: админ и «что агент умеет»

Админ портала открывает карточку токена и видит три блока: инструменты, ресурсы, промпты. Галочки - как права в CRM, только для агента. Новому сотруднику выдали ключ - он в Claude видит ровно то, что отметили. Не «весь Bitrix24», а согласованный набор.

Это снимает страх «нейросеть снесёт портал» - снесёт максимум то, что явно разрешили.

Клиент и сервер: где что живёт

AI-клиент (Cursor, Claude) показывает промпты и передаёт вызовы инструментов на сервер.

Bestrank MCP выполняет вызовы в Bitrix24, собирает ресурсы, хранит пользовательские сценарии.

Bitrix24 остаётся источником правды по данным.

Вы настраиваете связку один раз; менеджеры работают в привычном чате клиента.

С чего начать настройку

1. Инструменты - выберите 3 - 5 частых операций: найти сделку, список задач, комментарий (если нужен).
2. Ресурсы - подключите воронку и обязательные поля; снимите типовые «галлюцинации» про статусы.
3. Промпты - оформите один повторяющийся процесс (сводка, разбор письма, онбординг).

Расширяйте по обратной связи от команды, а не по каталогу «всё включить».

Куда дальше

Триада настроена - пора углубиться по частям:

• Инструменты: чтение и изменение данных - что агент делает в CRM и задачах;
• Ресурсы: справочники и снимки - как убрать «галлюцинации» про стадии и поля;
• Промпты: готовые сценарии - повторяемые процессы без заново придуманной формулировки;
• Возможности токена - как собрать набор под роль.

Инструменты, ресурсы и промпты - три роли помощника: сделать, подсказать контекст, вести по маршруту. Подключение клиента - Подключение MCP. Нужна помощь с первым сценарием - напишите, пройдёмся по вашей воронке.