Скилл mws-cli учит ИИ-агента взаимодействовать с утилитой MWS CLI, чтобы управлять ресурсами MWS Cloud Platform с использованием естественного языка. Скилл опубликован в открытом репозитории.

Скилл работает на любой ОС с установленной утилитой MWS CLI. В качестве примера приведена установка скилла в npx skills и Claude Code, а также универсальный способ установки для всех агентов.

При использовании скилла агент изучает справку MWS CLI, выполняя команды с флагом --help. В результате агент подбирает нужную команду и ее аргументы, подходящие под поставленную задачу. Агент всегда ориентируется на актуальную справку, поэтому корректно работает даже при обновлении MWS CLI. Затем агент подставляет в эту команду все переданные в запросе параметры.

Перед установкой скилла удостоверьтесь, что на устройстве установлена и настроена утилита MWS CLI.

1. Загрузите и установите скилл:

   • npx skills
   • Claude Code
   • Универсальный способ

   Выполните команду:

   1
   npx skills add https://github.com/mws-cloud-platform/skills --skill mws-cli

   1. Подключите маркетплейс MWS:

      1
      /plugin marketplace add mws-cloud-platform/skills

   2. Установите скилл:

      1
      /plugin install mws-cli@mws-cloud-platform-skills

   1. Установите утилиту git.

   2. Клонируйте репозиторий со скиллами:

      1
      git clone https://github.com/mws-cloud-platform/skills.git

   3. Создайте символическую ссылку на скилл mws-cli в директории скиллов агента:

      1
      ln -s $(pwd)/skills/plugins/mws-cli/skills/mws-cli <путь к директории со скиллами>/mws-cli

2. Перезапустите агента после установки скилла.

3. Для проверки установки скилла попросите агента вывести список установленных скиллов и убедитесь, что mws-cli есть в списке.

4. Для проверки работы скилла задайте агенту задачу, например вывести список виртуальных машин. Проверьте, что агент вызвал скилл mws-cli и выполнил соответствующую команду MWS CLI.

Скилл может быть вызван двумя способами:

• Укажите название скилла прямо в запросе:

  1
  Используя скилл mws-cli, выведи список виртуальных машин

• Опишите задачу без названия скилла — агент сам определит, что нужно использовать mws-cli:

  1
  Останови виртуальную машину vm-hitori

Агент не всегда безошибочно определяет нужный скилл по формулировке задачи. Если агент не вызвал mws-cli, используйте явный вызов.

Скилл позволяет выполнять все возможные операции с ресурсами:

• Получить токен IAM:

  1
  Создай токен IAM

• Получить информацию о ресурсе:

  1
  Выведи информацию о виртуальной машине vm-abcdef

  1
  Выведи сетевую конфигурацию кластера Managed ClickHouse по имени cluster-qwerty

• Получить список ресурсов:

  1
  Какие виртуальные машины созданы в зоне ru-central1-b и сейчас запущены?

  1
  Выведи список неиспользуемых зарезервированных IP-адресов

• Создать ресурс:

  1
  Создай виртуальную машину со следующей конфигурацией:
  2
  
  3
  * Имя: vm-satoko
  4
  * ОС: Ubuntu 24.04 LTS из проекта mws-ubuntu
  5
  * Тип: vmTypes/gen-2-8
  6
  * Сетевой диск: 15 GB, 1000 IOPS, имя - boot
  7
  * Подсеть: network/vm-subnet
  8
  * IP-адреса: временные (внешний и внутренний)
  9
  * SSH-ключ: используй ключ по пути ~/.ssh/id_ed25519.pub

• Изменить ресурс:

  1
  Назначь временные внешние IP-адреса узлам кластера Managed PostgreSQL по имени cluster-rumia

• Удалить ресурс:

  1
  Освободи все неиспользуемые зарезервированные IP-адреса