Files — файлы из Битрикс24 📁
Files — картотека файлов чата: нода даёт агенту инструменты, чтобы скачать присланное в Битрикс24 и прочитать его. Документы (Word, Excel, PDF) разбираются автоматически, картинки агент видит глазами.
Когда использовать
- Клиенты присылают файлы в чат Битрикс24: заявки, бланки, фото изделия.
- Агенту нужно работать с содержимым документа: найти строку, ответить по документу.
- Нужно, чтобы агент сам искал файлы в чате по названию.
Как это работает
- Нода держит кэш файлов чата и отдаёт агенту два инструмента через ноду Tools: «прочитать файл» и «найти файлы».
- Текст документа извлекается на платформе: Word, Excel и PDF превращаются в читаемый текст.
- Картинки: в пределах лимита агент видит их как изображения; слишком большие не отдаются — агент попросит сжать фото или прислать PDF.
Настройки
| Поле | Что это |
|---|---|
| Название | Как нода подписана на канвасе — «Файлы» |
| Webhook Б24 | Входящий вебхук портала с правами disk — через него нода скачивает файлы. Шифруется |
| Кэш текстов, КБ | Сколько текста файлов держать под рукой (2048 по умолчанию) |
| Лимит картинки, КБ | Картинка крупнее лимита агенту не отдаётся (4096 по умолчанию) |
Пример: агент читает документ за 3 шага
- Подключите ноду Files к ноде Tools — инструменты появятся у агента.
- Клиент присылает файл в чат Битрикс24 — файл попадает в картотеку ноды.
- Агент по запросу вызовет «прочитать файл» и ответит по содержимому: найдёт позицию, пересчитает сумму, задаст точный вопрос.
Важно знать
- Нужен вебхук с правами disk. Без него нода не скачает файл — создайте на портале Битрикс24 входящий вебхук с правами на диск.
- Кэш — только тексты. Байты картинок в кэш не складываются: крупное фото скачивается заново при обращении.
- Большим фото нужен лимит. Если клиент присылает снимки в несколько мегабайт, агент попросит сжать или прислать PDF — так модель получает читаемое изображение.
- Снапшот. Нода может отдать списком, что уже в картотеке — удобно для проверки и для других нод.
Связанные ноды
- Tools — куда нода отдаёт свои инструменты
- Channel — откуда в чат приходят файлы
- Transcription — соседняя нода для голосовых сообщений