База знаний агента
Как привязать источники
В боковом меню откройте «Агенты», затем выберите нужного агента в списке. Откроется форма настроек агента.
- В форме агента откройте вкладку «Инструменты».
- В блоке «База знаний» нажмите «Настроить».
- Нажмите «Добавить из базы знаний».
- Выберите папку, файл или таблицу.
- Нажмите «Готово», чтобы вернуться к списку выбранных источников.
Если выбрана папка, агент будет видеть все текущие и будущие элементы внутри этой папки.
Создавать и редактировать сами материалы нужно на странице базы знаний. В форме агента вы выбираете источники, а доступ на чтение и изменение задаёте в разделе «Права базы знаний».
У выбранного источника можно открыть родительскую папку или убрать источник из агента. Изменения применяются после нажатия «Сохранить».
Источники, связанные с инструкцией
Материал можно подключить прямо из инструкции агента: нажмите кнопку @ или введите / либо @, выберите в едином каталоге раздел «База знаний», а затем нужный ресурс. Внутри папок можно переходить дальше, а подходящий текстовый файл — создать из этого же раздела.
Выбранный материал появится в инструкции как ссылка и автоматически добавится в источники. В списке источников он помечается «Используется в инструкции». Если убрать такой источник, кабинет отдельно предупредит, что вместе с ним удалит ссылку из текста инструкции.
При замене или удалении источников проверьте также обычный текст инструкции: название старого файла и правила, зависящие от него, могут остаться после удаления ссылки. Например, после замены материалов об оплате во ВКонтакте на материалы для MAX нужно исправить оставшееся указание «используй Payment.md и отправляй ссылку ВКонтакте». Меняйте только связанные с заменой фрагменты. Если настройку выполняет агент через MCP, он может использовать актуальный текст из контекста, а после всех согласованных правок должен один раз перечитать итоговую инструкцию. Простое изменение прав или добавление источника без замены прежних не требует такого перечитывания.
Нажатие на ссылку открывает материал. Здесь можно проверить его содержимое и права агента. Если ресурс удалён, выключен или недоступен, ссылка показывает соответствующее состояние — выберите доступный материал или исправьте доступ перед публикацией.
Подробная последовательность показана в разделе «Материалы базы знаний в инструкции».
Опишите агенту правило записи в таблицу
Права на таблицу не определяют, должен ли агент хранить одну строку на лида или добавлять каждую заявку отдельно. Это бизнес-правило нужно явно записать в инструкции.
Если нужна одна актуальная строка, укажите точный ключ, например lead_id, и потребуйте изменять или создавать запись только по нему. Агент не должен угадывать физический номер строки или переносить его из результата другого поиска. При нескольких совпадениях он должен остановиться без записи и сообщить о дублях.
Если каждая заявка или событие должны сохраняться отдельно, укажите, что новая строка создаётся для каждой новой самостоятельной заявки или события. Уточнение текущей заявки и повторная попытка её записи не должны создавать новую строку. Опишите, как отличать новую заявку от продолжения существующей и по какому ключу находить нужную запись; ID лида недостаточен, если у него может быть несколько заявок. Проверьте новую заявку, её уточнение и повторную обработку на безопасных тестовых данных.
Диагностика
Если агент не использует базу знаний:
- Проверьте, что файл, папка или таблица выбраны в блоке "База знаний".
- Проверьте, активен ли ресурс.
- Если нужен файл внутри папки, убедитесь, что выбрана правильная папка или сам файл.
- Если источник выбран, но агент не может его прочитать или изменить, проверьте права базы знаний.