الإجراءات على Google: كتابة تطبيق بسيط لمساعد Google على Dialogflow ووظائف السحاب لـ Firebase

• Actions on Google هو نظام أساسي لإنشاء تطبيقات لمساعد Google.
• Dialogflow - محرك NLU (فهم اللغة الطبيعية) ، المسؤول عن معالجة اللغات الطبيعية ومربعات حوار التصميم.
• وظائف السحابة لـ Firebase (من أجل الراحة ، سنستخدم اختصار وظائف Firebase) - وظائف السحابة لمعالجة المنطق المعقد لتفاعل المستخدم والعمل مع خدمات الطرف الثالث. تتفاعل وظائف Firebase و Dialogflow عبر الرد التلقائي على الويب ، لذا يمكن استخدام أي حل خادم آخر تقنيًا. ومع ذلك ، تعد وظائف Firebase بديلاً جيدًا ، وأحيانًا بديلًا عن الواجهة الخلفية الخاصة بها. يسمح لك بإنشاء الخدمات وتشغيلها على البنية التحتية لـ Google ، دون القلق بشأن تخصيص الخوادم أو تغيير حجمها أو إدارتها. من ناحية ، يسمح لك هذا بالتركيز على مكون المنتج لتطوير ووظيفة الخدمة ، دون إضاعة الوقت في مهام البنية التحتية والإدارة. ولكن من ناحية أخرى ، كقاعدة ، يستلزم التفويض إضعاف السيطرة على الوضع.

• يصل المستخدم إلى تطبيق مساعد Google ويبدأ محادثة بإجراء محدد.
• يعمل مساعد Google من خلال Actions on Google على ترجمة كل عبارة مستخدم بتنسيق نصي في Dialogflow ، بالإضافة إلى توفير معلومات حول المستخدم نفسه (بناءً على طلب مسبق وبموافقة المستخدم) والمحادثة الحالية .
• يعالج Dialogflow العبارة المستلمة ، ويستخرج المعلومات الضرورية منها ، ويتخذ قرارات بشأن الإجابة التي سيتم إنشاؤها على أساس ML.
• في بعض الحالات ، قد يفوض Dialogflow تكوين استجابة للخادم في وظائف Firebase ، والتي بدورها يمكنها استخدام خدمات الجهات الخارجية للحصول على المعلومات اللازمة للاستجابة.
• بعد تكوين الإجابة ، يُعيدها Dialogflow إلى Actions on Google ، حيث يدخل تطبيق Google Assistant.

فكرة

1. قم بإعداد وربط الإجراءات على Google و Dialogflow ووظائف Firebase.
2. استخرج الكلمات الرئيسية من عبارات المستخدم (Dialogflow).
3. مربع حوار البرمجة النصية (Dialogflow).
4. العمل مع سياق الحوار (Dialogflow).
5. إنشاء ربط ويب وربطه لإنشاء استجابة لعبارة مستخدم (Dialogflow ، Firebase Function).
6. عرض رف البطاقات في الواجهة (وظائف Firebase).
7. تنزيل المعلومات من خدمة طرف ثالث (وظائف Firebase).

الإعداد الأولي

• اللغة الافتراضية هي "الروسية - رو".
• المنطقة الزمنية: "(GMT + 3: 00) Europe / Moscow".
• Google Cloud Project: سيتم إنشاء GCP جديد لوكيل Dialogflow تلقائيًا ، أو يمكنك اختيار أحد مشروعات GCP الحالية ، إن وجدت.

• "هدف الترحيب الافتراضي" - مسؤول عن تحية المستخدم ؛
• "Default Fallback Intent" - يعالج العبارات غير المعروفة التي لا يمكن لـ Dialogflow أن ينسبها إلى أي أهداف أخرى.

السيناريو الأساسي: بحث GIF

• "أريد أن أرى الزرافات الراقصة."
• "ابحث عن animashki."
• "إظهار الأختام."
• أرني صور متحركة.
• "البحث عن الفيلة المتحركة."
• "عرض صور متحركة من الباندا".
• "متحركة مع خطوط الراكون."
• "لديك أختام".
• "ابحث عن السقوط المضحك."

 'use strict'; const GIPHY_API_KEY = 'API_KEY'; const SEARCH_RESULTS = [ '-,    .', ',   .', ',   !' ]; // Import the Dialogflow module from the Actions on Google client library. const { dialogflow, BrowseCarouselItem, BrowseCarousel, Suggestions, Image } = require('actions-on-google'); // Import the firebase-functions package for deployment. const functions = require('firebase-functions'); // Import the request-promise package for network requests. const request = require('request-promise'); // Instantiate the Dialogflow client. const app = dialogflow({ debug: true }); function getCarouselItems(data) { var carouselItems = []; data.slice(0, 10).forEach(function (gif) { carouselItems.push(new BrowseCarouselItem({ title: gif.title || gif.id, url: gif.url, image: new Image({ url: gif.images.downsized_medium.url, alt: gif.title || gif.id }), })); }); return carouselItems; } function search(conv, query) { // Send the GET request to GIPHY API. return request({ method: 'GET', uri: 'https://api.giphy.com/v1/gifs/search', qs: { 'api_key': GIPHY_API_KEY, 'q': query, 'limit': 10, 'offset': 0, 'lang': 'ru' }, json: true, resolveWithFullResponse: true, }).then(function (responce) { // Handle the API call success. console.log(responce.statusCode + ': ' + responce.statusMessage); console.log(JSON.stringify(responce.body)); // Obtain carousel items from the API call response. var carouselItems = getCarouselItems(responce.body.data); // Validate items count. if (carouselItems.length <= 10 && carouselItems.length >= 2) { conv.data.query = query; conv.data.searchCount = conv.data.searchCount || 0; conv.ask(SEARCH_RESULTS[conv.data.searchCount % SEARCH_RESULTS.length]); conv.data.searchCount++; conv.ask(new BrowseCarousel({ items: carouselItems })); } else { // Show alternative response. conv.ask('      ,   - ?)'); } }).catch(function (error) { // Handle the API call failure. console.log(error); conv.ask(',     .'); }); } // Handle the Dialogflow intent named 'Search Intent'. // The intent collects a parameter named 'query'. app.intent('Search Intent', (conv, { query }) => { return search(conv, query); }); // Set the DialogflowApp object to handle the HTTPS POST request. exports.dialogflowFirebaseFulfillment = functions.https.onRequest(app); 

 { "name": "dialogflowFirebaseFulfillment", "description": "This is the default fulfillment for a Dialogflow agents using Cloud Functions for Firebase", "version": "0.0.1", "private": true, "license": "Apache Version 2.0", "author": "Google Inc.", "engines": { "node": "~6.0" }, "scripts": { "start": "firebase serve --only functions:dialogflowFirebaseFulfillment", "deploy": "firebase deploy --only functions:dialogflowFirebaseFulfillment" }, "dependencies": { "actions-on-google": "2.0.0-alpha.4", "firebase-admin": "^4.2.1", "firebase-functions": "^0.5.7", "dialogflow": "^0.1.0", "dialogflow-fulfillment": "0.3.0-beta.3", "request": "^2.81.0", "request-promise": "^4.2.1" } } 

"حساب الفوترة غير مكوّن. لا يمكن الوصول إلى الشبكة الخارجية والحصص محدودة للغاية. تكوين حساب الفوترة لإزالة هذه القيود. "

السيناريو المتقدم: ترقيم الصفحات

 const SEARCH_RESULTS_MORE = [ '   !', ',    .', ',   .  ,    .' ]; function search(conv, query, offset) { // Send the GET request to GIPHY API. return request({ method: 'GET', uri: 'https://api.giphy.com/v1/gifs/search', qs: { 'api_key': GIPHY_API_KEY, 'q': query, 'limit': 10, 'offset': offset, 'lang': 'ru' }, json: true, resolveWithFullResponse: true, }).then(function (responce) { // Handle the API call success. console.log(responce.statusCode + ': ' + responce.statusMessage); console.log(JSON.stringify(responce.body)); // Obtain carousel items from the API call response. var carouselItems = getCarouselItems(responce.body.data); // Validate items count. if (carouselItems.length <= 10 && carouselItems.length >= 2) { conv.data.query = query; conv.data.offset = responce.body.pagination.count + responce.body.pagination.offset; conv.data.paginationCount = conv.data.paginationCount || 0; conv.data.searchCount = conv.data.searchCount || 0; // Show successful response. if (offset == 0) { conv.ask(SEARCH_RESULTS[conv.data.searchCount % SEARCH_RESULTS.length]); conv.data.searchCount++; } else { conv.ask(SEARCH_RESULTS_MORE[conv.data.paginationCount % SEARCH_RESULTS_MORE.length]); conv.data.paginationCount++; } conv.ask(new BrowseCarousel({ items: carouselItems })); conv.ask(new Suggestions('')); } else { // Show alternative response. conv.ask('      ,   - ?)'); } }).catch(function (error) { // Handle the API call failure. console.log(error); conv.ask(',     .'); }); } // Handle the Dialogflow intent named 'Search Intent - more'. app.intent('Search Intent - more', (conv) => { // Load more gifs from the privious search query return search(conv, conv.data.query, conv.data.offset); }); 

النتيجة