SSH-модуль с ИИ: настройка и использование

· Документация

SSH-модуль с ИИ: настройка и использование

SSH-модуль с ИИ предназначен для выполнения и анализа команд на удалённых серверах напрямую из чата системы.
ИИ использует SSH как инструмент: выполняет команды, анализирует их вывод и принимает решения о следующих шагах.

Модуль применяется для диагностики, устранения проблем и выполнения пошаговых сценариев работы с инфраструктурой.


1. Доступ к SSH-модулю

Перейдите в раздел панели управления:

Инструменты → SSH Manager

1-1.png

Здесь осуществляется управление всеми SSH-креденшелами, которые ИИ использует для подключения к серверам.


2. SSH Manager

В разделе SSH Manager отображается список доступных SSH-креденшелов.

ыыр16fa6c545-d3ba-438a-80e8-17b315d2e1e4.png

Каждый профиль описывает одно SSH-подключение и может быть использован ИИ при выполнении задач.

Доступные действия:

  • Использовать
  • Редактировать
  • Клонировать
  • Удалить

3. Добавление SSH-креденшела

ыы2225e8f875-58b7-4a33-8d14-ed217c41708c.png

SSH-креденшел определяет параметры подключения, которые ИИ применяет при выполнении команд.

Поля формы

Профиль
Человекочитаемое имя подключения для выбора в чате.

SSH пользователь
Пользователь, от имени которого ИИ будет выполнять команды на сервере.

Сервер
IP-адрес или DNS-имя сервера.

Порт
По умолчанию 22.

Тип аутентификации

  • SSH ключ — рекомендуемый вариант
  • Пароль — допустим, но не рекомендуется

Приватный ключ
Поддерживаются id_rsa, id_ed25519, id_ecdsa, id_dsa.

Passphrase (опционально)
Указывается, если ключ зашифрован.


4. Jump-хост (Bastion)

Поле Jump-хост принимает alias SSH-креденшела, созданного ранее в системе.

ИИ использует этот профиль как промежуточный сервер для доступа в закрытые сети.

⚠️ Важно:

  • указывается не IP и не hostname
  • используется alias существующего SSH-креденшела

5. Клонирование SSH-креденшелов

<!-- IMAGE: clone_ssh_credential.png -->

Клонирование позволяет ИИ быстро работать с однотипными серверами.

При клонировании:

  • копируются ключи и пароль
  • параметры подключения можно изменить
  • секреты остаются неизменными, пока пользователь явно не заменит их

6. Использование SSH-модуля в чате

<!-- IMAGE: ssh_quick_selector.png -->

SSH-модуль активируется в основном рабочем чате.

После выбора профиля ИИ получает возможность выполнять команды на соответствующем сервере.


7. Выполнение команд и анализ вывода

<!-- IMAGE: execute_ssh_blocks.png -->

image_2025-12-28_18-46-37.png

ИИ выполняет команды через инструмент execute_ssh.

Каждый шаг содержит:

  • сервер и профиль
  • команду
  • stdout (вывод)

ИИ анализирует вывод команд и использует его для принятия решений о дальнейших действиях.


8. Пошаговое выполнение сценариев

ИИ работает по следующей логике:

  1. Выполняет команду
  2. Анализирует результат
  3. При необходимости выполняет дополнительные команды
  4. Останавливается после достижения цели
  5. Формирует итоговый отчёт

Таким образом реализуется выполнение инфраструктурных сценариев без ручного вмешательства.


9. Пример сценария

<!-- IMAGE: ssh_k8s_workflow.png -->

image_2025-12-28_18-47-32.png

Пример использования:

  • проверка состояния Kubernetes-ноды
  • анализ работы Calico
  • сетевые тесты
  • исправление ошибок конфигурации
  • повторная валидация
  • подтверждение результата

ИИ самостоятельно определяет, какие шаги требуются для завершения задачи. Модуль также поддерживает множественный параллельный вызов инструментов. Например, если нужно развернуть систему на нескольких серверах одновременно

Screenshot_7.png


10. Остановка выполнения

<!-- IMAGE: ssh_stop_button.png -->

Пользователь может в любой момент остановить работу ИИ с помощью кнопки Stop.

После остановки:

  • дальнейшие команды не выполняются
  • автоматическое продолжение сценария отключается

11. Рекомендации по использованию

  • Предоставляйте ИИ минимально необходимый доступ
  • Используйте SSH-ключи
  • Для сложных инфраструктур применяйте jump-хосты
  • Останавливайте выполнение при неожиданном выводе

12. Назначение модуля

SSH-модуль с ИИ предназначен для:

  • анализа состояния серверов
  • устранения инфраструктурных проблем
  • выполнения повторяемых процедур
  • поддержки инженерных задач в диалоге

Модуль используется как управляемый исполнитель, а не как автоматический скрипт.

Открыть чат ExecAI

Ещё в блоге