Просмотр кода страницы SES. Руководство администратора

===== '''Общее описание''' =====
Сервис предназначен для сценарных машин. 
===== '''Термины и определения''' =====
script engine service (SES) – сервис обеспечивающий работу сценарных машин
===== '''Требования к окружению''' =====
В процессе работы сервис взаимодействует со следующими сервисами:

* UPS – настройка осуществляется через файл /opt/ups/config.json

* SMC, SEE, SPR, TTS, SBS, QAS - настройка осуществляется через файл /opt/ses/config.json

===== '''Установка ses''' ===== 

Дистрибутив распространяется в виде установочных пакетов для окружения и сервиса. Загрузите установочные пакеты на сервер и выполните команды для Вашей системы в каталоге с пакетом.

Перед установкой непосредственно сервиса необходимо [[PVE. Установка сервисного пакета окружения|установить сервисный пакет окружения]].

* Установка/обновление ses осуществляется скриптом <code>chmod +x ./ses-<версия>-<релиз>.sh && ./ses-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./ses-<версия>-<релиз>.sh</code> без ключей.
* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/ses/new</nowiki>" --user '[user]:[pass]' 2>&1 | bash</code> или в интерактивном режиме <code>bash -c "$(curl -s <nowiki>https://repo.connect2ai.net/api/ses</nowiki> --user '[user]:[pass]' 2>&1)"</code>.
* Обновить ses <code>/opt/ses/inupdate</code> в интерактивном режиме. Или запустить с ключём:
** <code>/opt/ses/inupdate -b</code> - обновить до последней beta версии;
** <code>/opt/ses/inupdate -r</code> - обновить до последней release версии;
** <code>/opt/ses/inupdate -n</code> - обновить до последней версии (не важно beta или release).
* Проверить актуальную версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/ses/version</nowiki></code>.
* Посмотреть лог изменений <code>curl -s "<nowiki>https://repo.connect2ai.net/api/ses/changelog</nowiki>" --user '[user]:[pass]'</code>.
* Полное описание всех команд API репозитория можно найти по ссылке '''<nowiki>https://repo.connect2ai.net/api</nowiki>'''. <code>[user]:[pass]</code> - это тот же логин и пароль, что и от '''Nextcloud'''.
* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
** echo -n <code>"[user]:[pass]"</code> > /opt/ses/.userapi (это файл авторизации в API, нужен для обновления и загрузки моделей)
** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/ses/.proxy (это файл конфигурации proxy необходим для обновления и загрузки моделей, при отсутсвующем прямом подключение к интернету)

При обновление следующий список файлов и папок сохранияется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

Не забудьте запустить сервис и включить в автозапуск в системе:

<code>sudo systemctl enable ses.service && sudo systemctl start ses.service</code>

Удостоверьтесь, что сервис стартовал:

<code>systemctl status ses.service</code>

Разрешите доступ к портам 6157/tcp, 6170/tcp а также порту, определенном в конфиге (по умолчанию 6189/tcp) на нужном интерфейсе.

==='''Настройка сервиса'''===
===='''Файл config.json'''====
Настройка параметров сервиса ses производится в файле /opt/ses/config.json

Описание параметров приведено в таблице
{| class="wikitable"
|+
!style="width: 20%"|Параметр
!style="width: 20%"|По умолчанию
!style="width: 60%"|Назначение
|-
|port
|6190
|порт api интерфейса, используется в UPS - настройка servers.ses в конфиге UPS
|-
|logs.path
|logs/
|Путь к папке логов
|-
|logs.backups
|10
|Количество старых сохраняемых логов
|-
|logs.maxSize
|5242880
|Максимальный размер текущего лог-файла, в байтах
|-
|servers.{service}.url
|"<nowiki>http://127.0.0.1:PORT/{service}</nowiki>"
|адрес сервера. Возможные варианты значения service (с портами по умолчанию) следующие: smc(6181), see(6184), spr(6183), tts(6186), sbs(6185), qas(6187)
|-
|servers.{service}.timers.connect
|2
|таймаут подключения к серверу
|-
|servers.{service}.timers.read
|10
|таймаут получения данных с сервера
|-
|connectors.vk
|{}
|Параметры подключения к ботам VK
<small>{  "имя_подключения":{</small>

<small>    "token":"Ключ доступа",</small>

<small>    "robot":"id робота",</small>

<small>    "group_id":"id сообщества ВКонтакте",</small>

<small>    "whitelist":[],</small>

<small>    "activators":[]</small>

<small>    },</small>

<small>...............</small>

<small>}</small>
|-
|connectors.telegram
|{}
|Параметры подключения к telegram ботам
<small>{</small><small>  "имя_подключения":{</small>

<small>    "token":"Ключ доступа",</small>

<small>    "robot":"id робота",</small>

<small>    "variables":{</small>

<small>      "phone": "1234567890"</small>

<small>    },</small>

<small>    "timers": {</small><small>      "getUpdates": 3</small><small>    },</small>

<small>    "whitelist":[],</small>

<small>    "activators":[]</small>

<small>    },</small>

<small>...........</small>

<small>}</small>
|-
|tmp
|"/tmp/ses"
|временная папка
|}

===='''Эмуляция сервисов интеграции'''====

В каталоге '''/opt/ses/testapi''' могут располагаться эмуляторы сервисов интеграции.  Эмулятор будет доступен по адресу ''htttp://<адрес ses>/testapi/<название_сервиса>. Для создания эмулятора поместите в папку /opt/ses/testapi/ файл <название_сервиса>.reply. Содержимое файла будет отдано без изменений, как есть по адресу "http://&#x3C;адрес_ses&#x3E;:&#x3C;порт_ses&#x3E;/ses/testapi/&#x3C;название_сервиса>".''



==='''Настройка каналов и виджетов'''===


===='''Настройка виджета для сайта'''====

# '''Размещаете на сайте''', например <nowiki>http://сайт.рф</nowiki> '''ссылку на виджет''' <nowiki><script src="http://адрес_ups/ses/widget/js" key="xxxxxxxx"></script></nowiki> (ключ придумайте сами)
# '''Делаете конфиг''' канала в файле /opt/ses/config.json в разделе connectors.web. В конфиге следующее:
<blockquote><small>"web": {</small> 

<small>"<nowiki>http://сайт.рф~xxxxxxxx"</nowiki>: {</small> #сайт_с_виджетом~ключ

<small>             "robot": "28013d0a-...",</small> # id робота

<small>             "color": "#4d3e33",</small> #акцентный цвет виджета"

<small>             "host": "адрес_ses:6191",</small> #адрес который прослушивает ws(wss) запросы

<small>             "microphone": false,</small> #возможность отправлять/принимать аудио

<small>             "transcription": false,</small> #возможность расшифровки аудио клиента

<small>             "variables": {</small>

<small>                 "var_1": "1234567890"</small>

<small>               } } }</small></blockquote>Если на сайте ssl, то дополнительно поднимаете реверс прокси для ups (<nowiki>http://адрес_ups</nowiki>) и для websocket  (адрес_ses:6191). Особенности реализации на '''nginx''':

'''Основной конфиг''' должен включать директиву <code>proxy_set_header Host $host;</code> а также заголовки CORS и обработку OPTIONS запросов. Дополнительно в нем возможно придется обработать путь "/lang" с переводом.

'''Конфиг для websocket''' должен обеспечивать обработку upgrade запросов(<nowiki>https://nginx.org/en/docs/http/websocket.html</nowiki>) для перенаправления websocket трафика, а также прослушивание отдельного порта, например 8091.

Тогда в ссылку на виджет(<small>адрес_ups</small>) и в конфиг канала(<small>адрес_ses:6191</small>) нужно будет вносить адреса которые поддерживают ssl. Пример конфига nginx для wss: <blockquote><small>server {</small>

<small>   server_name ups_сервер.ru;</small>

<small>   listen 6191 ssl;</small>

<small>  include snippets/ssl-params.conf;</small>

<small>  ssl_certificate /etc/letsencrypt/live/ups_сервер.ru/fullchain.pem;</small>

<small>  ssl_certificate_key /etc/letsencrypt/live/ups_сервер.ru/privkey.pem;</small>

<small>  ssl_trusted_certificate /etc/letsencrypt/live/ups_сервер.ru/chain.pem;</small>

<small>  client_max_body_size 1000M;</small>

<small>  proxy_read_timeout 6000;</small>

<small>  proxy_connect_timeout       6000;</small>

<small>  proxy_send_timeout          6000;</small>

<small>  send_timeout                6000;</small>

<small>  large_client_header_buffers 8 256k;</small>

<small>   location / {</small>

<small>       proxy_pass <nowiki>http://локальныq_адрес_ses:6191</nowiki>;</small>

<small>       proxy_http_version 1.1;</small>

<small>       proxy_set_header Upgrade $http_upgrade;</small>

<small>       proxy_set_header Connection "upgrade";</small>

<small>       proxy_set_header Host $host;</small>

<small>       proxy_cache_bypass $http_upgrade; } }</small></blockquote>

==='''Протоколы и порты'''===

Сервис использует порт 6190/tcp для доступа к api интерфейсу и порт 6191/tcp для websocket сервера. Порты 6190 может быть изменен в конфигурационном файле.

==='''Журналы работы'''===

Для проверки состояния сервиса выполните <code>sudo systemctl status ses</code>. 

Журналы сервиса находятся в каталоге, определенном в конфигурационном файле (по умолчанию - <code>/opt/ses/logs/</code>). Ошибки также пишутся в системный журнал, для просмотра можно воспользоваться командой <code>sudo journalctl -u ses</code>
==='''Удаление и обновление ses'''===
Для удаления выполните команду:

<code>/opt/ses/uninstall</code> 

Команда удалит сервис и рабочий каталог, включая все файлы конфигурации. Для обновления запустите скрипт установки как указано в п 4. При этом, обновление не изменяет файл /opt/ses/config.json.