feat: added dialogflow_assist_answer (#641)

* feat: added dialogflow_assist_answer feat: added session_ttl feat: added human_agent_side_config feat: added suggestion_input feat: added suggest_dialogflow_assists_response feat: added suggest_entity_extraction_response PiperOrigin-RevId: 542021587 Source-Link: googleapis/googleapis@f40416d Source-Link: https://github.com/googleapis/googleapis-gen/commit/04ca491dec8f35173ee599d7ed07936b4086e96d Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMDRjYTQ5MWRlYzhmMzUxNzNlZTU5OWQ3ZWQwNzkzNmI0MDg2ZTk2ZCJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * feat: added dialogflow_assist_answer feat: added session_ttl feat: added human_agent_side_config feat: added suggestion_input feat: added suggest_dialogflow_assists_response feat: added suggest_entity_extraction_response PiperOrigin-RevId: 542024928 Source-Link: googleapis/googleapis@06f7999 Source-Link: https://github.com/googleapis/googleapis-gen/commit/0f124f3c37b5a6049906a9514cd994daf073dc01 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMGYxMjRmM2MzN2I1YTYwNDk5MDZhOTUxNGNkOTk0ZGFmMDczZGMwMSJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

google/cloud/dialogflow_v2/types/answer_record.py

@@ -222,9 +222,9 @@ class AnswerFeedback(proto.Message):
  clicked (bool):
  Indicates whether the answer/item was clicked
  by the human agent or not. Default to false.
- For knowledge search, the answer record is
- considered to be clicked if the answer was
- copied or any URI was clicked.
+ For knowledge search and knowledge assist, the
+ answer record is considered to be clicked if the
+ answer was copied or any URI was clicked.
  click_time (google.protobuf.timestamp_pb2.Timestamp):
  Time when the answer/item was clicked.
  displayed (bool):

google/cloud/dialogflow_v2/types/conversation.py

@@ -438,7 +438,8 @@ class SuggestConversationSummaryRequest(proto.Message):
  [latest_message] to use as context when compiling the
  suggestion. By default 500 and at most 1000.
  assist_query_params (google.cloud.dialogflow_v2.types.AssistQueryParameters):
- Parameters for a human assist query.
+ Parameters for a human assist query. Only
+ used for POC/demo purpose.
  """
 
  conversation: str = proto.Field(

google/cloud/dialogflow_v2/types/conversation_profile.py

@@ -17,6 +17,7 @@
 
 from typing import MutableMapping, MutableSequence
 
+from google.protobuf import duration_pb2 # type: ignore
 from google.protobuf import field_mask_pb2 # type: ignore
 from google.protobuf import timestamp_pb2 # type: ignore
 import proto # type: ignore
@@ -351,12 +352,24 @@ class AutomatedAgentConfig(proto.Message):
  ``projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/environments/<Environment ID or '-'>``.
  If environment is not specified, the default ``draft``
  environment is used.
+ session_ttl (google.protobuf.duration_pb2.Duration):
+ Optional. Sets Dialogflow CX session life
+ time. By default, a Dialogflow CX session
+ remains active and its data is stored for 30
+ minutes after the last request is sent for the
+ session. This value should be no longer than 1
+ day.
  """
 
  agent: str = proto.Field(
  proto.STRING,
  number=1,
  )
+ session_ttl: duration_pb2.Duration = proto.Field(
+ proto.MESSAGE,
+ number=3,
+ message=duration_pb2.Duration,
+ )
 
 
 class HumanAgentAssistantConfig(proto.Message):
@@ -539,7 +552,8 @@ class SuggestionQueryConfig(proto.Message):
  that all suggestions are returned.
 
  Supported features: ARTICLE_SUGGESTION, FAQ, SMART_REPLY,
- SMART_COMPOSE.
+ SMART_COMPOSE, KNOWLEDGE_SEARCH, KNOWLEDGE_ASSIST,
+ ENTITY_EXTRACTION.
  context_filter_settings (google.cloud.dialogflow_v2.types.HumanAgentAssistantConfig.SuggestionQueryConfig.ContextFilterSettings):
  Determines how recent conversation context is
  filtered when generating suggestions. If
@@ -589,7 +603,7 @@ class DialogflowQuerySource(proto.Message):
  agent (str):
  Required. The name of a Dialogflow virtual agent used for
  end user side intent detection and suggestion. Format:
- ``projects/<Project Number/ ID>/locations/<Location ID>/agent``.
+ ``projects/<Project ID>/locations/<Location ID>/agent``.
  When multiple agents are allowed in the same Dialogflow
  project.
  """

google/cloud/dialogflow_v2/types/document.py

@@ -109,7 +109,7 @@ class Document(proto.Message):
 
  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
+ with non-retriable errors (e.g. PERMISSION_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.
@@ -399,8 +399,8 @@ class ImportDocumentsRequest(proto.Message):
  Format:
  ``projects/<Project ID>/locations/<Location ID>/knowledgeBases/<Knowledge Base ID>``.
  gcs_source (google.cloud.dialogflow_v2.types.GcsSources):
- The Google Cloud Storage location for the documents. The
- path can include a wildcard.
+ Optional. The Google Cloud Storage location for the
+ documents. The path can include a wildcard.
 
  These URIs may have the forms
  ``gs://<bucket-name>/<object-name>``.

google/cloud/dialogflow_v2beta1/__init__.py

@@ -211,10 +211,13 @@
  CompileSuggestionRequest,
  CompileSuggestionResponse,
  CreateParticipantRequest,
+ DialogflowAssistAnswer,
  DtmfParameters,
  FaqAnswer,
  GetParticipantRequest,
  InputTextConfig,
+ IntentInput,
+ IntentSuggestion,
  ListParticipantsRequest,
  ListParticipantsResponse,
  ListSuggestionsRequest,
@@ -229,10 +232,12 @@
  StreamingAnalyzeContentResponse,
  SuggestArticlesRequest,
  SuggestArticlesResponse,
+ SuggestDialogflowAssistsResponse,
  SuggestFaqAnswersRequest,
  SuggestFaqAnswersResponse,
  Suggestion,
  SuggestionFeature,
+ SuggestionInput,
  SuggestionResult,
  SuggestSmartRepliesRequest,
  SuggestSmartRepliesResponse,
@@ -359,6 +364,7 @@
  "DeleteVersionRequest",
  "DetectIntentRequest",
  "DetectIntentResponse",
+ "DialogflowAssistAnswer",
  "Document",
  "DocumentsClient",
  "DtmfParameters",
@@ -407,6 +413,8 @@
  "InputTextConfig",
  "Intent",
  "IntentBatch",
+ "IntentInput",
+ "IntentSuggestion",
  "IntentView",
  "IntentsClient",
  "KnowledgeAnswers",
@@ -484,12 +492,14 @@
  "SuggestArticlesResponse",
  "SuggestConversationSummaryRequest",
  "SuggestConversationSummaryResponse",
+ "SuggestDialogflowAssistsResponse",
  "SuggestFaqAnswersRequest",
  "SuggestFaqAnswersResponse",
  "SuggestSmartRepliesRequest",
  "SuggestSmartRepliesResponse",
  "Suggestion",
  "SuggestionFeature",
+ "SuggestionInput",
  "SuggestionResult",
  "SynthesizeSpeechConfig",
  "TelephonyDtmf",

google/cloud/dialogflow_v2beta1/services/answer_records/async_client.py

@@ -70,6 +70,12 @@ class AnswerRecordsAsyncClient:
  parse_answer_record_path = staticmethod(
  AnswerRecordsClient.parse_answer_record_path
  )
+ context_path = staticmethod(AnswerRecordsClient.context_path)
+ parse_context_path = staticmethod(AnswerRecordsClient.parse_context_path)
+ document_path = staticmethod(AnswerRecordsClient.document_path)
+ parse_document_path = staticmethod(AnswerRecordsClient.parse_document_path)
+ intent_path = staticmethod(AnswerRecordsClient.intent_path)
+ parse_intent_path = staticmethod(AnswerRecordsClient.parse_intent_path)
  common_billing_account_path = staticmethod(
  AnswerRecordsClient.common_billing_account_path
  )

google/cloud/dialogflow_v2beta1/services/answer_records/client.py

@@ -202,6 +202,67 @@ def parse_answer_record_path(path: str) -> Dict[str, str]:
  )
  return m.groupdict() if m else {}
 
+ @staticmethod
+ def context_path(
+ project: str,
+ session: str,
+ context: str,
+ ) -> str:
+ """Returns a fully-qualified context string."""
+ return "projects/{project}/agent/sessions/{session}/contexts/{context}".format(
+ project=project,
+ session=session,
+ context=context,
+ )
+
+ @staticmethod
+ def parse_context_path(path: str) -> Dict[str, str]:
+ """Parses a context path into its component segments."""
+ m = re.match(
+ r"^projects/(?P<project>.+?)/agent/sessions/(?P<session>.+?)/contexts/(?P<context>.+?)$",
+ path,
+ )
+ return m.groupdict() if m else {}
+
+ @staticmethod
+ def document_path(
+ project: str,
+ knowledge_base: str,
+ document: str,
+ ) -> str:
+ """Returns a fully-qualified document string."""
+ return "projects/{project}/knowledgeBases/{knowledge_base}/documents/{document}".format(
+ project=project,
+ knowledge_base=knowledge_base,
+ document=document,
+ )
+
+ @staticmethod
+ def parse_document_path(path: str) -> Dict[str, str]:
+ """Parses a document path into its component segments."""
+ m = re.match(
+ r"^projects/(?P<project>.+?)/knowledgeBases/(?P<knowledge_base>.+?)/documents/(?P<document>.+?)$",
+ path,
+ )
+ return m.groupdict() if m else {}
+
+ @staticmethod
+ def intent_path(
+ project: str,
+ intent: str,
+ ) -> str:
+ """Returns a fully-qualified intent string."""
+ return "projects/{project}/agent/intents/{intent}".format(
+ project=project,
+ intent=intent,
+ )
+
+ @staticmethod
+ def parse_intent_path(path: str) -> Dict[str, str]:
+ """Parses a intent path into its component segments."""
+ m = re.match(r"^projects/(?P<project>.+?)/agent/intents/(?P<intent>.+?)$", path)
+ return m.groupdict() if m else {}
+
  @staticmethod
  def common_billing_account_path(
  billing_account: str,

google/cloud/dialogflow_v2beta1/services/environments/async_client.py

@@ -267,8 +267,8 @@ async def sample_list_environments():
  Required. The agent to list all environments from.
  Format:
 
- - ``projects/<Project Number / ID>/agent``
- - ``projects/<Project Number / ID>/locations/<Location ID>/agent``
+ - ``projects/<Project ID>/agent``
+ - ``projects/<Project ID>/locations/<Location ID>/agent``
 
  This corresponds to the ``parent`` field
  on the ``request`` instance; if ``request`` is provided, this

google/cloud/dialogflow_v2beta1/services/environments/client.py

@@ -525,8 +525,8 @@ def sample_list_environments():
  Required. The agent to list all environments from.
  Format:
 
- - ``projects/<Project Number / ID>/agent``
- - ``projects/<Project Number / ID>/locations/<Location ID>/agent``
+ - ``projects/<Project ID>/agent``
+ - ``projects/<Project ID>/locations/<Location ID>/agent``
 
  This corresponds to the ``parent`` field
  on the ``request`` instance; if ``request`` is provided, this

google/cloud/dialogflow_v2beta1/types/__init__.py

@@ -181,10 +181,13 @@
  CompileSuggestionRequest,
  CompileSuggestionResponse,
  CreateParticipantRequest,
+ DialogflowAssistAnswer,
  DtmfParameters,
  FaqAnswer,
  GetParticipantRequest,
  InputTextConfig,
+ IntentInput,
+ IntentSuggestion,
  ListParticipantsRequest,
  ListParticipantsResponse,
  ListSuggestionsRequest,
@@ -199,10 +202,12 @@
  StreamingAnalyzeContentResponse,
  SuggestArticlesRequest,
  SuggestArticlesResponse,
+ SuggestDialogflowAssistsResponse,
  SuggestFaqAnswersRequest,
  SuggestFaqAnswersResponse,
  Suggestion,
  SuggestionFeature,
+ SuggestionInput,
  SuggestionResult,
  SuggestSmartRepliesRequest,
  SuggestSmartRepliesResponse,
@@ -396,10 +401,13 @@
  "CompileSuggestionRequest",
  "CompileSuggestionResponse",
  "CreateParticipantRequest",
+ "DialogflowAssistAnswer",
  "DtmfParameters",
  "FaqAnswer",
  "GetParticipantRequest",
  "InputTextConfig",
+ "IntentInput",
+ "IntentSuggestion",
  "ListParticipantsRequest",
  "ListParticipantsResponse",
  "ListSuggestionsRequest",
@@ -414,10 +422,12 @@
  "StreamingAnalyzeContentResponse",
  "SuggestArticlesRequest",
  "SuggestArticlesResponse",
+ "SuggestDialogflowAssistsResponse",
  "SuggestFaqAnswersRequest",
  "SuggestFaqAnswersResponse",
  "Suggestion",
  "SuggestionFeature",
+ "SuggestionInput",
  "SuggestionResult",
  "SuggestSmartRepliesRequest",
  "SuggestSmartRepliesResponse",