SFTP (SSH File Transfer Protocol) — это безопасный сетевой протокол, который позволяет загружать, скачивать и управлять файлами на удалённых серверах. SFTP работает поверх SSH, что делает его идеальным для автоматизированных, зашифрованных передач файлов и удалённого управления файлами в современных рабочих процессах.
С инструментами SFTP, интегрированными в AACFlow, вы можете легко автоматизировать перемещение файлов между вашими AI-агентами и внешними системами или серверами. Это позволяет вашим агентам управлять критически важными обменами данными, резервным копированием, генерацией документов и оркестрацией удалённых систем — всё с надёжной безопасностью.
Ключевая функциональность, доступная через инструменты SFTP:
- Загрузка файлов: Бесшовная передача файлов любого типа из вашего рабочего процесса на удалённый сервер с поддержкой как парольной, так и аутентификации по SSH-приватному ключу.
- Скачивание файлов: Получение файлов с удалённых SFTP-серверов напрямую для обработки, архивирования или дальнейшей автоматизации.
- Список и управление файлами: Перечисление содержимого директорий, удаление или создание файлов и папок, удалённое управление правами доступа к файловой системе.
- Гибкая аутентификация: Подключение с использованием традиционных паролей или SSH-ключей с поддержкой парольных фраз и контроля прав доступа.
- Поддержка больших файлов: Программное управление загрузкой и скачиванием больших файлов со встроенными ограничениями размера для безопасности.
Интегрируя SFTP в AACFlow, вы можете автоматизировать безопасные файловые операции как часть любого рабочего процесса, будь то сбор данных, отчётность, обслуживание удалённых систем или динамический обмен контентом между платформами.
В разделах ниже описаны ключевые инструменты SFTP, доступные в системе:
- sftp_upload: Загрузить один или несколько файлов на удалённый сервер.
- sftp_download: Скачать файлы с удалённого сервера в ваш рабочий процесс.
- sftp_list: Показать содержимое директории на удалённом SFTP-сервере.
- sftp_delete: Удалить файлы или директории с удалённого сервера.
- sftp_create: Создать новые файлы на удалённом SFTP-сервере.
- sftp_mkdir: Создать новые директории удалённо.
См. документацию по инструментам ниже для получения подробной информации о входных и выходных параметрах для каждой операции.
Инструкции по использованию
Загружайте, скачивайте, просматривайте и управляйте файлами на удалённых серверах через SFTP. Поддерживает как парольную, так и аутентификацию по приватному ключу для безопасной передачи файлов.
Инструменты
sftp_upload
Загрузить файлы на удалённый SFTP-сервер
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
host | string | Да | Имя хоста или IP-адрес SFTP-сервера |
port | number | Да | Порт SFTP-сервера (по умолчанию: 22) |
username | string | Да | Имя пользователя SFTP |
password | string | Нет | Пароль для аутентификации (если не используется приватный ключ) |
privateKey | string | Нет | Приватный ключ для аутентификации (формат OpenSSH) |
passphrase | string | Нет | Парольная фраза для зашифрованного приватного ключа |
remotePath | string | Да | Целевая директория на удалённом сервере |
files | file[] | Нет | Файлы для загрузки |
fileContent | string | Нет | Прямое содержимое файла для загрузки (для текстовых файлов) |
fileName | string | Нет | Имя файла при использовании прямого содержимого |
overwrite | boolean | Нет | Перезаписывать существующие файлы (по умолчанию: true) |
permissions | string | Нет | Права доступа к файлу (например, 0644) |
Выходные параметры
| Параметр | Тип | Описание |
|---|---|---|
success | boolean | Успешна ли загрузка |
uploadedFiles | json | Массив с деталями загруженных файлов (имя, remotePath, размер) |
message | string | Сообщение о статусе операции |
sftp_download
Скачать файл с удалённого SFTP-сервера
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
host | string | Да | Имя хоста или IP-адрес SFTP-сервера |
port | number | Да | Порт SFTP-сервера (по умолчанию: 22) |
username | string | Да | Имя пользователя SFTP |
password | string | Нет | Пароль для аутентификации (если не используется приватный ключ) |
privateKey | string | Нет | Приватный ключ для аутентификации (формат OpenSSH) |
passphrase | string | Нет | Парольная фраза для зашифрованного приватного ключа |
remotePath | string | Да | Путь к файлу на удалённом сервере |
encoding | string | Нет | Кодировка вывода: utf-8 для текста, base64 для бинарных данных (по умолчанию: utf-8) |
Выходные параметры
| Параметр | Тип | Описание |
|---|---|---|
success | boolean | Успешно ли скачивание |
file | file | Скачанный файл, сохранённый в файлах выполнения |
fileName | string | Имя скачанного файла |
content | string | Содержимое файла (текст или закодированное в base64) |
size | number | Размер файла в байтах |
encoding | string | Кодировка содержимого (utf-8 или base64) |
message | string | Сообщение о статусе операции |
sftp_list
Показать файлы и директории на удалённом SFTP-сервере
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
host | string | Да | Имя хоста или IP-адрес SFTP-сервера |
port | number | Да | Порт SFTP-сервера (по умолчанию: 22) |
username | string | Да | Имя пользователя SFTP |
password | string | Нет | Пароль для аутентификации (если не используется приватный ключ) |
privateKey | string | Нет | Приватный ключ для аутентификации (формат OpenSSH) |
passphrase | string | Нет | Парольная фраза для зашифрованного приватного ключа |
remotePath | string | Да | Путь к директории на удалённом сервере |
detailed | boolean | Нет | Включать подробную информацию о файлах (размер, права доступа, дата изменения) |
Выходные параметры
| Параметр | Тип | Описание |
|---|---|---|
success | boolean | Успешна ли операция |
path | string | Путь к директории, которая была перечислена |
entries | json | Массив записей директории с именем, типом, размером, правами доступа, modifiedAt |
count | number | Количество записей в директории |
message | string | Сообщение о статусе операции |
sftp_delete
Удалить файл или директорию на удалённом SFTP-сервере
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
host | string | Да | Имя хоста или IP-адрес SFTP-сервера |
port | number | Да | Порт SFTP-сервера (по умолчанию: 22) |
username | string | Да | Имя пользователя SFTP |
password | string | Нет | Пароль для аутентификации (если не используется приватный ключ) |
privateKey | string | Нет | Приватный ключ для аутентификации (формат OpenSSH) |
passphrase | string | Нет | Парольная фраза для зашифрованного приватного ключа |
remotePath | string | Да | Путь к файлу или директории для удаления |
recursive | boolean | Нет | Удалять директории рекурсивно |
Выходные параметры
| Параметр | Тип | Описание |
|---|---|---|
success | boolean | Успешно ли удаление |
deletedPath | string | Путь, который был удалён |
message | string | Сообщение о статусе операции |
sftp_mkdir
Создать директорию на удалённом SFTP-сервере
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
host | string | Да | Имя хоста или IP-адрес SFTP-сервера |
port | number | Да | Порт SFTP-сервера (по умолчанию: 22) |
username | string | Да | Имя пользователя SFTP |
password | string | Нет | Пароль для аутентификации (если не используется приватный ключ) |
privateKey | string | Нет | Приватный ключ для аутентификации (формат OpenSSH) |
passphrase | string | Нет | Парольная фраза для зашифрованного приватного ключа |
remotePath | string | Да | Путь для новой директории |
recursive | boolean | Нет | Создавать родительские директории, если они не существуют |
Выходные параметры
| Параметр | Тип | Описание |
|---|---|---|
success | boolean | Успешно ли создание директории |
createdPath | string | Путь созданной директории |
message | string | Сообщение о статусе операции |