Родители детей с диабетом знают, как сложно убедить ребенка постоянно следить за уровнем глюкозы. Поэтому любой дополнительный интерфейс "лишним" не будет: виджет на телефоне, смарт-часы, уведомления в мобильном приложении.
Сервис Nightscout, представляющий собой веб-приложение с базой данных об уровне глюкозы и событиях терапии, позволяет обращаться к себе по API с запросом информации. А всем известная голосовая помощница и колонка с ней - позволяет разрабатывать для себя индивидуальные варианты диалогов "запрос" - "ответ".
Например, "скажи, какой уровень глюкозы у ... ?". а в ответ: "уровень такой-то, снижение/рост на столько-то, за последние Х минут снижение/рост умеренный/сильный на Y ммоль на литр." (немного легкой аналитики и выводов).
Итак, по шагам.
Заводим аккаунт в Яндекс.Cloud и создаем Virtual Private Cloud (своё личное облако). Это бесплатно в "минимальной комплектации" и при умеренном потреблении ресурсов (как и всё остальное, перечисленное ниже). Выполните шаги из раздела "Перед началом работы" и "Создайте облачную сеть" из инструкции по ссылке https://cloud.yandex.ru/docs/vpc/quickstart?from=int-console-help-center-or-nav
Теперь у вас есть облако и каталог в нём, где можно создавать функции (программы, которые можно запускать по команде).
Создаем функцию в облаке. В ней будет программный код, который Алиса запустит по команде и получит от него результат, который сообщит голосом.
В консоли управления перейдите в каталог. Выберите сервис Cloud Functions. Нажмите кнопку Создать функцию. Введите имя функции — get-glucose-from-nightscout (имя не имеет значения, введите любое понятное). Нажмите кнопку Создать. Система предложит выбор языка программирования и его версии, выбираем Python 3.7, галку "Добавить файлы с примерами кода" оставляем на месте.
В появившемся интерфейсе функции есть разделы: обзор, редактор, тестирование. Сейчас мы находимся в редакторе. Он состоит из трех областей: список файлов в левой части, открытые файлы справа (пока один - index.py) и параметры функции внизу.
В области справа открыт файл index.py, удаляем всё из него и вставляем туда код, указывая в нем свои апи-секрет Найтскаута и свой адрес сайта (домен):
import requests
import datetime
NS_API_SECRET = 'апи-секрет найтскаута'
NS_DOMAIN = r'сайт.доменнаязона' # без https://
# главная функция - она же указана в параметрах как точка входа
def handler(event, context):
# запрашиваем последние 6 показаний из Найтскаута (~30 минут для примера)
a = requests.get(fr'https://{NS_API_SECRET}@{NS_DOMAIN}/api/v1/entries.json?count=6').json()
# вычисляем количество минут между первым и последним показанием
minutes = int((a[0]['date'] - a[len(a)-1]['date'])/(1000*60))
# вычисляем разницу в ммоль между первым и последним уровнем ГК
delta_big = round((a[0]['sgv'] - a[len(a)-1]['sgv'])/18, 1)
# начало части сообщения - о динамике за последние 6 периодов
delta_big_txt = '. Последние ' + str(minutes) + ' минут'
# детали динамики за последние 6 периодов в зависимости от величины отклонения
if 0.5 >= delta_big > 0 or -0.5 <= delta_big < 0:
delta_big_txt += ' изменение небольшое, в пределах 0,5 миллимоль'
elif 0.5 < delta_big <= 2:
delta_big_txt += ' рост умеренный - ' + str(abs(delta_big)).replace('.', ',')
+ ' миллимоль'
elif -0.5 > delta_big >= -2:
delta_big_txt += ' снижение умеренное - '
+ str(abs(delta_big)).replace('.', ',') + ' миллимоль'
elif delta_big > 2:
delta_big_txt += ' сильный рост на '
+ str(abs(delta_big)).replace('.', ',') + ' миллимоль'
elif delta_big < -2:
delta_big_txt += ' сильное снижение на '
+ str(abs(delta_big)).replace('.', ',') + ' миллимоль'
elif delta_big == 0:
delta_big_txt += ' нулевое изменение.'
else:
delta_big_txt += ' не смог определить отклонение.'
current_level = 0
delta = 0
# перебираем все 6 сообщений до первой встречи с сообщением "с уровнем"
for i in a:
if 'type' in i and i['type'] == 'sgv':
current_level = i['sgv']/18
delta = i['delta']/18
break
# готовим текст с текущим уровнем и величиной отклонения от предыдущего сообщения
if delta < 0:
delta_text = ' снижение на ' + str(round(abs(delta), 2)).replace('.', ',')
+ ' миллимоль за последние 5 минут'
elif delta > 0:
delta_text = ' повышение на ' + str(round(abs(delta), 2)).replace('.', ',')
+ ' миллимоль за последние 5 минут'
else:
delta_text = ' за последние 5 минут не менялся.'
# возвращаем результат в формате, съедобном для Алисы
# всё, что она произнесет - указано после ключа 'text'
return {
'version': event['version'],
'session': event['session'],
'response': {
# тут всё, что Алиса в итоге произнесет
'text': 'Уровень ' + str(round(current_level, 1)).replace('.', ',')
+ ' миллимоль.' + delta_text + delta_big_txt,
# true - завершить сессию после возврата ответа, Алиса освободится
'end_session': 'true'
},
}
Нажимаем Создать файл и называем его requirements.txt
Добавляем в файл две строки - requests и datetime
Нажимаем в правом верхнем углу Создать версию и переходим в раздел Тестирование.
В разделе Тестирование выбираем шаблон данных Навык Алисы и нажимаем кнопку "Запустить тест". Прокручиваем результат теста вниз и видим возле ключа text результат:
Теперь идем в Яндекс.Диалоги (dialogs.yandex.ru). Нажимаем Создать диалог, вариант диалога - Навык Алисы. В настройках указываем имя навыка (оно будет частью ключевой фразы, я выбрал "уровень глюкозы"). Параметр "Backend" переключаем в "Функция в Яндекс Облаке", из выпадающего списка выбираем вышесозданную функцию. Выбираем голос. Тип доступа - приватный. Дальше ввести формулу команды, имя разработчика, выбрать категорию, краткое описание и установить иконку. Это всё, чего будет достаточно для "публикации" навыка (в приватном режиме).
Выбрать в качестве иконки любую картинку, нажать Сохранить внизу и нажать справа вверху "Опубликовать". Навык перейдет в стадию "опубликован".
После этого можно запустить Алису на своем мобильном телефоне или если есть Яндекс.Станция - сказать ей: Алиса, скажи уровень глюкозы у ...
В ответ будет произнесена фраза, которую сформировал код функции.
Дальше я буду попробовать реализовать голосовой ввод данных о терапии и съеденных углеводах в Nightscout, и включать Яндекс.Лампочку в качестве сигнализации о высоком или низком уровне глюкозы (и тенденции) в спальне.