Как создать свой первый навык Amazon Alexa

Наконец, мы должны добавить GetFactIntentHandler к другим обработчикам запросов. Мы можем просто сделать это, добавив его в функцию addRequestHandlers . Не забудьте сохранить и построить намерение!

Теперь, когда навык был сохранен и построен, давайте кратко проверим ответ. Если мы просим умение рассказать факт, он должен ответить «Я расскажу факт!»

Если все правильно, вы можете перейти к следующему шагу.

Шаг 5: API запросов для получения фактов Cat

В качестве последнего шага мы хотим запросить простой API, который возвращает факты о кошках. Для этого я использую следующую конечную точку API: https://catfact.ninja/fact .

Эта конечная точка API возвращает факт и его длину.

 { "fact": "Smuggling a cat out of ancient Egypt was punishable by death. Phoenician traders eventually succeeded in smuggling felines, which they sold to rich people in Athens and other important cities.", "length": 192 } 

Поскольку пакет https встроен для Node.js, мы можем использовать его в нашем коде для извлечения данных из API. Вот как мы это делаем:

Фактический код можно найти здесь:

 const https = require('https'); const httpGet = () => { return new Promise(((resolve, reject) => { var options = { host: 'catfact.ninja', port: 443, path: '/fact', method: 'GET', }; const request = https.request(options, (response) => { response.setEncoding('utf8'); let returnData = ''; response.on('data', (chunk) => { returnData += chunk; }); response.on('end', () => { resolve(JSON.parse(returnData)); }); response.on('error', (error) => { reject(error); }); }); request.end(); })); } 

Теперь у нас есть подготовленный вспомогательный метод, мы можем добавить его в GetFactIntentHandler . Обратите внимание, что, поскольку мы хотим использовать await для запроса, нам пришлось сделать функцию handle async . Кроме того, мы вызываем функцию httpGet чтобы получить ответ факта cat, и присваиваем response.fact переменной speakOutput . Затем переменная speakOutput передается команде speak, которая используется Alexa:

 const GetFactIntentHandler = { canHandle(handlerInput) { return Alexa.getRequestType(handlerInput.requestEnvelope) === 'IntentRequest' && Alexa.getIntentName(handlerInput.requestEnvelope) === 'GetFactIntent'; }, async handle(handlerInput) { // const speakOutput = 'I will tell a fact!'; const response = await httpGet(); const speakOutput = response.fact; return handlerInput.responseBuilder .speak(speakOutput) //.reprompt('add a reprompt if you want to keep the session open for the user to respond') .getResponse(); } }; 

Мы готовы с изменениями кода. Сохраните код еще раз и затем нажмите кнопку развертывания.

Шаг 6: финальное тестирование навыков

В качестве последнего шага давайте проверим, получает ли навык случайные факты о кошках из API. Опять же, давайте перейдем на вкладку теста .

Начните навык, называя факт открытой кошки . Далее вы можете попросить рассказать факт . Если все идет хорошо, вы должны получить факт в качестве ответа.

Успех!

Шаг 7 (необязательно): тест на реальном устройстве Alexa

Чтобы протестировать свой собственный навык на устройстве с поддержкой Alexa, необходимо зарегистрировать устройство Alexa под тем же адресом электронной почты, что и учетная запись разработчика Amazon.

Более подробную информацию можно найти в документации Alexa :

Чтобы протестировать устройство с поддержкой Alexa (например, Amazon Echo), зарегистрируйте устройство с тем же адресом электронной почты, который использовался для регистрации учетной записи разработчика на портале разработчиков Amazon. Затем вы можете применить свой навык с помощью слова «пробуждение» и имени вашего вызова: «Alexa, open «.

Если ваше устройство настроено на использование учетной записи, отличной от вашей учетной записи разработчика, перезагрузите устройство, а затем повторно зарегистрируйте его в своей учетной записи разработчика.

Понимание основ

Это только начало построения навыков с Alexa. Возможны гораздо более сложные примеры, такие как передача параметров (опций) с намерениями. Кроме того, могут быть разработаны многие другие типы навыков, например, навыки управления устройствами «умного дома».

Если вы хотите узнать больше о разработке Alexa Skill, поищите эти ресурсы:

• Создайте навык от начала до конца — Amazon Alexa Docs
• Пример скилла Node.js от Алекса
• Руководство по дизайну голоса