google-cloud-dialogflow-v2 0.6.0 → 0.7.0

data/proto_docs/google/cloud/dialogflow/v2/document.rb

@@ -0,0 +1,267 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        # A knowledge document to be used by a {::Google::Cloud::Dialogflow::V2::KnowledgeBase KnowledgeBase}.
+        #
+        # For more information, see the [knowledge base
+        # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
+        #
+        # Note: The `projects.agent.knowledgeBases.documents` resource is deprecated;
+        # only use `projects.knowledgeBases.documents`.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Optional. The document resource name.
+        #     The name must be empty when creating a document.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/knowledgeBases/<Knowledge Base ID>/documents/<Document ID>`.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. The display name of the document. The name must be 1024 bytes or
+        #     less; otherwise, the creation request fails.
+        # @!attribute [rw] mime_type
+        #   @return [::String]
+        #     Required. The MIME type of this document.
+        # @!attribute [rw] knowledge_types
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::Document::KnowledgeType>]
+        #     Required. The knowledge type of document content.
+        # @!attribute [rw] content_uri
+        #   @return [::String]
+        #     The URI where the file content is located.
+        #
+        #     For documents stored in Google Cloud Storage, these URIs must have
+        #     the form `gs://<bucket-name>/<object-name>`.
+        #
+        #     NOTE: External URLs must correspond to public webpages, i.e., they must
+        #     be indexed by Google Search. In particular, URLs for showing documents in
+        #     Google Cloud Storage (i.e. the URL in your browser) are not supported.
+        #     Instead use the `gs://` format URI described above.
+        # @!attribute [rw] raw_content
+        #   @return [::String]
+        #     The raw content of the document. This field is only permitted for
+        #     EXTRACTIVE_QA and FAQ knowledge types.
+        # @!attribute [rw] enable_auto_reload
+        #   @return [::Boolean]
+        #     Optional. If true, we try to automatically reload the document every day
+        #     (at a time picked by the system). If false or unspecified, we don't try
+        #     to automatically reload the document.
+        #
+        #     Currently you can only enable automatic reload for documents sourced from
+        #     a public url, see `source` field for the source types.
+        #
+        #     Reload status can be tracked in `latest_reload_status`. If a reload
+        #     fails, we will keep the document unchanged.
+        #
+        #     If a reload fails with internal errors, the system will try to reload the
+        #     document on the next day.
+        #     If a reload fails with non-retriable errors (e.g. PERMISION_DENIED), the
+        #     system will not try to reload the document anymore. You need to manually
+        #     reload the document successfully by calling `ReloadDocument` and clear the
+        #     errors.
+        # @!attribute [r] latest_reload_status
+        #   @return [::Google::Cloud::Dialogflow::V2::Document::ReloadStatus]
+        #     Output only. The time and status of the latest reload.
+        #     This reload may have been triggered automatically or manually
+        #     and may not have succeeded.
+        # @!attribute [rw] metadata
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Metadata for the document. The metadata supports arbitrary
+        #     key-value pairs. Suggested use cases include storing a document's title,
+        #     an external URL distinct from the document's content_uri, etc.
+        #     The max size of a `key` or a `value` of the metadata is 1024 bytes.
+        class Document
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The status of a reload attempt.
+          # @!attribute [rw] time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     The time of a reload attempt.
+          #     This reload may have been triggered automatically or manually and may
+          #     not have succeeded.
+          # @!attribute [rw] status
+          #   @return [::Google::Rpc::Status]
+          #     The status of a reload attempt or the initial load.
+          class ReloadStatus
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class MetadataEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The knowledge type of document content.
+          module KnowledgeType
+            # The type is unspecified or arbitrary.
+            KNOWLEDGE_TYPE_UNSPECIFIED = 0
+
+            # The document content contains question and answer pairs as either HTML or
+            # CSV. Typical FAQ HTML formats are parsed accurately, but unusual formats
+            # may fail to be parsed.
+            #
+            # CSV must have questions in the first column and answers in the second,
+            # with no header. Because of this explicit format, they are always parsed
+            # accurately.
+            FAQ = 1
+
+            # Documents for which unstructured text is extracted and used for
+            # question answering.
+            EXTRACTIVE_QA = 2
+
+            # The entire document content as a whole can be used for query results.
+            # Only for Contact Center Solutions on Dialogflow.
+            ARTICLE_SUGGESTION = 3
+          end
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::Documents::Client#get_document Documents.GetDocument}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the document to retrieve.
+        #     Format `projects/<Project ID>/locations/<Location
+        #     ID>/knowledgeBases/<Knowledge Base ID>/documents/<Document ID>`.
+        class GetDocumentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::Documents::Client#list_documents Documents.ListDocuments}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The knowledge base to list all documents for.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/knowledgeBases/<Knowledge Base ID>`.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of items to return in a single page. By
+        #     default 10 and at most 100.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     The next_page_token value returned from a previous list request.
+        class ListDocumentsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for {::Google::Cloud::Dialogflow::V2::Documents::Client#list_documents Documents.ListDocuments}.
+        # @!attribute [rw] documents
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::Document>]
+        #     The list of documents.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Token to retrieve the next page of results, or empty if there are no
+        #     more results in the list.
+        class ListDocumentsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::Documents::Client#create_document Documents.CreateDocument}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The knowledge base to create a document for.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/knowledgeBases/<Knowledge Base ID>`.
+        # @!attribute [rw] document
+        #   @return [::Google::Cloud::Dialogflow::V2::Document]
+        #     Required. The document to create.
+        class CreateDocumentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::Documents::Client#delete_document Documents.DeleteDocument}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the document to delete.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/knowledgeBases/<Knowledge Base ID>/documents/<Document ID>`.
+        class DeleteDocumentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::Documents::Client#update_document Documents.UpdateDocument}.
+        # @!attribute [rw] document
+        #   @return [::Google::Cloud::Dialogflow::V2::Document]
+        #     Required. The document to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. Not specified means `update all`.
+        #     Currently, only `display_name` can be updated, an InvalidArgument will be
+        #     returned for attempting to update other fields.
+        class UpdateDocumentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::Documents::Client#reload_document Documents.ReloadDocument}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the document to reload.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/knowledgeBases/<Knowledge Base ID>/documents/<Document ID>`
+        # @!attribute [rw] content_uri
+        #   @return [::String]
+        #     Optional. The path of gcs source file for reloading document content. For now,
+        #     only gcs uri is supported.
+        #
+        #     For documents stored in Google Cloud Storage, these URIs must have
+        #     the form `gs://<bucket-name>/<object-name>`.
+        class ReloadDocumentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Metadata in google::longrunning::Operation for Knowledge operations.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeOperationMetadata::State]
+        #     Output only. The current state of this operation.
+        class KnowledgeOperationMetadata
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # States of the operation.
+          module State
+            # State unspecified.
+            STATE_UNSPECIFIED = 0
+
+            # The operation has been created.
+            PENDING = 1
+
+            # The operation is currently running.
+            RUNNING = 2
+
+            # The operation is done, either cancelled or completed.
+            DONE = 3
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/dialogflow/v2/entity_type.rb

@@ -21,9 +21,18 @@ module Google
   module Cloud
     module Dialogflow
       module V2
-        # Represents an entity type.
-        # Entity types serve as a tool for extracting parameter values from natural
-        # language queries.
+        # Each intent parameter has a type, called the entity type, which dictates
+        # exactly how data from an end-user expression is extracted.
+        #
+        # Dialogflow provides predefined system entities that can match many common
+        # types of data. For example, there are system entities for matching dates,
+        # times, colors, email addresses, and so on. You can also create your own
+        # custom entities for matching custom data. For example, you could define a
+        # vegetable entity that can match the types of vegetables available for
+        # purchase with a grocery store agent.
+        #
+        # For more information, see the
+        # [Entity guide](https://cloud.google.com/dialogflow/docs/entities-overview).
         # @!attribute [rw] name
         #   @return [::String]
         #     The unique identifier of the entity type.

data/proto_docs/google/cloud/dialogflow/v2/environment.rb

@@ -21,7 +21,24 @@ module Google
   module Cloud
     module Dialogflow
       module V2
-        # Represents an agent environment.
+        # You can create multiple versions of your agent and publish them to separate
+        # environments.
+        #
+        # When you edit an agent, you are editing the draft agent. At any point, you
+        # can save the draft agent as an agent version, which is an immutable snapshot
+        # of your agent.
+        #
+        # When you save the draft agent, it is published to the default environment.
+        # When you create agent versions, you can publish them to custom environments.
+        # You can create a variety of custom environments for:
+        #
+        # - testing
+        # - development
+        # - production
+        # - etc.
+        #
+        # For more information, see the [versions and environments
+        # guide](https://cloud.google.com/dialogflow/docs/agents-versions).
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The unique identifier of this agent environment.

data/proto_docs/google/cloud/dialogflow/v2/human_agent_assistant_event.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        # Represents a notification sent to Cloud Pub/Sub subscribers for
+        # human agent assistant events in a specific conversation.
+        # @!attribute [rw] conversation
+        #   @return [::String]
+        #     The conversation this notification refers to.
+        #     Format: `projects/<Project ID>/conversations/<Conversation ID>`.
+        # @!attribute [rw] participant
+        #   @return [::String]
+        #     The participant that the suggestion is compiled for.
+        #     Format: `projects/<Project ID>/conversations/<Conversation
+        #     ID>/participants/<Participant ID>`. It will not be set in legacy workflow.
+        # @!attribute [rw] suggestion_results
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::SuggestionResult>]
+        #     The suggestion results payload that this notification refers to.
+        class HumanAgentAssistantEvent
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/dialogflow/v2/intent.rb

@@ -21,9 +21,15 @@ module Google
   module Cloud
     module Dialogflow
       module V2
-        # Represents an intent.
-        # Intents convert a number of user expressions or patterns into an action. An
-        # action is an extraction of a user command or sentence semantics.
+        # An intent categorizes an end-user's intention for one conversation turn. For
+        # each agent, you define many intents, where your combined intents can handle a
+        # complete conversation. When an end-user writes or says something, referred to
+        # as an end-user expression or end-user input, Dialogflow matches the end-user
+        # input to the best intent in your agent. Matching an intent is also known as
+        # intent classification.
+        #
+        # For more information, see the [intent
+        # guide](https://cloud.google.com/dialogflow/docs/intents-overview).
         # @!attribute [rw] name
         #   @return [::String]
         #     Optional. The unique identifier of this intent.
@@ -55,6 +61,17 @@ module Google
         #     Note: If `ml_disabled` setting is set to true, then this intent is not
         #     taken into account during inference in `ML ONLY` match mode. Also,
         #     auto-markup in the UI is turned off.
+        # @!attribute [rw] live_agent_handoff
+        #   @return [::Boolean]
+        #     Optional. Indicates that a live agent should be brought in to handle the
+        #     interaction with the user. In most cases, when you set this flag to true,
+        #     you would also want to set end_interaction to true as well. Default is
+        #     false.
+        # @!attribute [rw] end_interaction
+        #   @return [::Boolean]
+        #     Optional. Indicates that this intent ends an interaction. Some integrations
+        #     (e.g., Actions on Google or Dialogflow phone gateway) use this information
+        #     to close interaction with an end user. Default is false.
         # @!attribute [rw] input_context_names
         #   @return [::Array<::String>]
         #     Optional. The list of context names required for this intent to be

data/proto_docs/google/cloud/dialogflow/v2/knowledge_base.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+# Copyright 2021 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
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module Dialogflow
+      module V2
+        # A knowledge base represents a collection of knowledge documents that you
+        # provide to Dialogflow. Your knowledge documents contain information that may
+        # be useful during conversations with end-users. Some Dialogflow features use
+        # knowledge bases when looking for a response to an end-user input.
+        #
+        # For more information, see the [knowledge base
+        # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
+        #
+        # Note: The `projects.agent.knowledgeBases` resource is deprecated;
+        # only use `projects.knowledgeBases`.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     The knowledge base resource name.
+        #     The name must be empty when creating a knowledge base.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/knowledgeBases/<Knowledge Base ID>`.
+        # @!attribute [rw] display_name
+        #   @return [::String]
+        #     Required. The display name of the knowledge base. The name must be 1024
+        #     bytes or less; otherwise, the creation request fails.
+        # @!attribute [rw] language_code
+        #   @return [::String]
+        #     Language which represents the KnowledgeBase. When the KnowledgeBase is
+        #     created/updated, expect this to be present for non en-us languages. When
+        #     unspecified, the default language code en-us applies.
+        class KnowledgeBase
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::KnowledgeBases::Client#list_knowledge_bases KnowledgeBases.ListKnowledgeBases}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The project to list of knowledge bases for.
+        #     Format: `projects/<Project ID>/locations/<Location ID>`.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     The maximum number of items to return in a single page. By
+        #     default 10 and at most 100.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     The next_page_token value returned from a previous list request.
+        class ListKnowledgeBasesRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for {::Google::Cloud::Dialogflow::V2::KnowledgeBases::Client#list_knowledge_bases KnowledgeBases.ListKnowledgeBases}.
+        # @!attribute [rw] knowledge_bases
+        #   @return [::Array<::Google::Cloud::Dialogflow::V2::KnowledgeBase>]
+        #     The list of knowledge bases.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Token to retrieve the next page of results, or empty if there are no
+        #     more results in the list.
+        class ListKnowledgeBasesResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::KnowledgeBases::Client#get_knowledge_base KnowledgeBases.GetKnowledgeBase}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the knowledge base to retrieve.
+        #     Format `projects/<Project ID>/locations/<Location
+        #     ID>/knowledgeBases/<Knowledge Base ID>`.
+        class GetKnowledgeBaseRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::KnowledgeBases::Client#create_knowledge_base KnowledgeBases.CreateKnowledgeBase}.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The project to create a knowledge base for.
+        #     Format: `projects/<Project ID>/locations/<Location ID>`.
+        # @!attribute [rw] knowledge_base
+        #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeBase]
+        #     Required. The knowledge base to create.
+        class CreateKnowledgeBaseRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::KnowledgeBases::Client#delete_knowledge_base KnowledgeBases.DeleteKnowledgeBase}.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the knowledge base to delete.
+        #     Format: `projects/<Project ID>/locations/<Location
+        #     ID>/knowledgeBases/<Knowledge Base ID>`.
+        # @!attribute [rw] force
+        #   @return [::Boolean]
+        #     Optional. Force deletes the knowledge base. When set to true, any documents
+        #     in the knowledge base are also deleted.
+        class DeleteKnowledgeBaseRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for {::Google::Cloud::Dialogflow::V2::KnowledgeBases::Client#update_knowledge_base KnowledgeBases.UpdateKnowledgeBase}.
+        # @!attribute [rw] knowledge_base
+        #   @return [::Google::Cloud::Dialogflow::V2::KnowledgeBase]
+        #     Required. The knowledge base to update.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     Optional. Not specified means `update all`.
+        #     Currently, only `display_name` can be updated, an InvalidArgument will be
+        #     returned for attempting to update other fields.
+        class UpdateKnowledgeBaseRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end