Actions on Google: Conversation Component Sample

A simple sample showing the visual conversation components available with Actions on Google.

Setup Instructions

Steps for Actions SDK

1. Use the Actions on Google Console to add a new project with a name of your choosing.
2. Choose Actions SDK in the Add actions to your app section. A dialog pops up: leave it open because you will need it for an upcoming step.
3. Deploy the fulfillment webhook provided in the functions folder using Google Cloud Functions for Firebase:
   1. Follow the instructions to set up and initialize Firebase SDK for Cloud Functions. Make sure to select the project that you have previously generated in the Actions on Google Console and to reply "N" when asked to overwrite existing files by the Firebase CLI.
   2. Run firebase deploy --only functions and take note of the endpoint where the fulfillment webhook has been published. It should look like Function URL (conversationComponent): https://us-central1-YOUR_PROJECT.cloudfunctions.net/conversationComponent
4. Update the action package, action.json, replacing the placeholder value YOUR_ENDPOINT_URL with the value for Function URL obtained from the previous step.
5. Install the gactions CLI if you haven't already.
6. Go back to the Actions console, copy the command shown in the Actions console, replace PACKAGE_NAME with "action.json" and execute it in a shell. The final command should look like gactions update --action_package action.json --project <YOUR_PROJECT_ID>
7. Click OK in the Actions console to dismiss the Use Actions SDK to add actions to your Assistant app dialog.
8. Open the Simulator in the Actions console.
9. Type "Talk to my test app" in the simulator, or say "OK Google, talk to my test app" to any Actions on Google enabled device signed into your developer account.

For more detailed information on deployment, see the documentation.

Steps for Dialogflow

1. Use the Actions on Google Console to add a new project with a name of your choosing.
2. Under Build a custom app, click BUILD in the Dialogflow box and then click Create Actions on Dialogflow.
3. Click Save to save the project.
4. Click on the gear icon to see the project settings.
5. Select Export and Import.
6. Select Restore from zip. Follow the directions to restore from the agent.zip file in this repo.
7. Deploy the fulfillment webhook provided in the functions folder using Google Cloud Functions for Firebase:
   1. Create a Firebase project in the Firebase Console if you don't have one already.
   2. Follow the instructions to set up and initialize Firebase SDK for Cloud Functions. Make sure to reply "N" when asked to overwrite existing files by the Firebase CLI. 1.Run firebase deploy --only functions and take note of the endpoint where the fulfillment webhook has been published. It should look like Function URL (conversationComponent): https://us-central1-YOUR_PROJECT.cloudfunctions.net/conversationComponent
8. Go back to the Dialogflow console and select Fulfillment from the left navigation menu. Enable Webhook, set the value of URL to the Function URL from the previous step, then click Save.
9. Select Integrations from the left navigation menu and open the Settings menu for Actions on Google.
10. Click Test.
11. Click View to open the Actions on Google simulator.
12. Type Talk to my test app in the simulator, or say OK Google, talk to my test app to any Actions on Google enabled device signed into your developer account.

For more detailed information on deployment, see the documentation.

References and How to report bugs

• Actions on Google documentation: https://developers.google.com/actions/.
• If you find any issues, please open a bug here on GitHub.
• Questions are answered on StackOverflow.

How to make contributions?

Please read and follow the steps in the CONTRIBUTING.md.

License

See LICENSE.

Terms

Your use of this sample is subject to, and by using or downloading the sample files you agree to comply with, the Google APIs Terms of Service.

Google+

Actions on Google Developers Community on Google+ https://g.co/actionsdev.