Apprentice
Apprentice is a framework built for developing Google Actions via Dialogflow and Google Cloud (serverless) Functions.
Includes:
- plug-and-play feel to get going quickly
- basic Dialogflow API 2.0 response handling
- local setup for quick iteration
Installation
pip install apprentice
Quickstart
We recommend you read the full tutorial here.
A Google Action project will consist of two things:
- Dialogflow Intent
- A webhook to satisfy your users intent
To generate a "Hello World" webhook, run:
$ apprentice init
This will create a file structure:
src/
main.py
requirements.txt
Run a local server with
$ apprentice run
and expose to localhost port via an https tunnel. Then add the url to the fulfillment webhook in Dialogflow.
For a more indepth example please see the tutorial I wrote here.
Deployment
Note
gcloud
cli must be installed and authorized for the following command to work. If you wish to not have gcloud
cli installed, you can copy the file contents via the gcloud function dashboard.
$ apprentice -f hello_world -s hello_world_agent -e hello_world
This will generate the command to execute a gcloud function deploy
via the cli.
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.