Ресурсы: справочники и снимки данных без лишних вызовов

Почему агент называет стадию «Согласование договора», которой нет в вашей воронке? Почему предлагает поле «Источник», которое вы отключили полгода назад? Часто потому, что ему выдали инструменты CRM, но не ресурсы - справочники и снимки того, как у вас на самом деле устроен портал.

В офисе это как раздать новому сотруднику не только логин в CRM, но и папку с регламентами и табличкой стадий. Инструменты - «иди в систему и сделай». Ресурсы - «сначала прочитай, как у нас принято, потом делай». В переписке разработчиков это «resources»; мы говорим ресурсы - готовый текст или структура, которую агент читает одним обращением.

Ресурс и инструмент: в чём разница

	Ресурс	Инструмент
Суть	Справочник, снимок, инструкция	Действие в системе
Пример	Список стадий воронки, шаблон полей сделки	Найти сделку, создать задачу
Меняет данные на портале?	Нет	Может да
Когда обновляется	При публикации/сканировании в админке	При каждом вызове (актуальные данные)

Агент часто работает в связке: прочитал ресурс со стадиями → вызвал инструмент поиска сделок на нужной стадии → вызвал инструмент обновления. Без ресурса первый шаг превращается в угадайку или лишние вызовы API.

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

Откуда берутся ресурсы в BestrankMCP

Источники двух типов.

Встроенные и платформенные ресурсы

Часть ресурсов поставляется с BestrankMCP: гайды по использованию инструментов, общие справочники продукта. Они одинаковы для всех инстансов и помогают агенту понять, как правильно вызывать инструменты вашего токена.

Данные вашего портала (Bitrix24)

На вкладке Данные портала у токена вы одобряете, что подтянуть с портала:

• Словари полей CRM - какие поля у лида, сделки, контактов, типы и обязательность;
• Базы знаний - статьи и разделы, которые агент может цитировать при ответах;
• Шаблоны бизнес-процессов - как у вас устроены типовые процессы.

После одобрения и сканирования каждый элемент становится ресурсом токена. Агент читает его по URI - как главу документа, а не как живую карточку клиента.

Разбор вкладки Данные портала - Данные портала: словари, база знаний и бизнес-процессы в одном месте.

Зачем ресурсы, если есть инструменты чтения

Казалось бы: есть инструмент «получить сделку» - зачем отдельный ресурс со стадиями?

Экономия вызовов. Справочник стадий меняется редко. Нет смысла каждый диалог заново спрашивать портал «какие у вас стадии». Ресурс - один снимок в контексте.

Меньше шума в ответе. API отдаёт много технических полей. Ресурс в админке можно просмотреть - вы видите ровно то, что уйдёт агенту, без сюрпризов.

Стабильность формулировок. Агент ссылается на те же названия стадий, что в вашей инструкции для людей. Меньше «Новая заявка» vs «New» vs «Новая».

Контекст для промптов. Промпт «разбор заявки» часто предполагает: агент уже знает воронку. Ресурс подкладывает эту базу автоматически, когда промпт или запрос это требуют.

Когда использовать ресурс, когда инструмент

Используйте ресурс, когда:

• нужна структура или правила (поля, стадии, регламент);
• данные меняются редко;
• один и тот же справочник нужен в многих диалогах;
• хотите ограничить, что агент знает о портале (только одобренные БЗ, не весь портал).

Используйте инструмент, когда:

• нужны актуальные сущности (список сделок сегодня, открытые задачи);
• выполняется действие (создать, обновить, комментировать);
• данные уникальны для запроса и не ложатся в справочник.

Кейс: подготовка КП

1. Агент читает ресурс с обязательными полями сделки и чек-листом из базы знаний.
2. Инструментом CRM открывает карточку клиента.
3. Инструментом задач создаёт подзадачи на юриста и бухгалтера.

Без шага 1 агент может создать сделку без нужного поля «Источник» - и БП на портале не запустится.

Как настроить ресурсы на токене

1. Создайте токен и выберите подключение к Bitrix24 (пошагово).
2. На Данных портала отметьте словари, статьи БЗ, шаблоны БП - только нужное.
3. На вкладке Возможности включите соответствующие ресурсы (и системные гайды, если полезны).
4. Сохраните токен. В режиме Изменить откройте Просмотр у ресурса - проверьте содержимое глазами.

Если просмотр пустой - не прошла проверка подключения или не завершилось сканирование портала. Кнопка Проверить на подключении обязательна.

Какие ресурсы вообще попадают в токен - часть разрешённого списка возможностей. Не одобрили на Данных портала - не появится в каталоге. Одобрили, но не отметили в Возможностях - агент не увидит.

Кейс 1: поддержка и база знаний

Служба поддержки подключает MCP для черновиков ответов.

Ресурсы:

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

Инструменты:

• чтение задачи и комментариев;
• добавление комментария (с подтверждением).

Агент не лезет во всю БЗ портала - только в одобренные статьи. Руководитель поддержки раз в месяц обновляет одобренный список после ревизии статей.

Кейс 2: CRM и воронка продаж

Отдел продаж, десять стадий, кастомные поля «Отрасль» и «Тип оплаты».

Ресурсы:

• словарь полей сделки;
• снимок стадий воронки с пояснениями (из Данных портала).

Инструменты:

• поиск и создание сделок;
• смена стадии.

Менеджер спрашивает: «На какой стадии зависли сделки по отрасли “Строительство”?» Агент знает ID и названия стадий из ресурса, фильтрует инструментом CRM - без путаницы в названиях.

Кейс 3: внедренец и бизнес-процессы

Внедренец документирует БП для агентов операторов.

На Данных портала одобрен шаблон БП «Согласование договора». Ресурс описывает шаги и точки, где нужны задачи. Операторы с MCP создают задачи по шаблону, не открывая каждый раз схему в дизайнере БП.

Когда процесс на портале меняется - повторное сканирование и просмотр ресурса в админке. Агент не подхватит новую версию сам, пока администратор не обновит снимок.

Ресурсы и объём контекста

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

Практика:

• одобряйте разделы, а не «всю БЗ»;
• для длинных статей - один ресурс на типовой сценарий;
• лишние словари полей не включайте «на всякий случай».

Лучше три точных ресурса, чем один гигантский «всё о портале».

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

«Агент выдумывает стадии». Нет ресурса воронки - модель достраивает типовую схему. Добавьте словарь стадий.

«Ресурс есть, агент не читает». Не включён в Возможностях или запрос не требует справочника - уточните промпт или добавьте playbook.

«В просмотре старые поля». После изменения CRM на портале нужно обновить Данные портала и пересканировать.

«Путает ресурс и живые данные». Объясните в запросе: «сначала посмотри регламент, потом найди задачу № …» - или используйте готовый промпт.

Связь с остальной документацией

• Общая схема токена - BestrankMCP: что это и как устроен доступ по токену.
• Выбор возможностей - Возможности токена.
• Действия в CRM и задачах - Инструменты MCP и статья про инструменты.
• Как агент комбинирует типы - Как агент работает с инструментами, ресурсами и промптами.

На практике

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

Первое подключение - Подключение MCP. Действия в CRM - Инструменты. Вопросы по конкретным справочникам - напишите нам.