rocket ship

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 @andrew_32881/hey-google-talk-to-24dfd336acd">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
@andrew_32881/hey-google-talk-to-24dfd336acd">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.

License

GNU 3.0