dialogflow.rb in google-cloud-dialogflow-0.3.0

- old
+ new

@@ -1,6 +1,6 @@
-# Copyright 2018 Google LLC
+# Copyright 2019 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
@@ -22,12 +22,12 @@
 
     ##
     # # Ruby Client for Dialogflow API ([Alpha](https://github.com/googleapis/google-cloud-ruby#versioning))
     #
     # [Dialogflow API][Product Documentation]:
-    # An end-to-end development suite for conversational interfaces (e.g.,
-    # chatbots, voice-powered apps and devices).
+    # Builds conversational interfaces (for example, chatbots, and voice-powered
+    # apps and devices).
     # - [Product Documentation][]
     #
     # ## Quick Start
     # In order to use this library, you first need to go through the following
     # steps:
@@ -99,23 +99,26 @@
         # manage the flow of a conversation and match user input to predefined intents
         # and actions.
         #
         # You can create an agent using both Dialogflow Standard Edition and
         # Dialogflow Enterprise Edition. For details, see
-        # [Dialogflow Editions](https://cloud.google.com/dialogflow-enterprise/docs/editions).
+        # [Dialogflow
+        # Editions](https://cloud.google.com/dialogflow-enterprise/docs/editions).
         #
         # You can save your agent for backup or versioning by exporting the agent by
         # using the {Google::Cloud::Dialogflow::V2::Agents::ExportAgent ExportAgent} method. You can import a saved
         # agent by using the {Google::Cloud::Dialogflow::V2::Agents::ImportAgent ImportAgent} method.
         #
         # Dialogflow provides several
-        # [prebuilt agents](https://dialogflow.com/docs/prebuilt-agents) for common
-        # conversation scenarios such as determining a date and time, converting
-        # currency, and so on.
+        # [prebuilt
+        # agents](https://cloud.google.com/dialogflow-enterprise/docs/agents-prebuilt)
+        # for common conversation scenarios such as determining a date and time,
+        # converting currency, and so on.
         #
         # For more information about agents, see the
-        # [Dialogflow documentation](https://dialogflow.com/docs/agents).
+        # [Dialogflow
+        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/agents-overview).
         #
         # @param version [Symbol, String]
         #   The major version of the service to be used. By default :v2
         #   is used.
         # @overload new(version:, credentials:, scopes:, client_config:, timeout:)
@@ -175,15 +178,16 @@
         # You can include contexts as input parameters of a
         # {Google::Cloud::Dialogflow::V2::Sessions::DetectIntent DetectIntent} (or
         # {Google::Cloud::Dialogflow::V2::Sessions::StreamingDetectIntent StreamingDetectIntent}) request,
         # or as output contexts included in the returned intent.
         # Contexts expire when an intent is matched, after the number of `DetectIntent`
-        # requests specified by the `lifespan_count` parameter, or after 10 minutes
+        # requests specified by the `lifespan_count` parameter, or after 20 minutes
         # if no intents are matched for a `DetectIntent` request.
         #
         # For more information about contexts, see the
-        # [Dialogflow documentation](https://dialogflow.com/docs/contexts).
+        # [Dialogflow
+        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/contexts-overview).
         #
         # @param version [Symbol, String]
         #   The major version of the service to be used. By default :v2
         #   is used.
         # @overload new(version:, credentials:, scopes:, client_config:, timeout:)
@@ -257,11 +261,12 @@
         # * **User** - entities that are built for an individual user such as
         #   favorites, preferences, playlists, and so on. A user entity is
         #   represented by the {Google::Cloud::Dialogflow::V2::SessionEntityType SessionEntityType} type.
         #
         # For more information about entity types, see the
-        # [Dialogflow documentation](https://dialogflow.com/docs/entities).
+        # [Dialogflow
+        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview).
         #
         # @param version [Symbol, String]
         #   The major version of the service to be used. By default :v2
         #   is used.
         # @overload new(version:, credentials:, scopes:, client_config:, timeout:)
@@ -323,11 +328,11 @@
         # match user input to an intent by adding the following to your intent.
         #
         # * **Contexts** - provide additional context for intent analysis. For
         #   example, if an intent is related to an object in your application that
         #   plays music, you can provide a context to determine when to match the
-        #   intent if the user input is “turn it off”.  You can include a context
+        #   intent if the user input is "turn it off". You can include a context
         #   that matches the intent when there is previous user input of
         #   "play music", and not when there is previous user input of
         #   "turn on the light".
         #
         # * **Events** - allow for matching an intent by using an event name
@@ -339,11 +344,12 @@
         #
         # * **Training phrases** - provide examples of user input to train the
         #   Dialogflow API agent to better match intents.
         #
         # For more information about intents, see the
-        # [Dialogflow documentation](https://dialogflow.com/docs/intents).
+        # [Dialogflow
+        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/intents-overview).
         #
         # @param version [Symbol, String]
         #   The major version of the service to be used. By default :v2
         #   is used.
         # @overload new(version:, credentials:, scopes:, client_config:, timeout:)
@@ -402,10 +408,11 @@
         # entities that are built for an individual user such as
         # favorites, preferences, playlists, and so on. You can redefine a session
         # entity type at the session level.
         #
         # For more information about entity types, see the
-        # [Dialogflow documentation](https://dialogflow.com/docs/entities).
+        # [Dialogflow
+        # documentation](https://cloud.google.com/dialogflow-enterprise/docs/entities-overview).
         #
         # @param version [Symbol, String]
         #   The major version of the service to be used. By default :v2
         #   is used.
         # @overload new(version:, credentials:, scopes:, client_config:, timeout:)