Инструменты: чтение и изменение данных через агента

Менеджер написал агенту: «Найди сделку ООО Ромашка и покажи стадию». Через десять секунд - сумма, ответственный, последний комментарий. Не из головы модели, а из Bitrix24: агент вызвал инструмент, сервер сходил в CRM, вернул данные. Вот ради чего большинство и подключает Bestrank MCP - не «красивые рассуждения», а конкретные действия: найти, открыть, создать, обновить.

В переписке инструменты часто называют «tools» - мы в блоге говорим инструменты: это действие агента в вашей системе. Ресурс - «посмотри справочник», инструмент - «сделай что-то в CRM». Про ресурсы - в Ресурсы: справочники и снимки данных без лишних вызовов. Здесь - только действия.

Что делает инструмент

Когда вы просите агента «найди все просроченные задачи Иванова», клиент не отправляет текст в Bitrix24. Он выбирает подходящий инструмент из списка, разрешённого вашим токеном, передаёт параметры (фильтр, имя, ID) - и Bestrank MCP выполняет запрос к порталу от имени подключения.

Ответ возвращается агенту в структурированном виде. Агент переводит его в нормальный ответ: список, таблица, краткий вывод.

Инструменты группируются по смыслу: задачи, CRM, календарь, чаты, Jira и т.д. Каталог с описаниями для людей - на странице Инструменты MCP. Какие из них включены именно вашему токену - решаете вы на вкладке Возможности (статья про выбор).

Чтение и изменение: два разных уровня риска

Не все инструменты одинаковы. Условно делим на два класса.

Чтение (без изменений в системе)

Агент смотрит, но не трогает:

• список задач с фильтром;
• карточка сделки или контакта;
• история изменений;
• комментарии к задаче;
• участники чата.

Риск для данных минимальный. Ошибка - скорее неверная интерпретация, чем испорченная CRM. На пилоте часто начинают только с чтения плюс один «безопасный» инструмент записи.

Изменение данных

Агент меняет что-то на портале:

• создать задачу или сделку;
• обновить поле;
• добавить комментарий;
• сменить стадию;
• прикрепить файл;
• назначить ответственного.

Здесь последствия реальные: дубликаты, неверная стадия, лишний комментарий клиенту. Поэтому:

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

Подтверждение - не замена здравому списку возможностей. Это страховка, когда инструмент изменения всё же нужен.

Как агент выбирает инструмент

Вы пишете запрос свободным текстом. Агент:

1. Понимает намерение.
2. Смотрит, какие инструменты доступны по токену.
3. При необходимости читает ресурс (например, справочник стадий CRM).
4. Вызывает один или несколько инструментов по цепочке.
5. Формулирует ответ.

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

Подробнее про взаимодействие трёх типов возможностей - Как агент работает с инструментами, ресурсами и промптами.

Примеры: задачи Bitrix24

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

Типичные запросы на чтение:

• «Покажи мои задачи на эту неделю с высоким приоритетом».
• «Что в комментариях к задаче № 12345?»
• «Кто исполнитель и какой дедлайн у задачи по проекту “Запуск сайта”?»

Типичные запросы на изменение:

• «Создай задачу “Согласовать КП” на Петрова, дедлайн пятница».
• «Добавь комментарий: клиент просит перенести созвон».
• «Отметь задачу выполненной» (если такой инструмент включён).

Разбор сценариев по задачам - в статье Задачи Bitrix24 через MCP: список, карточка, комментарии, файлы.

Кейс: ежедневный стендап без ручного опроса

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

Примеры: CRM

Инструменты CRM - сделки, лиды, контакты, компании.

Чтение:

• «Найди сделку “ООО Ромашка” и покажи сумму и стадию».
• «Какие сделки зависли на стадии “Согласование договора” больше двух недель?»
• «История активности по контакту Иванов».

Изменение:

• «Создай сделку из входящего письма, контакт уже есть».
• «Переведи сделку на стадию “Договор отправлен”».
• «Добавь комментарий для менеджера: клиент просит счёт».

Подробнее про воронку и отчёты - CRM через MCP: сделки, контакты, история и отчёты для РОП.

Кейс: разбор входящей заявки

Менеджер копирует текст заявки в чат с агентом. Агент:

1. Читает ресурс со стадиями и обязательными полями воронки.
2. Ищет контакт инструментом CRM.
3. Создаёт или обновляет сделку.
4. Ставит задачу на обработку КП.

Перед созданием сделки клиент может показать подтверждение: «Создать сделку “Заявка с сайта - Ромашка”, сумма 0, стадия “Новая”?» - вы соглашаетесь или правите формулировку.

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

Инструмент в возможностях токена - это разрешение для агента. Но выполнить действие можно только если подключение (вебхук или OAuth) имеет соответствующие права на портале Bitrix24.

Если вебхук создан только на задачи, инструменты CRM в токене будут возвращать ошибку доступа. Сначала согласуйте права на портале, потом отмечайте инструменты.

Когда лучше ресурс, когда инструмент

Нужно	Используйте
Узнать, какие стадии в CRM	Ресурс со справочником
Получить список сделок на стадии X	Инструмент поиска/списка CRM
Прочитать регламент отдела	Ресурс базы знаний
Создать задачу по регламенту	Инструмент задач + ресурс при необходимости

Лишние вызовы инструментов тратят время и иногда упираются в лимиты API. Справочники - через ресурсы, действия - через инструменты.

Типичные ошибки

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

«Находит не те сделки». Неточная формулировка или агент не прочитал ресурс с полями - уточните запрос или добавьте справочник.

«Слишком много инструментов - путается». Сузьте возможности токена до сценария (см. возможности токена).

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

Как изучать каталог

1. Откройте Инструменты MCP, выберите продукт Bitrix24.
2. Пройдитесь по группам: задачи, CRM, календарь - что близко вашим процессам.
3. На вкладке Возможности токена включите минимальный набор.
4. В админке у токена используйте Просмотр у ресурсов и тестовые запросы в клиенте.

Для Jira и других продуктов логика та же: инструмент = действие в системе, набор ограничивается токеном.

Когда этого мало

Инструменты закрывают «сходи в CRM и сделай». Они не заменяют робота на жёстком регламенте «при стадии X всегда Y» - там надёжнее бизнес-процесс Bitrix24. Не заменяют бота на сайте с предсказуемыми кнопками. И не гарантируют идеальный результат с первого запроса: агент может неверно интерпретировать данные, даже если инструмент отработал корректно.

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

Подключение и выбор возможностей - Подключение MCP и Bestrank MCP: доступ по токену. Нужен разбор инструментов под ваш процесс - напишите нам.