База знаний агента

Как привязать источники

В боковом меню откройте «Агенты», затем выберите нужного агента в списке. Откроется форма настроек агента.

1. В форме агента откройте вкладку «Инструменты».
2. В блоке «База знаний» нажмите «Настроить».
3. Нажмите «Добавить из базы знаний».
4. Выберите папку, файл или таблицу.
5. Нажмите «Готово», чтобы вернуться к списку выбранных источников.

Если выбрана папка, агент будет видеть все текущие и будущие элементы внутри этой папки.

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

У выбранного источника можно открыть родительскую папку или убрать источник из агента. Изменения применяются после нажатия «Сохранить».

Источники, связанные с инструкцией

Материал можно подключить прямо из инструкции агента: нажмите кнопку @ или введите / либо @, выберите в едином каталоге раздел «База знаний», а затем нужный ресурс. Внутри папок можно переходить дальше, а подходящий текстовый файл — создать из этого же раздела.

Выбранный материал появится в инструкции как ссылка и автоматически добавится в источники. В списке источников он помечается «Используется в инструкции». Если убрать такой источник, кабинет отдельно предупредит, что вместе с ним удалит ссылку из текста инструкции.

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

Подробная последовательность показана в разделе «Материалы базы знаний в инструкции».

Опишите агенту правило записи в таблицу

Права на таблицу не определяют, должен ли агент хранить одну строку на лида или добавлять каждую заявку отдельно. Это бизнес-правило нужно явно записать в инструкции.

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

Если каждая заявка или событие должны сохраняться отдельно, прямо разрешите добавление новой строки при каждом вызове. Проверьте оба сценария на безопасных тестовых данных.

Диагностика

Если агент не использует базу знаний:

1. Проверьте, что файл, папка или таблица выбраны в блоке "База знаний".
2. Проверьте, активен ли ресурс.
3. Если нужен файл внутри папки, убедитесь, что выбрана правильная папка или сам файл.
4. Если источник выбран, но агент не может его прочитать или изменить, проверьте права базы знаний.