| name | files |
| description | Работа с файлами: поиск, чтение, запись, копирование, PDF, отправка |
| tools | ["file_search","file_read","file_list","file_write","file_delete","file_open","file_send","file_pdf","file_copy"] |
| trigger_keywords | ["файл","файлы","папка","папки","директория","каталог","найди файл","прочитай файл","открой файл","создай файл","скопируй","удали файл","покажи файлы","что на рабочем столе","рабочий стол","desktop","документы","pdf","отправь файл","скачай","удали","очисти","напиши в файл","запиши"] |
Работа с файлами
У тебя есть 9 инструментов для работы с файлами на компьютере владельца:
Инструменты
file_search
Поиск файлов и папок по имени/паттерну. Рекурсивный поиск.
query — имя файла или паттерн (например "*.py", "report")
path — где искать (по умолчанию домашняя директория)
max_results — лимит результатов (по умолчанию 20)
file_read
Чтение текстового файла. UTF-8 с fallback на Latin-1.
path — полный путь к файлу
max_lines — лимит строк (по умолчанию 200)
file_list
Листинг содержимого папки (ls/dir).
path — путь к директории
show_hidden — показывать скрытые файлы (по умолчанию false)
file_write
Создание или запись в файл.
path — путь к файлу
content — содержимое
mode — "write" (перезаписать) или "append" (дописать)
file_delete
Удаление файла. ТОЛЬКО когда пользователь ЯВНО просит удалить.
path — путь к файлу
confirm — должно быть true
file_open
Открыть файл в системном приложении (как двойной клик).
file_send
Отправить файл в Telegram.
file_pdf
Чтение PDF-файлов (извлекает текст).
path — путь к PDF
max_pages — лимит страниц (по умолчанию 50)
file_copy
Копирование файла.
source — откуда
destination — куда
Правила
- Безопасность: НИКОГДА не удаляй файлы без явной просьбы пользователя
- Пути: разрешён доступ только к домашней директории пользователя и вложенным папкам
- Запрещённые файлы: НЕ читай и НЕ показывай
.env, credentials, файлы с токенами/паролями
- Удаление: используй file_delete ТОЛЬКО когда пользователь напрямую сказал "удали"
- Большие файлы: если файл больше 200 строк, покажи первые строки и спроси — показать полностью?
- Навигация: если пользователь говорит "рабочий стол" → домашняя директория +
/Desktop
- PDF: для PDF файлов используй file_pdf, не file_read
- Отправка: если просят "скинь", "отправь", "пришли" файл → file_send