Lag tilpassede handlinger for Google Assistant: 12 trinn

2024 Forfatter: John Day | [email protected]. Sist endret: 2024-01-30 11:22

Da jeg så potensialet til Google Assistant slik det ble presentert i Google I/O 18 så vel som Volvo Cars i infotainmentsystemet, kunne jeg ikke motstå å prøve det. Jeg gjenbrukte et av mine eldre prosjekter, VasttraPi, og grensesnittet det med Google Assistant. Hvis du vil lese mer om prosjektet, vil jeg bli glad hvis du tar en titt på den relaterte artikkelen på bloggen min: Tilpassede handlinger for Google Assistant.

I denne instruksen går vi over trinnene som er nødvendige for å starte din egen Google Assistant -handling som vil kommunisere med serveren din og snakke tilbake til deg, og liste opp kommende avganger. Husk at vi ikke kommer til å bruke SDK siden vi kjører dette helt i Google Assistant og ikke vår egen enhet. Totalt sett skal det holdes enkelt. Handlingen din kan brukes på enheter som støtter Google Assistant, for eksempel telefoner, nettbrett, hjemmeassistenter og wearables, og du kan til og med dele den som du ville gjort med en app i Play Store!

En av de viktigste fordelene med å lage noe slikt enn bruk av tjenester som IFTTT er at du kan lage egendefinerte svar på serveren din som vil bli lest av Google Assistant. I IFTTT er kommunikasjonen så langt jeg er bekymret enveis.

Følgende emner vil bli dekket:

• Lag ditt første Action -prosjekt
• Opprette din tilpassede intensjon
• Opprette din egendefinerte enhet
• Sette en webhook for å oppfylle handlingen din
• Sette opp en enkel REST -server, skrevet i Python med Flask, som vil gi svarene eller "oppfyllelsen"
• Tester ditt Action -prosjekt
• Slipper Action -prosjektet ditt

Her finner du ikke mange detaljer eller teori om de forskjellige funksjonene og konseptene i Google Assistant. Hvis du er interessert i dem, foreslår jeg på det sterkeste at du følger den offisielle opplæringen eller ser denne videoen.

Trinn 1: Angi Google -kontotillatelser

Før vi begynner må vi sikre at Google Assistant har de riktige tillatelsene.

1. Gå til Aktivitetskontroller

2. Sørg for at følgende er aktivert:

   1. Nett- og appaktivitet
   2. Enhetsinformasjon
   3. Stemme- og lydaktivitet

Trinn 2: Lag handlingen din

1. Gå til Actions Console og klikk på "Legg til/importer prosjekt"
2. La oss kalle dette Actions-prosjektet for "lokal trafikkplanlegger".
3. Klikk på "Opprett prosjekt".
4. På neste side, ikke velg en kategori og klikk på "Hopp over".
5. Du bør være på hovedsiden for handlingskonsoll nå.

Trinn 3: Tilkallelse av handling

Bestem hvordan du vil aktivere Google Assistant for å starte handlingen din.

1. Klikk på "Bestem hvordan handlingen din skal påkalles" under "Hurtigoppsett".
2. Kall det "Min lokale trafikkplanlegger" og klikk på "Lagre".

3. Klikk på "UPDATE SAMPLE INVOCATIONS" -meldingen som dukket opp etter å ha klikket lagre.

   Du kan også finne dette alternativet under "Kataloginformasjon"

4. Legg til "Spør min lokale trafikkplanlegger" som en ny påkalling, og klikk på "Lagre".

Trinn 4: Legg til din første handling

1. Klikk på "Handlinger" i linjen til venstre.
2. Klikk på "Legg til din første handling".
3. Velg "Tilpasset intensjon" og klikk deretter på "Bygg".
4. Du blir ført til siden Dialogflow, der du vil implementere hovedlogikken.

Trinn 5: Treningsfraser for din hensikt

1. Velg tidssonen din og klikk "Opprett".
2. La den eksisterende hensikten være på den neste siden, og klikk på "SKAP INTENT".
3. Gi intensjonen et rimelig navn, dvs. "avganger".
4. Gå til "Treningsfraser" og klikk på "Legg til treningsfraser".

5. Bruk følgende setninger for å trene modellen din slik at den kan tolke det du forteller den:

   1. Jeg er hjemme akkurat nå
   2. Foreløpig er jeg hjemme
   3. Jeg er i leiligheten vår for øyeblikket
   4. Jeg sitter hjemme
   5. For tiden er jeg nær jobb
   6. jeg er på jobb
   7. Jeg er på kontoret
   8. Arbeid
   9. Hjem

Trinn 6: Enheter

Nå som du har spesifisert hva som mer eller mindre kan forventes som input, må vi definere hvilke deler av inputene som er av interesse for vår forretningslogikk, slik at de kan trekkes ut og fremheves for serveren vår. I vårt tilfelle vil vi vite om brukeren er hjemme eller på jobb, slik at vi kan svare tilbake med avgangene fra den spesifikke stasjonen. La oss se hvordan vi kan gjøre det.

1. Hvis du dobbeltklikker på ett eller flere ord i treningsfrasene, får du en liste over forhåndsdefinerte enheter. Du kan lese mer om hver av dem her. Totalt sett vil den mest passende være @sys.location, men jeg tror det er best og enklest hvis vi oppretter vår egen enhet som vi bør kalle @current-location.
2. Klikk på "Entities" -alternativet på venstre side.
3. Klikk på "CREATE ENTITY".

4. Sett navnet til "nåværende plassering" og definer to referanseverdier sammen med synonymer:

   1. hjem

      hjem, hus, leilighet, barneseng

   2. arbeid

      arbeid, kontor, Aptiv, kodegruver (lol bare tuller)

5. Klikk på "Lagre. For ekstra effekt kan du også klikke på" Tillat automatisk utvidelse "for å gi Google Assistant ytterligere friheter til å prøve å matche flere synonymer med referanseverdiene.

Trinn 7: Handling og parametere

På tide å gi noen mening til søkeordene i treningsfrasene.

1. Klikk på "Intents" og naviger deretter til din tilpassede hensikt, dvs. "avganger" hvis du har fulgt forslagene mine.
2. Rull ned til "Treningsfraser".
3. Dobbeltklikk på ordene som angir din nåværende posisjon, og velg @nåværende posisjon-taggen fra popup-vinduet.
4. Rull ned til "Handlinger og parametere", klikk på "administrer"
5. Hvis alt ble gjort riktig, vil du se din nye enhet oppført der.
6. Merk av i "Obligatorisk" -boksen som viser at en ny kolonne, "Spørsmål", vises. Prompts er hva brukeren skal høre hvis det ikke er gitt noe som samsvarer med forventningen.
7. Klikk på "Definer ledetekster" og sett inn noe som "Jeg forsto ikke posisjonen din. Hvor er du for øyeblikket?".

Trinn 8: Oppfyllelse

Nå er det på tide å koble nettjenesten din til Google Assistant Action. Kroken din blir ringt opp når denne spesifikke hensikten utløses og bør føre til at denne handlingen oppfylles. Før det ønsker vi også å sette vår intensjon om å avslutte handlingen etter å ha blitt fullført.

1. Gå til "Svar" og klikk på "Legg til svar".
2. Ikke legg til noen svar, bare aktiver "Sett denne intensjonen som slutten på samtalen".
3. Rull ned til "Oppfyllelse", klikk på "ENABLE FULFILLMENT" og slå deretter på "Aktiver webhook -samtale for denne hensikten".
4. Klikk "Lagre" og gå til "Oppfyllelse" -alternativet på venstre side.

5. Aktiver "Webhook" -alternativet og sett inn nettadressen som blir "lyttet" av webserveren din.

   Når hensikten utløses, sender den en POST -forespørsel til nettstedet ditt med brødteksten i forespørselen som inneholder et JSON -objekt med brukerens nåværende plassering

6. Klikk på Lagre.
7. Nå er vi klare til å lage vår webtjeneste, men før det, la oss sørge for at vår handling ønsker oss velkommen på en skikkelig måte.

Trinn 9: Velkommen Intent

For å tilpasse brukeropplevelsen, bør vi lage en passende hilsen for oss hver gang vi utløser handlingen vår.

1. Gå til "Intents" og klikk deretter på "Standard Welcome Intent".
2. Rull ned til "Svar", fjern de eksisterende og sett inn det du vil at handlingen din skal ønske deg velkommen når den er startet.
3. Klikk "Lagre".

Trinn 10: Python -webtjenesten din

La oss lage en rask og skitten Python -server ved hjelp av Flask. Ingen skjermbilder for dette trinnet, men det skal være ganske rett frem.

1. Åpne en ny fane og opprett en konto på pythonanywhere.com
2. Bekreft e -posten din.
3. Sett opp webprogrammet ditt ved å klikke på "Åpne nettfanen".
4. Klikk på "Legg til en ny webapp" og velg "Flask" som Python -nettramme.
5. Velg Python 3.6 og klikk "Neste".
6. Velg banen du vil at "flask_app.py" skal bo i. Jeg plasserte den direkte i hjemmemappen min som "/home/your-username/flask_app.py".
7. Gå tilbake til hovedsiden ved å klikke på Python -logoen i øvre venstre hjørne.
8. Under filer klikker du på "flask_app.py" for å begynne å redigere den.
9. Når webtekstredigereren åpnes, limer du inn følgende kode og klikker "Lagre". Den overordnede ideen er at avhengig av den analyserte JSON som kommer fra Google Asssistant, vil tjeneren vår utføre en handling (f.eks. Lese eller skrive) og rapportere den tilbake som et svar /oppfyllelse som bør leses for brukeren.
10. Klikk på "Åpne web -fanen" igjen og deretter på den grønne "Last inn -knappen".
11. Nå bør du ha din egen Python-webserver som kjører på "https://your-username.pythonanywhere.com/departures".

Trinn 11: Test handlingen din

OK, du er ganske ferdig nå. La oss teste hele stabelen nå og få dette "Hei verden" -eksemplet til å fungere!

1. Klikk på "Integrasjoner" fra linjen til venstre.
2. Klikk på "Integreringsinnstillinger" under alternativet Google Assistant.
3. Under "Implisitt påkallelse, legg til navnet på intensjonen din, dvs." avganger ", slik at det kan utløses direkte ved å si noe som" Hei Google, snakk med min lokale trafikkplanlegger om avganger hjemmefra ".
4. Aktiver endringer i "Automatisk forhåndsvisning".
5. Klikk på "Test" som åpner en ny side.
6. Skriv "Snakk med min lokale trafikkplanlegger".
7. Handlingen din bør påkalles, noe som bør hilse på deg med et av de tidligere velkomne intensjonssvarene.
8. Skriv deretter "Jeg er på jobb". Python -serveren din bør kontaktes, og svaret blir lest av Google Assistant.

Kult er det ikke? Forestill deg nå hva du kan gjøre i samspill med sensorer, aktuatorer og andre APIer via Google -assistenten.

Trinn 12: Slipp handlingen

Etter at du er ferdig med å teste handlingen din og den er i god stand, er det på tide å dele kjærligheten med verden eller, hvis det ikke gir mening, med venner og familie.

1. Gå tilbake til handlingskonsollen og velg den lokale trafikkplanleggerhandlingen.
2. Under "Gjør deg klar for distribusjon" klikker du på "Skriv inn informasjon som kreves for å føre handlingen din i handlekatalogen".
3. Skriv inn en kort beskrivelse, en lengre beskrivelse, en liten logo, dine kontaktdetaljer, en kobling til personvernerklæring (hvis du ikke vil dele dette offentlig, legg bare en lenke til nettstedet ditt eller noe) og en kategori.
4. Rull opp og klikk på "Lagre".
5. Klikk på "Slipp" -alternativet i venstre sidelinje.
6. Her kan du velge hvilken tilstand handlingen din er i. Hvis du ikke vil høre svaret "La oss få testversjonen av Min lokale trafikkplanlegger" må du lage en fullverdig offentlig utgivelse. Det krever imidlertid en gjennomgang av Google og vil ikke bli dekket i denne opplæringen. I stedet kan du fortsatt dele dette med opptil 20 personer ved å velge en Alpha -utgivelse og legge dem til som Alpha -testere.
7. Legg til alfatestere ved å enten sende dem en lenke eller legge til e -postene deres.
8. Klikk på "SEND TIL ALPHA", merk av i boksene, klikk på "SEND" og du er ferdig!

Nå er handlingen din live og kan nås av deg og dine venner. Ha det gøy!

Hvis du er interessert i koden jeg brukte, kan du se på prosjektet på GitHub.