├── .gitignore ├── CONTRIBUTING.md ├── LICENSE ├── README.md └── images ├── deploy.png └── overview.png /.gitignore: -------------------------------------------------------------------------------- 1 | .DS_Store -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # How to become a contributor and submit your own code 2 | ## Contributor License Agreements 3 | We'd love to accept your sample apps and patches! Before we can take them, we 4 | have to jump a couple of legal hurdles. 5 | Please fill out either the individual or corporate Contributor License Agreement 6 | (CLA). 7 | * If you are an individual writing original source code and you're sure you 8 | own the intellectual property, then you'll need to sign an [individual CLA](https://developers.google.com/open-source/cla/individual). 9 | * If you work for a company that wants to allow you to contribute your work, 10 | then you'll need to sign a [corporate CLA](https://developers.google.com/open-source/cla/corporate). 11 | Follow either of the two links above to access the appropriate CLA and 12 | instructions for how to sign and return it. Once we receive it, we'll be able to 13 | accept your pull requests. 14 | ## Contributing A Patch 15 | 1. Submit an issue describing your proposed change to the repo in question. 16 | 1. The repo owner will respond to your issue promptly. 17 | 1. If your proposed change is accepted, and you haven't already done so, sign a 18 | Contributor License Agreement (see details above). 19 | 1. Fork the desired repo, develop and test your code changes. 20 | 1. Ensure that your code adheres to the existing style in the sample to which 21 | you are contributing. Refer to the 22 | [Google Cloud Platform Samples Style Guide](https://github.com/GoogleCloudPlatform/Template/wiki/style.html) for the 23 | recommended coding standards for this organization. 24 | 1. Ensure that your code has an appropriate set of unit tests which all pass. 25 | 1. Submit a pull request. -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 5 | 1. Definitions. 6 | "License" shall mean the terms and conditions for use, reproduction, and 7 | distribution as defined by Sections 1 through 9 of this document. 8 | "Licensor" shall mean the copyright owner or entity authorized by the copyright 9 | owner that is granting the License. 10 | "Legal Entity" shall mean the union of the acting entity and all other entities 11 | that control, are controlled by, or are under common control with that entity. 12 | For the purposes of this definition, "control" means (i) the power, direct or 13 | indirect, to cause the direction or management of such entity, whether by 14 | contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the 15 | outstanding shares, or (iii) beneficial ownership of such entity. 16 | "You" (or "Your") shall mean an individual or Legal Entity exercising 17 | permissions granted by this License. 18 | "Source" form shall mean the preferred form for making modifications, including 19 | but not limited to software source code, documentation source, and configuration 20 | files. 21 | "Object" form shall mean any form resulting from mechanical transformation or 22 | translation of a Source form, including but not limited to compiled object code, 23 | generated documentation, and conversions to other media types. 24 | "Work" shall mean the work of authorship, whether in Source or Object form, made 25 | available under the License, as indicated by a copyright notice that is included 26 | in or attached to the work (an example is provided in the Appendix below). 27 | "Derivative Works" shall mean any work, whether in Source or Object form, that 28 | is based on (or derived from) the Work and for which the editorial revisions, 29 | annotations, elaborations, or other modifications represent, as a whole, an 30 | original work of authorship. For the purposes of this License, Derivative Works 31 | shall not include works that remain separable from, or merely link (or bind by 32 | name) to the interfaces of, the Work and Derivative Works thereof. 33 | "Contribution" shall mean any work of authorship, including the original version 34 | of the Work and any modifications or additions to that Work or Derivative Works 35 | thereof, that is intentionally submitted to Licensor for inclusion in the Work 36 | by the copyright owner or by an individual or Legal Entity authorized to submit 37 | on behalf of the copyright owner. For the purposes of this definition, 38 | "submitted" means any form of electronic, verbal, or written communication sent 39 | to the Licensor or its representatives, including but not limited to 40 | communication on electronic mailing lists, source code control systems, and 41 | issue tracking systems that are managed by, or on behalf of, the Licensor for 42 | the purpose of discussing and improving the Work, but excluding communication 43 | that is conspicuously marked or otherwise designated in writing by the copyright 44 | owner as "Not a Contribution." 45 | "Contributor" shall mean Licensor and any individual or Legal Entity on behalf 46 | of whom a Contribution has been received by Licensor and subsequently 47 | incorporated within the Work. 48 | 2. Grant of Copyright License. 49 | Subject to the terms and conditions of this License, each Contributor hereby 50 | grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, 51 | irrevocable copyright license to reproduce, prepare Derivative Works of, 52 | publicly display, publicly perform, sublicense, and distribute the Work and such 53 | Derivative Works in Source or Object form. 54 | 3. Grant of Patent License. 55 | Subject to the terms and conditions of this License, each Contributor hereby 56 | grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, 57 | irrevocable (except as stated in this section) patent license to make, have 58 | made, use, offer to sell, sell, import, and otherwise transfer the Work, where 59 | such license applies only to those patent claims licensable by such Contributor 60 | that are necessarily infringed by their Contribution(s) alone or by combination 61 | of their Contribution(s) with the Work to which such Contribution(s) was 62 | submitted. If You institute patent litigation against any entity (including a 63 | cross-claim or counterclaim in a lawsuit) alleging that the Work or a 64 | Contribution incorporated within the Work constitutes direct or contributory 65 | patent infringement, then any patent licenses granted to You under this License 66 | for that Work shall terminate as of the date such litigation is filed. 67 | 4. Redistribution. 68 | You may reproduce and distribute copies of the Work or Derivative Works thereof 69 | in any medium, with or without modifications, and in Source or Object form, 70 | provided that You meet the following conditions: 71 | You must give any other recipients of the Work or Derivative Works a copy of 72 | this License; and 73 | You must cause any modified files to carry prominent notices stating that You 74 | changed the files; and 75 | You must retain, in the Source form of any Derivative Works that You distribute, 76 | all copyright, patent, trademark, and attribution notices from the Source form 77 | of the Work, excluding those notices that do not pertain to any part of the 78 | Derivative Works; and 79 | If the Work includes a "NOTICE" text file as part of its distribution, then any 80 | Derivative Works that You distribute must include a readable copy of the 81 | attribution notices contained within such NOTICE file, excluding those notices 82 | that do not pertain to any part of the Derivative Works, in at least one of the 83 | following places: within a NOTICE text file distributed as part of the 84 | Derivative Works; within the Source form or documentation, if provided along 85 | with the Derivative Works; or, within a display generated by the Derivative 86 | Works, if and wherever such third-party notices normally appear. The contents of 87 | the NOTICE file are for informational purposes only and do not modify the 88 | License. You may add Your own attribution notices within Derivative Works that 89 | You distribute, alongside or as an addendum to the NOTICE text from the Work, 90 | provided that such additional attribution notices cannot be construed as 91 | modifying the License. 92 | You may add Your own copyright statement to Your modifications and may provide 93 | additional or different license terms and conditions for use, reproduction, or 94 | distribution of Your modifications, or for any such Derivative Works as a whole, 95 | provided Your use, reproduction, and distribution of the Work otherwise complies 96 | with the conditions stated in this License. 97 | 5. Submission of Contributions. 98 | Unless You explicitly state otherwise, any Contribution intentionally submitted 99 | for inclusion in the Work by You to the Licensor shall be under the terms and 100 | conditions of this License, without any additional terms or conditions. 101 | Notwithstanding the above, nothing herein shall supersede or modify the terms of 102 | any separate license agreement you may have executed with Licensor regarding 103 | such Contributions. 104 | 6. Trademarks. 105 | This License does not grant permission to use the trade names, trademarks, 106 | service marks, or product names of the Licensor, except as required for 107 | reasonable and customary use in describing the origin of the Work and 108 | reproducing the content of the NOTICE file. 109 | 7. Disclaimer of Warranty. 110 | Unless required by applicable law or agreed to in writing, Licensor provides the 111 | Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, 112 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, 113 | including, without limitation, any warranties or conditions of TITLE, 114 | NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are 115 | solely responsible for determining the appropriateness of using or 116 | redistributing the Work and assume any risks associated with Your exercise of 117 | permissions under this License. 118 | 8. Limitation of Liability. 119 | In no event and under no legal theory, whether in tort (including negligence), 120 | contract, or otherwise, unless required by applicable law (such as deliberate 121 | and grossly negligent acts) or agreed to in writing, shall any Contributor be 122 | liable to You for damages, including any direct, indirect, special, incidental, 123 | or consequential damages of any character arising as a result of this License or 124 | out of the use or inability to use the Work (including but not limited to 125 | damages for loss of goodwill, work stoppage, computer failure or malfunction, or 126 | any and all other commercial damages or losses), even if such Contributor has 127 | been advised of the possibility of such damages. 128 | 9. Accepting Warranty or Additional Liability. 129 | While redistributing the Work or Derivative Works thereof, You may choose to 130 | offer, and charge a fee for, acceptance of support, warranty, indemnity, or 131 | other liability obligations and/or rights consistent with this License. However, 132 | in accepting such obligations, You may act only on Your own behalf and on Your 133 | sole responsibility, not on behalf of any other Contributor, and only if You 134 | agree to indemnify, defend, and hold each Contributor harmless for any liability 135 | incurred by, or claims asserted against, such Contributor by reason of your 136 | accepting any such warranty or additional liability. 137 | END OF TERMS AND CONDITIONS 138 | APPENDIX: How to apply the Apache License to your work 139 | To apply the Apache License to your work, attach the following boilerplate 140 | notice, with the fields enclosed by brackets "[]" replaced with your own 141 | identifying information. (Don't include the brackets!) The text should be 142 | enclosed in the appropriate comment syntax for the file format. We also 143 | recommend that a file or class name and description of purpose be included on 144 | the same "printed page" as the copyright notice for easier identification within 145 | third-party archives. 146 | Copyright [yyyy] [name of copyright owner] 147 | Licensed under the Apache License, Version 2.0 (the "License"); 148 | you may not use this file except in compliance with the License. 149 | You may obtain a copy of the License at 150 | http://www.apache.org/licenses/LICENSE-2.0 151 | Unless required by applicable law or agreed to in writing, software 152 | distributed under the License is distributed on an "AS IS" BASIS, 153 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 154 | See the License for the specific language governing permissions and 155 | limitations under the License. 156 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Dialogflow libraries and samples 2 | Dialogflow's APIs allow you to take action on your own systems based on conversational input, embed your conversational interface into your app or website, and dynamically change your agent's behavior. Dialogflow APIs center around three primary use cases: 3 | 4 |  5 | 6 | * **Fulfillment**: take action on your own systems based on conversational input. You can do things like querying a database or API to provide info to your users with any integration (Actions on Google, Slack, etc.) 7 | * **Detect Intent API**: Embed your conversational interface built with Dialogflow into your app, website or device. Call this API with a user's query to get back how your DIalogflow agent's response 8 | * **Agent API**: Dynamically change your agent's behavior by editing your agent's intents, entities and contexts. Do anything you can through Dialogflow console programmatically with Dialogflow's agent APIs. 9 | 10 | ## Fulfillment 11 | Fulfillment is code that's deployed as a webhook that lets your Dialogflow agent call business logic on an intent-by-intent basis. During a conversation, fulfillment allows you to use the information extracted by Dialogflow's natural language processing to generate dynamic responses or trigger actions on your back-end. 12 | 13 | Most Dialogflow agents make use of fulfillment to do things like: generate dynamic responses based on information looked up from a database, place orders based on products a customer has asked for, implement the rules and winning conditions for a game. 14 | 15 | ### Library 16 | 17 | | **Platform** | **Package Manager** | **Quick Start** | **Getting Started** | 18 | |--------------|---------------------|-----------------|---------------------| 19 | | [Node.js](https://github.com/dialogflow/dialogflow-fulfillment-nodejs) | [npm](https://npmjs.org/package/dialogflow-fulfillment) | [Quick Start Guide](https://github.com/dialogflow/dialogflow-fulfillment-nodejs#quick-start) | [Getting Started Guide](/docs/getting-started/building-your-first-agent) | 20 | 21 | Note: For all other platforms please see API reference for a [webhook request](https://dialogflow.com/docs/reference/api-v2/rest/v2beta1/WebhookRequest) and [response](https://dialogflow.com/docs/reference/api-v2/rest/v2beta1/WebhookResponse). 22 | 23 | ### Samples 24 |
Name | 27 |Description | 28 |29 | |
---|---|---|
Node.js | 32 |||
Actions on Google | 35 |Sample demonstrating how to use both the Dialogflow fulfillment library and the Actions on Google client library together. | 36 |![]() |
Bike Shop | 40 |Dive into making a agent for a small business like this appointment scheudling bike shop | 41 |![]() |
42 |
FAQ | 45 |Description: Sample desmonstrating how to use Knowledge Connectors, the Telephony Gateway and Actions on Google together. | 46 |47 | |
Firestore | 50 |Sample demonstrating how to connect a Dialogflow agent to Firebase's Firestore database. | 51 |![]() |
52 |
Human-agent Handoff | 55 |This sample consists of a simple API.AI agent, a node.js server and a web interface that together demonstrate an approach for handing text-based conversations from an API.AI agent to a human operator." | 56 |57 | |
Import | 60 |A simple sample showing how to use Dialogflow's Importer for Alexa Skills to import a Alexa Skill to Dialogflow and deploy it to the Google Assistant." | 61 |62 | |
Multi locale/language | 65 |Create and fulfill a multilignual and multilocale agent with this French and English speaking sample | 66 |![]() |
67 |
Quick Start | 70 |Get started quickly with fulfillment with this basic code | 71 |![]() |
72 |
Regular expression entity validation. | 75 |Sample demonstrating how to validate a entity with a regular expression in fulfillment. | 76 | ![]() |
77 |
Temperature Converter Trivia | 80 |Learn how intent, entities, contexts and rich responses work with this sample that converts temperatures with trivia along the way | 81 |![]() |
82 |
Weather | 85 |Make a API call from fulfillment to give user's relevant information like the weather | 86 |![]() |
87 |
Python/Flask | 90 |||
Translate | 93 |Get information from the user in the form of Dialogflow parameters and make an API call with the data to translate user's speech from one language to another | 94 |95 | |
Weather | 98 |Make a API call from fulfillment to give user's relevant information like the weather | 99 |100 | |
JSON | 103 |||
Webhook Request & Response | 106 |This sample shows Dialogflow's fulfillment webhook JSON requests and responses for v1 & v2 agents, including Actions on Google-specific requests & resposnes" | 107 |108 | |