Egyéni műveletek létrehozása a Google Segéd számára: 12 lépés

2024 Szerző: John Day | [email protected]. Utoljára módosítva: 2024-01-30 09:41

Látva a Google Segédben rejlő lehetőségeket a Google I/O 18 -ban, valamint a Volvo Cars infotainment rendszerében, nem tudtam ellenállni a kipróbálásnak. Újra felhasználtam az egyik régebbi projektemet, a VasttraPi -t, és összekapcsoltam a Google Segéddel. Ha többet szeretne olvasni a projektről, örülnék, ha megnézné a blogom kapcsolódó cikkét: Egyéni műveletek a Google Segéd számára.

Ebben az utasításban azon a lépéseken megyünk keresztül, amelyek szükségesek ahhoz, hogy elindíthassuk saját Google Assistant Action -jét, amely kommunikálni fog a szerverével, és visszahívja Önt, felsorolva a közelgő indulásokat. Ne feledje, hogy nem fogjuk használni az SDK -t, mivel ezt teljesen a Google Segéden belül futtatjuk, és nem a saját eszközünkön. Összességében egyszerű lesz. A művelet használható lesz a Google Segédet támogató eszközökön, például telefonokon, táblagépeken, otthoni asszisztenseken és hordható eszközökön, és akár a Play Áruház egyik alkalmazásával is megoszthatja azt!

Az ilyesmi létrehozásának egyik fő előnye az olyan szolgáltatásokkal szemben, mint az IFTTT, hogy egyéni válaszokat hozhat létre a szerverén, amelyeket a Google Segéd olvas. Az IFTTT-ben a kommunikáció számomra egyirányú.

A következő témákról lesz szó:

• Az első Action projekt létrehozása
• Egyéni szándék létrehozása
• Egyéni entitás létrehozása
• Webhook beállítása a művelet végrehajtásához
• Egy egyszerű REST szerver beállítása, Python és Flask segítségével, amely megadja a válaszokat vagy a "teljesítést"
• Az Action projekt tesztelése
• Az Action projekt kiadása

Itt nem talál sok részletet vagy elméletet a Google Assistant különféle funkcióiról és koncepcióiról. Ha érdekli őket, javaslom, hogy kövesse a hivatalos oktatóanyagot, vagy nézze meg ezt a videót.

1. lépés: Állítsa be Google -fiókja engedélyeit

Mielőtt elkezdenénk, meg kell győződnünk arról, hogy a Google Segéd rendelkezik a megfelelő engedélyekkel.

1. Lépjen a Tevékenységvezérlők oldalra

2. Győződjön meg arról, hogy a következők engedélyezve vannak:

   1. Internetes és alkalmazástevékenység
   2. Eszköz információ
   3. Hang- és hangtevékenység

2. lépés: Hozza létre a műveletet

1. Lépjen az Actions Console -ba, és kattintson a "Projekt hozzáadása/importálása" elemre
2. Nevezzük ezt az Akciók projektet "helyi forgalomtervezőnek".
3. Kattintson a "Projekt létrehozása" gombra.
4. A következő oldalon ne válasszon kategóriát, és kattintson a "Kihagyás" gombra.
5. Most a Műveleti konzol főoldalán kell lennie.

3. lépés: Műveleti felhívás

Határozza meg, hogyan szeretné aktiválni a Google Segédet a művelet elindításához.

1. Kattintson a "Döntse el, hogyan hívja fel a műveletet" lehetőségre a "Gyors beállítás" alatt.
2. Hívja "Saját forgalomtervező" -nek, és kattintson a "Mentés" gombra.

3. Kattintson a "MINTAFELHÍVÁSOK FRISSÍTÉSE" parancsra, amely a mentés gombra kattintás után jelent meg.

   Ezt a lehetőséget a "Könyvtárinformációk" alatt is megtalálhatja

4. Adja hozzá a "Kérdezze meg a helyi forgalomtervezőt" új hívásként, és kattintson a "Mentés" gombra.

4. lépés: Adja hozzá az első műveletet

1. Kattintson a "Műveletek" elemre a bal oldali sávon.
2. Kattintson az "ELSŐ TEVÉKENYSÉG HOZZÁADÁSA" gombra.
3. Válassza az "Egyéni szándék" lehetőséget, majd kattintson a "Build" gombra.
4. Ekkor a Dialogflow oldalra kerül, ahol végrehajtja a fő logikát.

5. lépés: Képzési kifejezések szándékának megfelelően

1. Válassza ki az időzónát, majd kattintson a "Létrehozás" gombra.
2. A következő oldalon hagyja a meglévő szándékokat, és kattintson a "SZÁNDÉK LÉTREHOZÁSA" gombra.
3. Adjon ésszerű nevet a szándéknak, azaz "távozások".
4. Lépjen a "Képzési kifejezések" menüpontra, és kattintson a "Képzési kifejezések hozzáadása" gombra.

5. Használja a következő kifejezéseket a modell oktatásához, hogy értelmezni tudja, amit mond:

   1. Jelenleg otthon vagyok
   2. Egyelőre itthon vagyok
   3. Jelenleg a lakásunkban vagyok
   4. Otthon ülök
   5. Jelenleg a munkahely közelében vagyok
   6. dolgozom
   7. Az irodában vagyok
   8. Munka
   9. itthon

6. lépés: Entitások

Most megadta, hogy mit kell többé -kevésbé elvárni bemenetként, meg kell határoznunk, hogy a bemenet mely részei érdeklik az üzleti logikánkat, hogy azok kinyerhetők és kiemelhetők legyenek a szerverünkön. Esetünkben azt szeretnénk megtudni, hogy a felhasználó otthon vagy a munkahelyen van, így válaszolhatunk az adott állomásról való indulással. Lássuk, hogyan tehetjük ezt meg.

1. Ha duplán rákattint egy vagy több szóra a képzési kifejezésekből, megjelenik az előre meghatározott entitások listája. Mindegyikről itt olvashat bővebben. Összességében a legalkalmasabb a @sys.location lenne, de szerintem a legjobb és legegyszerűbb, ha létrehozunk egy saját entitást, amelyet @current-location-nak kell neveznünk.
2. Kattintson a bal oldali "Entities" lehetőségre.
3. Kattintson a "LÉTREHOZÁS" gombra.

4. Állítsa a nevet "aktuális hely" -re, és határozzon meg két referenciaértéket szinonimáikkal együtt:

   1. itthon

      otthon, ház, lakás, kiságy

   2. munka

      munka, iroda, Aptiv, kódbányák (lol csak vicc)

5. Kattintson a "Mentés" gombra. Az extra hatás érdekében kattintson az "Automatikus bővítés engedélyezése" gombra is, hogy további szabadságot biztosítson a Google Segédnek, hogy több szinonimát egyeztethessen a referenciaértékekkel.

7. lépés: Művelet és paraméterek

Itt az ideje, hogy értelmet nyújtson a kulcsszavaknak az edzési kifejezésekben.

1. Kattintson a "Szándékok" elemre, majd navigáljon az egyéni szándékához, azaz az "indulásokhoz", ha követte a nevemre vonatkozó javaslataimat.
2. Görgessen le az „Edzési kifejezések” szakaszhoz.
3. Kattintson duplán a jelenlegi tartózkodási helyét jelző szavakra, és a felugró ablakban válassza ki a @current-location címkét.
4. Görgessen le a "Műveletek és paraméterek" elemre, kattintson a "kezelés" gombra
5. Ha mindent helyesen hajtott végre, akkor megjelenik az új entitás.
6. Jelölje be a "Kötelező" négyzetet, amely új oszlopot jelenít meg: "Kérdések". Az utasításokat a felhasználó hallja, ha az elvárásnak megfelelőt nem adtak meg.
7. Kattintson a "Kérdések definiálása" elemre, és illesszen be valamit: "Nem értettem a tartózkodási helyét. Hol van jelenleg?".

8. lépés: Teljesítés

Itt az ideje, hogy összekapcsolja webszolgáltatását a Google Segédművelettel. A kampóját hívják, amikor ez a konkrét szándék megindul, és ennek a műveletnek kell teljesülnie. Ezt megelőzően azt a szándékunkat is meg akarjuk határozni, hogy a cselekvés befejezése után befejezzük.

1. Lépjen a "Válaszok" elemre, és kattintson a "VÁLASZ HOZZÁADÁSA" gombra.
2. Ne adjon hozzá válaszokat, csak engedélyezze a "Állítsa be ezt a szándékot a beszélgetés befejezésének" lehetőséget.
3. Görgessen le a „Teljesítés” elemhez, kattintson a „TELJESÍTÉS ENGEDÉLYEZÉSE” elemre, majd kapcsolja be a „Webhook hívás engedélyezése erre a célra” lehetőséget.
4. Kattintson a "Mentés" gombra, majd lépjen a "Teljesítés" opcióra a bal oldalon.

5. Engedélyezze a "Webhook" opciót, és illessze be azt az URL -t, amelyet a webszerver "hallgat".

   Amikor a szándék létrejön, POST kérést küld a webhelyére a kérelem törzsével, amely egy JSON objektumot tartalmaz a felhasználó jelenlegi tartózkodási helyével

6. Kattintson a Mentés gombra.
7. Most készen állunk webszolgáltatásunk létrehozására, de előtte győződjünk meg arról, hogy cselekvésünk megfelelő módon fogad minket.

9. lépés: Üdvözlő szándék

A felhasználói élmény testreszabása érdekében megfelelő üdvözletet kell létrehoznunk számunkra, amikor cselekedetünket elindítjuk.

1. Lépjen a "Szándékok" elemre, majd kattintson az "Alapértelmezett üdvözlési szándék" gombra.
2. Görgessen le a „Válaszok” szakaszhoz, távolítsa el a meglévőket, és illessze be, hogy mit szeretne, hogyan szeretné üdvözölni, ha kezdeményezi.
3. Kattintson a "Mentés" gombra.

10. lépés: A Python webszolgáltatása

Készítsünk egy gyors és piszkos Python szervert a Flask segítségével. Nincs képernyőkép ehhez a lépéshez, de nagyon egyszerűnek kell lennie.

1. Nyisson meg egy új lapot, és hozzon létre egy fiókot a pythonanywhere.com webhelyen
2. Erősítsd meg az e-mail címedet.
3. Állítsa be webes alkalmazását a "Weblap megnyitása" gombra kattintva.
4. Kattintson az "Új webes alkalmazás hozzáadása" elemre, és válassza a "Lombik" lehetőséget Python webes keretrendszerként.
5. Válassza a Python 3.6 lehetőséget, majd kattintson a "Tovább" gombra.
6. Válassza ki azt az utat, ahol a "flask_app.py" címet szeretné elhelyezni. Közvetlenül a saját mappámba helyeztem "/home/your-username/flask_app.py" néven.
7. A bal felső sarokban található Python logóra kattintva térjen vissza a főoldalra.
8. A fájlok alatt kattintson a "flask_app.py" gombra a szerkesztés megkezdéséhez.
9. Amikor megnyílik a webes szövegszerkesztő, illessze be a következő kódot, és kattintson a "Mentés" gombra. Az általános elképzelés az, hogy a Google Asssistant -ból származó elemzett JSON -tól függően szerverünk végrehajt egy műveletet (pl. Olvas vagy ír), és válaszként jelenti be /teljesítés, amelyet el kell olvasni a felhasználónak.
10. Kattintson ismét a "Weblap megnyitása", majd a zöld "Újratöltés" gombra.
11. Mostanra rendelkeznie kell saját Python webszerverével a "https://your-username.pythonanywhere.com/departures" címen.

11. lépés: Tesztelje tevékenységét

Rendben, mostanra nagyjából kész vagy. Próbáljuk ki most az egész veremt, és működésbe hozzuk ezt a "Hello world" példát!

1. Kattintson az "Integrációk" elemre a bal oldali sávban.
2. Kattintson az "Integrációs beállítások" elemre a Google Segéd opció alatt.
3. Az „Implicit hívás” szakaszban adja meg szándékának nevét, azaz „indulásokat”, hogy az közvetlenül aktiválható legyen, például „Hé Google, beszéljen a helyi forgalomtervezővel az otthoni indulásokról”.
4. Engedélyezze az "Automatikus előnézet" módosításokat.
5. Kattintson a "Teszt" gombra, amely új oldalt nyit meg.
6. Gépelje be a „Beszéljen a helyi forgalomtervezővel” parancsot.
7. Meg kell hívni a műveletet, amely köszöntheti Önt a korábban beállított üdvözlő szándékú válaszok egyikével.
8. Ezután írja be: "dolgozom". Fel kell venni a kapcsolatot a Python szerverével, és a választ a Google Segéd olvassa el.

Klassz nem? Most képzelje el, mit tehet az érzékelőkkel, állítóművekkel és más API -kkal a Google Segéden keresztül.

12. lépés: Engedje el a műveletet

Miután befejezte a cselekvés tesztelését és jó állapotban van, ideje megosztani a szeretetet a világgal, vagy ha ennek nincs értelme, barátaival és családjával.

1. Térjen vissza az Actions konzolhoz, és válassza ki a helyi forgalomtervező műveletet.
2. A „Készüljön fel a telepítésre” alatt kattintson a „Adja meg a műveleteknek a Műveletek könyvtárába való felvételéhez szükséges információkat” elemre.
3. Adjon meg egy rövid leírást, egy hosszabb leírást, egy kis logót, az elérhetőségeit, az adatvédelmi irányelvek linkjét (ha nem fogja nyilvánosan megosztani ezt, csak tegyen egy linket a webhelyére vagy ilyesmire) és egy kategóriát.
4. Görgessen felfelé, és kattintson a "Mentés" gombra.
5. Kattintson a "Kiadás" lehetőségre a bal oldali sávban.
6. Itt választhatja ki, hogy az akció milyen állapotban van. Ha nem akarja hallani a "Lássuk a helyi forgalomtervező tesztverzióját" választ, teljes körű nyilvános kiadást kell végrehajtania. Ez azonban a Google felülvizsgálatát igényli, és ez nem foglalkozik ezzel az oktatóanyaggal. Ehelyett továbbra is megoszthatja ezt akár 20 személlyel, ha kiválaszt egy Alfa kiadást, és hozzáadja őket Alfa tesztelőként.
7. Bármilyen alfa -tesztelőt hozzáadhat, ha elküldi nekik a linket, vagy hozzáadja az e -mailjeiket.
8. Kattintson a "BEKÜLDÉS ALFÁRA" gombra, jelölje be a négyzeteket, kattintson a "BEKÜLDÉS" gombra, és kész!

Az akció jelenleg élő, és Ön és barátai elérhetik. Érezd jól magad!

Ha érdekli az általam használt kód, nézze meg a projektet a GitHubon.