Built for streamlining development of Google Assistant Actions

Andrew Graham-Yooll

Last update: May 16, 2019

Overview

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.

License

GNU 3.0

Comments

Increase the usability of the Apprentice API

This is what I could imagine the API for Apprentice looking like:


from apprentice import Apprentice

apr = Apprentice(__name__)

ENTITIES = {
    "name": "History",
    "entries": [
        {
            "value": "history",
            "synonyms": [
                "history",
                "past event",
                "the past",
                "past"
            ]
        }, {
            "value": "birth",
            "synonyms": [
                "birth",
                "births",
                "born"
            ]
        }
    ]
}


@apr.action(entities=['name'])
def cool_fact_generator(*args, **kwargs):
    reply = _fact_response(apr.entity)
    return apr.make_repsonse(reply)

opened by andrewgy8 1

Add suggestions

When creating a response a user should be able to configure the view of suggestions.

The resulting payload would look like:

'payload': {
                'google': {
                    'expect_user_response': False,
                    'is_ssml': True,
                    'permissions_request': None,
                    "richResponse": {
                        "items": [],
                        "suggestions": [],
                        "linkOutSuggestion": {}
                    }
                }
            }

opened by andrewgy8 0

.env with the Flask App path
For the local server to work as plug-and-play, it would be nice to have .env file that is read as a default to the installed main.py flask app. That way a user could execute:

apprentice init

apprentice run

And have the local server running immediately.
opened by andrewgy8 0
Fix triplicate deployment issue

It seems that travis is trying to deploy the package with every version of python declared. For instance, https://travis-ci.com/andrewgy8/apprentice/builds/93792889

The build succeeds with 3.7, but with 3.6 and 3.5, it fails. It shouldn't be deploying with all the python versions, only one.

opened by andrewgy8 0
Allow user to define init directory name and function name

Be able to handle and argument such as:

apprentice init --name=foo_bar

and the output should be a direct called /foo_bar with a main.py file containing a foo_bar function.
enhancement

opened by andrewgy8 0

Releases(v0.4.4)

v0.4.4(May 16, 2019)

Source code(tar.gz)
Source code(zip)
v0.4.3(May 16, 2019)

Source code(tar.gz)
Source code(zip)
v0.4.2(Mar 23, 2019)

Source code(tar.gz)
Source code(zip)
v0.4.1(Mar 23, 2019)

Source code(tar.gz)
Source code(zip)
v0.4.0(Jan 10, 2019)
SimpleResponse and BasicCardResponse per the docs

Add .editorconfig

Update example to use the new response objects

Source code(tar.gz)
Source code(zip)
v0.3.1(Dec 20, 2018)
v0.3.1

Remove nested directories from init command

Update the readme

Source code(tar.gz)
Source code(zip)
v0.3.0(Dec 9, 2018)

Encapsulate all functions in the apprentice class
Source code(tar.gz)
Source code(zip)
v0.2.0(Dec 6, 2018)
Update to Dialogflow API 2.0

Fix routing issue

Source code(tar.gz)
Source code(zip)
v0.1.7(Dec 6, 2018)
Clean up the public API interface for Apprentice (#24)

Implement Apprentice class.

Built in flask app.

No need to instantiate a flask app yourself

Update commands and readme with new api interface

Source code(tar.gz)
Source code(zip)
v0.1.6(Nov 18, 2018)

Source code(tar.gz)
Source code(zip)
v0.1.5(Nov 17, 2018)

Source code(tar.gz)
Source code(zip)
v0.1.4(Nov 17, 2018)

Source code(tar.gz)
Source code(zip)
v0.1.3(Nov 17, 2018)

Source code(tar.gz)
Source code(zip)
v0.1.2(Nov 17, 2018)

Source code(tar.gz)
Source code(zip)
v0.1.1(Nov 17, 2018)

Source code(tar.gz)
Source code(zip)

Owner

Andrew Graham-Yooll

Software engineer with background in molecular biology

GitHub

Dante, my discord bot. Open source project in development and not optimized for other filesystems, install and setup script in development

DanteMode (In private development for ~6 months) Dante, my discord bot. Open source project in development and not optimized for other filesystems, in

2 Nov 5, 2021

Use GitHub Actions to create a serverless service.

ActionServerless - Use GitHub Actions to create a serverless service ActionServerless is an action to do some computing and then generate a string/JSO

107 Oct 28, 2022

可基于【腾讯云函数】/【GitHub Actions】/【Docker】的每日签到脚本（支持多账号使用）签到列表: ｜爱奇艺｜全民K歌｜腾讯视频｜有道云笔记｜网易云音乐｜一加手机社区官方论坛｜百度贴吧｜Bilibili｜V2EX｜咔叽网单｜什么值得买｜AcFun｜天翼云盘｜WPS｜吾爱破解｜芒果TV｜联通营业厅｜Fa米家｜小米运动｜百度搜索资源平台｜每日天气预报｜每日一句｜哔咔漫画｜和彩云｜智友邦｜微博｜CSDN｜王者营地｜

每日签到集合基于【腾讯云函数】/【GitHub Actions】/【Docker】的每日签到脚本支持多账号使用特别声明: 本仓库发布的脚本及其中涉及的任何解锁和解密分析脚本，仅用于测试和学习研究，禁止用于商业用途，不能保证其合法性，准确性，完整性和有效性，请根据情况自行判断。

87 Nov 12, 2022

HTTP Calls to Amazon Web Services Rest API for IoT Core Shadow Actions 💻🌐💡

aws-iot-shadow-rest-api HTTP Calls to Amazon Web Services Rest API for IoT Core Shadow Actions ?? ?? ?? This simple script implements the following aw

3 Jun 6, 2022

Automatic SystemVerilog linting in github actions with the help of Verible

Verible Lint Action Usage See action.yml This is a GitHub Action used to lint Verilog and SystemVerilog source files and comment erroneous lines of co

10 Dec 26, 2022

Automate HoYoLAB Genshin Daily Check-In Using Github Actions

Genshin Daily Check-In ?? Automate HoYoLAB Daily Check-In Using Github Actions KOR, ENG Instructions Fork the repository Go to Settings -> Secrets Cli

41 Jun 24, 2022

Mini Tool to lovers of debe from eksisozluk (one of the most famous website -reffered as collaborative dictionary like reddit- in Turkey) for pushing debe (Most Liked Entries of Yesterday) to kindle every day via Github Actions.

debe to kindle Mini Tool to lovers of debe from eksisozluk (one of the most famous website -refered as collaborative dictionary like reddit- in Turkey

11 Oct 11, 2022

domhttpx is a google search engine dorker with HTTP toolkit built with python, can make it easier for you to find many URLs/IPs at once with fast time.

domhttpx is a google search engine dorker with HTTP toolkit built with python, can make it easier for you to find many URLs/IPs at once with fast time

59 Dec 4, 2022

Built for streamlining development of Google Assistant Actions

Related tags

Overview

Apprentice

Installation

Quickstart

Deployment

Note

Contributing

License

Comments

Increase the usability of the Apprentice API

Add suggestions

.env with the Flask App path

Fix triplicate deployment issue

Allow user to define init directory name and function name

Releases(v0.4.4)

v0.4.4(May 16, 2019)

v0.4.3(May 16, 2019)

v0.4.2(Mar 23, 2019)

v0.4.1(Mar 23, 2019)

v0.4.0(Jan 10, 2019)

v0.3.1(Dec 20, 2018)

v0.3.1

v0.3.0(Dec 9, 2018)

v0.2.0(Dec 6, 2018)

v0.1.7(Dec 6, 2018)

v0.1.6(Nov 18, 2018)

v0.1.5(Nov 17, 2018)

v0.1.4(Nov 17, 2018)

v0.1.3(Nov 17, 2018)

v0.1.2(Nov 17, 2018)

v0.1.1(Nov 17, 2018)

Owner

Andrew Graham-Yooll

Dante, my discord bot. Open source project in development and not optimized for other filesystems, install and setup script in development

Use GitHub Actions to create a serverless service.

HTTP Calls to Amazon Web Services Rest API for IoT Core Shadow Actions 💻🌐💡

Automatic SystemVerilog linting in github actions with the help of Verible

Automate HoYoLAB Genshin Daily Check-In Using Github Actions

Mini Tool to lovers of debe from eksisozluk (one of the most famous website -reffered as collaborative dictionary like reddit- in Turkey) for pushing debe (Most Liked Entries of Yesterday) to kindle every day via Github Actions.

POC de uma AWS lambda que executa a consulta de preços de criptomoedas, e é implantada na AWS usando Github actions.

Tubee is a web application, which runs actions when your subscribed channel upload new videos

Implement SAST + DAST through Github actions

A github actions + python code to extract URLs to code repositories to put into standard form, starting with github

GitHub Actions Poll Mode AutoScaler (GAPMAS)

Centralized whale instance using github actions, sourcing metadata from bigquery-public-data.

A GitHub Actions repo for tracking the dummies sending free money to Alex Jones + co.

42-event-notifier - 42 Event notifier using 42API and Github Actions

GitHub Actions Docker training

ChannelActionsBot - Channel Actions Bot With Python

A discord.py bot template with easy deployment through Github Actions

domhttpx is a google search engine dorker with HTTP toolkit built with python, can make it easier for you to find many URLs/IPs at once with fast time.