Opret tilpassede handlinger til Google Assistant: 12 trin

2024 Forfatter: John Day | [email protected]. Sidst ændret: 2024-01-30 08:27

Da jeg så potentialet i Google Assistant, som det blev præsenteret i Google I/O 18 samt Volvo Cars i deres infotainmentsystem, kunne jeg ikke lade være med at prøve det. Jeg genbrugte et af mine ældre projekter, VasttraPi og tilsluttede det med Google Assistant. Hvis du vil læse mere om projektet, vil jeg blive glad, hvis du tager et kig på den relaterede artikel på min blog: Tilpassede handlinger til Google Assistant.

I denne instruktion går vi over de trin, der er nødvendige for at starte din egen Google Assistant -handling, som kommunikerer med din server og taler tilbage til dig og viser kommende afgange. Husk, at vi ikke kommer til at bruge SDK, da vi kører dette fuldstændigt i Google Assistant og ikke vores egen enhed. Generelt vil det blive holdt enkelt. Din handling kan bruges på enheder, der understøtter Google Assistant, f.eks. Telefoner, tablets, hjemmeassistenter og wearables, og du kan endda dele den, som du ville med en app i Play Butik!

En af de største fordele ved at skabe sådan noget i forhold til at bruge tjenester som IFTTT er, at du kan oprette tilpassede svar på din server, som vil blive læst af Google Assistant. I IFTTT er kommunikationen så vidt mig angår envejs.

Følgende emner vil blive behandlet:

• Oprettelse af dit første Action -projekt
• Oprettelse af din tilpassede hensigt
• Oprettelse af din tilpassede enhed
• Indstilling af en webhook til at opfylde din handling
• Opsætning af en simpel REST -server, skrevet i Python med Flask, som giver svarene eller "opfyldelse"
• Test af dit Action -projekt
• Frigør dit Action -projekt

Her finder du ikke mange detaljer eller teori om de forskellige funktioner i Google Assistant og koncepter. Hvis du er interesseret i dem, foreslår jeg på det kraftigste, at du følger den officielle vejledning eller ser denne video.

Trin 1: Angiv dine Google -kontotilladelser

Inden vi begynder, skal vi sikre, at Google Assistant har de relevante tilladelser.

1. Gå til Aktivitetskontroller

2. Sørg for, at følgende er aktiveret:

   1. Web- og appaktivitet
   2. Enhedsoplysninger
   3. Stemme- og lydaktivitet

Trin 2: Opret din handling

1. Gå til Actions Console, og klik på "Tilføj/importer projekt"
2. Lad os kalde dette Actions-projekt "lokal trafikplanlægger".
3. Klik på "Opret projekt".
4. På den næste side skal du ikke vælge en kategori og klikke på "Spring over".
5. Du skulle være på hovedsiden Handlingskonsol nu.

Trin 3: Tilkaldelse af handling

Bestem, hvordan du vil aktivere Google Assistant til at starte din handling.

1. Klik på "Beslut, hvordan din handling skal aktiveres" under "Hurtig opsætning".
2. Kald det "Min lokale trafikplanlægger" og klik på "Gem".

3. Klik på "UPDATE SAMPLE INVOCATIONS" -prompten, der dukkede op efter at have klikket på gem.

   Du kan også finde denne mulighed under "Directory Information"

4. Tilføj "Spørg min lokale trafikplanlægger" som en ny indkaldelse, og klik på "Gem".

Trin 4: Tilføj din første handling

1. Klik på "Handlinger" i linjen til venstre.
2. Klik på "TILFØJ DIN FØRSTE HANDLING".
3. Vælg "Brugerdefineret hensigt", og klik derefter på "Byg".
4. Du bliver ført til siden Dialogflow, hvor du vil implementere hovedlogikken.

Trin 5: Træningssætninger til din hensigt

1. Vælg din tidszone, og klik på "Opret".
2. Lad den eksisterende hensigt være på den næste side, og klik på "Opret hensigt".
3. Giv hensigten et rimeligt navn, dvs. "afgange".
4. Gå til "Træningssætninger" og klik på "Tilføj træningssætninger".

5. Brug følgende sætninger til at træne din model, så den kan fortolke, hvad du fortæller den:

   1. Jeg er hjemme lige nu
   2. Foreløbig er jeg hjemme
   3. Jeg er i vores lejlighed i øjeblikket
   4. Jeg sidder derhjemme
   5. I øjeblikket er jeg tæt på arbejde
   6. jeg er på arbejde
   7. Jeg er på kontoret
   8. Arbejde
   9. Hjem

Trin 6: Enheder

Nu har du angivet, hvad der mere eller mindre skal forventes som input, vi er nødt til at definere, hvilke dele af input der er interessante for vores forretningslogik, så de kan udtrækkes og fremhæves for vores server. I vores tilfælde vil vi vide, om brugeren er hjemme eller på arbejde, så vi kan svare tilbage med afgange fra den specifikke station. Lad os se, hvordan vi kan gøre det.

1. Hvis du dobbeltklikker på et eller flere ord i træningssætningerne, får du en liste over foruddefinerede objekter. Du kan læse mere om hver enkelt af dem her. Samlet set ville den mest egnede være @sys.location, men jeg synes, det er bedst og nemmest, hvis vi opretter vores egen enhed, som vi skal kalde @nuværende-placering.
2. Klik på "Entities" i venstre side.
3. Klik på "Opret ENTITY".

4. Indstil navnet til "nuværende placering", og definer to referenceværdier sammen med deres synonymer:

   1. hjem

      hjem, hus, lejlighed, krybbe

   2. arbejde

      arbejde, kontor, Aptiv, kodeminer (lol bare sjov)

5. Klik på "Gem. For ekstra effekt kan du også klikke på" Tillad automatisk udvidelse "for at give Google Assistant yderligere friheder til at prøve at matche flere synonymer med dine referenceværdier.

Trin 7: Handling og parametre

Tid til at give en vis mening til søgeordene inde i dine træningssætninger.

1. Klik på "Hensigter" og naviger derefter til din tilpassede hensigt, dvs. "afgange", hvis du har fulgt mine navneforslag.
2. Rul ned til "Træningssætninger".
3. Dobbeltklik på de ord, der angiver din nuværende placering, og vælg @nuværende-lokationstagget fra pop op-vinduet.
4. Rul ned til "Handlinger og parametre", klik på "administrer"
5. Hvis alt blev udført korrekt, vil du se din nye enhed blive opført der.
6. Marker afkrydsningsfeltet "Påkrævet", som får en ny kolonne, "Prompts", til at blive vist. Prompts er, hvad brugeren skal høre, hvis der ikke er leveret noget, der matcher forventningen.
7. Klik på "Definer prompts" og indsæt noget i stil med "Jeg forstod ikke din placering. Hvor er du i øjeblikket?".

Trin 8: Opfyldelse

Nu er det tid til at tilslutte din webtjeneste til Google Assistant Action. Din krog vil blive kaldt, når denne specifikke hensigt udløses, og den bør producere opfyldelsen af denne handling. Inden da vil vi også sætte vores intention om at afslutte handlingen efter at være blevet opfyldt.

1. Gå til "Svar", og klik på "TILFØJ ANSVAR".
2. Tilføj ikke nogen svar, aktiver bare "Indstil denne hensigt som afslutning på samtalen".
3. Rul ned til "Opfyldelse" klik på "AKTIV FULLFØLGING", og tænd derefter for "Aktiver webhook -opkald for denne hensigt".
4. Klik på "Gem", og gå derefter til indstillingen "Opfyldelse" i venstre side.

5. Aktiver indstillingen "Webhook", og indsæt den webadresse, der bliver "lyttet" af din webserver.

   Når hensigten udløses, sender den en POST -anmodning til dit websted med brødteksten i anmodningen, der indeholder et JSON -objekt med brugerens aktuelle placering

6. Klik på Gem.
7. Nu er vi klar til at oprette vores webtjeneste, men før det skal vi sørge for, at vores handling byder os velkommen på en ordentlig måde.

Trin 9: Velkommen Intent

For at tilpasse brugeroplevelsen bør vi oprette en passende hilsen til os, når vi udløser vores handling.

1. Gå til "Intents", og klik derefter på "Standard Welcome Intent".
2. Rul ned til "Svar", fjern de eksisterende og indsæt, hvad du vil have din handling, hvordan du byder dig velkommen, når den er startet.
3. Klik på "Gem".

Trin 10: Din Python Web Service

Lad os lave en hurtig og beskidt Python -server ved hjælp af Flask. Ingen skærmbilleder til dette trin, men det skal være ret lige frem.

1. Åbn en ny fane, og opret en konto på pythonanywhere.com
2. Bekræft din e -mail.
3. Konfigurer din webapplikation ved at klikke på "Åbn webfane".
4. Klik på "Tilføj en ny webapp", og vælg "Kolbe" som din Python -webramme.
5. Vælg Python 3.6, og klik på "Næste".
6. Vælg den sti, du vil have din "flask_app.py" til at bo på. Jeg placerede den direkte inde i min hjemmemappe som "/home/your-username/flask_app.py".
7. Gå tilbage til hovedsiden ved at klikke på Python -logoet i øverste venstre hjørne.
8. Under filer skal du klikke på "flask_app.py" for at begynde at redigere den.
9. Når webteksteditoren åbnes, skal du indsætte følgende kode og klikke på "Gem". Den overordnede idé er, at afhængigt af den analyserede JSON, der kommer fra Google Asssistant, vil vores server udføre en handling (f.eks. Læse eller skrive) og rapportere det tilbage som et svar /opfyldelse, der skal læses for brugeren.
10. Klik på "Åbn web -fanen" igen og derefter på den grønne "Genindlæs -knap".
11. På nuværende tidspunkt burde du have din egen Python-webserver kørende på "https://your-username.pythonanywhere.com/departures".

Trin 11: Test din handling

OK, du er stort set færdig nu. Lad os teste hele stakken nu og få dette "Hej verden" -eksempel til at fungere!

1. Klik på "Integrationer" fra linjen i venstre side.
2. Klik på "Integrationsindstillinger" under indstillingen Google Assistant.
3. Under "Implicit påkaldelse tilføj navnet på din hensigt, dvs." afgange ", så det kan udløses direkte ved at sige noget som" Hey Google, tal med min lokale trafikplanlægger om afgange hjemmefra ".
4. Aktiver ændringer af "Automatisk forhåndsvisning".
5. Klik på "Test", som åbner en ny side.
6. Skriv "Tal med min lokale trafikplanlægger".
7. Din handling bør påberåbes, hvilket skal hilse på dig med et af de tidligere indstillede velkomne hensigtssvar.
8. Skriv derefter "Jeg er på arbejde". Der skal kontaktes din Python -server, og svaret læses af Google Assistant.

Fedt er det ikke? Forestil dig nu, hvad du kan gøre ved at interagere med sensorer, aktuatorer og andre API'er via din Google Assistant.

Trin 12: Slip din handling

Når du er færdig med at teste din handling, og den er i god stand, er det tid til at dele kærligheden med verden eller, hvis det ikke giver mening, med dine venner og familie.

1. Gå tilbage til din handlingskonsol, og vælg din lokale trafikplanlæggerhandling.
2. Under "Gør dig klar til implementering" skal du klikke på "Indtast oplysninger, der kræves for at opføre din handling i mappen Handlinger".
3. Indtast en kort beskrivelse, en længere beskrivelse, et lille logo, dine kontaktoplysninger, et link til privatlivspolitik (hvis du ikke vil dele dette offentligt, skal du blot lægge et link til dit websted eller noget) og en kategori.
4. Rul op og klik på "Gem".
5. Klik på "Release" -indstillingen fra linjen i venstre side.
6. Her kan du vælge, hvilken tilstand din handling er i. Hvis du ikke vil høre svaret "Lad os få testversionen af Min lokale trafikplanlægger", skal du foretage en fuldgyldig offentliggørelse. Det kræver dog en gennemgang af Google og vil ikke blive dækket af denne vejledning. I stedet kan du stadig dele dette med op til 20 personer ved at vælge en Alpha -udgivelse og tilføje dem som Alpha -testere.
7. Tilføj alfatestere ved enten at sende dem et link eller tilføje deres e -mails.
8. Klik på "SEND TIL ALPHA", marker afkrydsningsfelterne, klik på "SEND", og du er færdig!

Nu er din handling live og kan tilgås af dig og dine venner. Hav det sjovt!

Hvis du er interesseret i den kode, jeg brugte, kan du tage et kig på projektet på GitHub.