chore(dialogflow-cx): migrate code from googleapis/python-dialogflow-cx

.github/CODEOWNERS

@@ -44,10 +44,11 @@
 /dataproc/**/*                         @GoogleCloudPlatform/python-samples-reviewers
 /datastore/**/*                        @GoogleCloudPlatform/cloud-native-db-dpes @GoogleCloudPlatform/python-samples-reviewers
 /dialogflow/**/*                       @GoogleCloudPlatform/dee-data-ai @GoogleCloudPlatform/python-samples-reviewers
+/dialogflow-cx/**/*                    @GoogleCloudPlatform/python-samples-reviewers
 /dns/**/*                              @GoogleCloudPlatform/python-samples-reviewers
 /documentai/**/*                       @GoogleCloudPlatform/dee-data-ai  @GoogleCloudPlatform/python-samples-reviewers
 /endpoints/**/*                        @GoogleCloudPlatform/python-samples-reviewers
-/enterpriseknowledgegraph/**/*         @GoogleCloudPlatform/dee-data-ai @GoogleCloudPlatform/python-samples-reviewers 
+/enterpriseknowledgegraph/**/*         @GoogleCloudPlatform/dee-data-ai @GoogleCloudPlatform/python-samples-reviewers
 /eventarc/**/*                         @GoogleCloudPlatform/aap-dpes  @GoogleCloudPlatform/python-samples-reviewers
 /error_reporting/**/*                  @GoogleCloudPlatform/python-samples-reviewers
 /firestore/**/*                        @GoogleCloudPlatform/cloud-native-db-dpes @GoogleCloudPlatform/python-samples-reviewers

dialogflow-cx/README.rst

@@ -0,0 +1,221 @@
+
+.. This file is automatically generated. Do not edit this file directly.
+
+Dialogflow CX API Python Samples
+===============================================================================
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=/README.rst
+
+
+This directory contains samples for Dialogflow CX API. The `Dialogflow CX API`_ enables you to create conversational experiences across devices and platforms.
+
+
+
+
+.. _Dialogflow CX API: https://cloud.google.com/dialogflow/cx/docs/
+
+
+Setup
+-------------------------------------------------------------------------------
+
+
+
+Authentication
+++++++++++++++
+
+This sample requires you to have authentication setup. Refer to the
+`Authentication Getting Started Guide`_ for instructions on setting up
+credentials for applications.
+
+.. _Authentication Getting Started Guide:
+    https://cloud.google.com/docs/authentication/getting-started
+
+
+
+
+Install Dependencies
+++++++++++++++++++++
+
+#. Clone python-docs-samples and change directory to the sample directory you want to use.
+
+    .. code-block:: bash
+
+        $ git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git
+
+#. Install `pip`_ and `virtualenv`_ if you do not already have them. You may want to refer to the `Python Development Environment Setup Guide`_ for Google Cloud Platform for instructions.
+
+   .. _Python Development Environment Setup Guide:
+       https://cloud.google.com/python/setup
+
+#. Create a virtualenv. Samples are compatible with Python 3.6+.
+
+    .. code-block:: bash
+
+        $ virtualenv env
+        $ source env/bin/activate
+
+#. Install the dependencies needed to run the samples.
+
+    .. code-block:: bash
+
+        $ pip install -r requirements.txt
+
+.. _pip: https://pip.pypa.io/
+.. _virtualenv: https://virtualenv.pypa.io/
+
+
+
+
+
+
+Samples
+-------------------------------------------------------------------------------
+
+
+Detect Intent Text
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=/detect_intent_texts.py,/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python detect_intent_texts.py
+
+
+    usage: detect_intent_texts.py [-h] --agent AGENT [--session-id SESSION_ID]
+                                  [--language-code LANGUAGE_CODE]
+                                  texts [texts ...]
+
+    DialogFlow API Detect Intent Python sample with text inputs.
+
+    Examples:
+      python detect_intent_texts.py -h
+      python detect_intent_texts.py --agent AGENT   --session-id SESSION_ID   "hello" "book a meeting room" "Mountain View"
+      python detect_intent_texts.py --agent AGENT   --session-id SESSION_ID   "tomorrow" "10 AM" "2 hours" "10 people" "A" "yes"
+
+    positional arguments:
+      texts                 Text inputs.
+
+    optional arguments:
+      -h, --help            show this help message and exit
+      --agent AGENT         Agent resource name. Required.
+      --session-id SESSION_ID
+                            Identifier of the DetectIntent session. Defaults to a
+                            random UUID.
+      --language-code LANGUAGE_CODE
+                            Language code of the query. Defaults to "en-US".
+
+
+
+
+
+Detect Intent Audio
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=/detect_intent_audio.py,/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python detect_intent_audio.py
+
+
+    usage: detect_intent_audio.py [-h] --agent AGENT [--session-id SESSION_ID]
+                                  [--language-code LANGUAGE_CODE]
+                                  --audio-file-path AUDIO_FILE_PATH
+
+    DialogFlow API Detect Intent Python sample with audio file.
+
+    Examples:
+      python detect_intent_audio.py -h
+      python detect_intent_audio.py --agent AGENT   --session-id SESSION_ID --audio-file-path resources/hello.wav
+
+    optional arguments:
+      -h, --help            show this help message and exit
+      --agent AGENT         Agent resource name. Required.
+      --session-id SESSION_ID
+                            Identifier of the DetectIntent session. Defaults to a
+                            random UUID.
+      --language-code LANGUAGE_CODE
+                            Language code of the query. Defaults to "en-US".
+      --audio-file-path AUDIO_FILE_PATH
+                            Path to the audio file.
+
+
+
+
+
+Detect Intent Stream
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+.. image:: https://gstatic.com/cloudssh/images/open-btn.png
+   :target: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/GoogleCloudPlatform/python-docs-samples&page=editor&open_in_editor=/detect_intent_stream.py,/README.rst
+
+
+
+
+To run this sample:
+
+.. code-block:: bash
+
+    $ python detect_intent_stream.py
+
+
+    usage: detect_intent_stream.py [-h] --agent AGENT [--session-id SESSION_ID]
+                                   [--language-code LANGUAGE_CODE]
+                                   --audio-file-path AUDIO_FILE_PATH
+
+    DialogFlow API Detect Intent Python sample with audio files processed as an audio stream.
+
+    Examples:
+      python detect_intent_stream.py -h
+      python detect_intent_stream.py --agent AGENT   --session-id SESSION_ID --audio-file-path resources/hello.wav
+
+    optional arguments:
+      -h, --help            show this help message and exit
+      --agent AGENT         Agent resource name. Required.
+      --session-id SESSION_ID
+                            Identifier of the DetectIntent session. Defaults to a
+                            random UUID.
+      --language-code LANGUAGE_CODE
+                            Language code of the query. Defaults to "en-US".
+      --audio-file-path AUDIO_FILE_PATH
+                            Path to the audio file.
+
+
+
+
+
+
+
+
+
+The client library
+-------------------------------------------------------------------------------
+
+This sample uses the `Google Cloud Client Library for Python`_.
+You can read the documentation for more details on API usage and use GitHub
+to `browse the source`_ and  `report issues`_.
+
+.. _Google Cloud Client Library for Python:
+    https://googlecloudplatform.github.io/google-cloud-python/
+.. _browse the source:
+    https://github.com/GoogleCloudPlatform/google-cloud-python
+.. _report issues:
+    https://github.com/GoogleCloudPlatform/google-cloud-python/issues
+
+
+
+.. _Google Cloud SDK: https://cloud.google.com/sdk/

dialogflow-cx/README.rst.in

@@ -0,0 +1,25 @@
+# This file is used to generate README.rst
+
+product:
+  name: Dialogflow CX API
+  short_name: Dialogflow CX API
+  url: https://cloud.google.com/dialogflow/cx/docs/
+  description: >
+    The `Dialogflow CX API`_ enables you to create conversational experiences across devices and platforms.
+
+setup:
+- auth
+- install_deps
+
+samples:
+- name: Detect Intent Text
+  file: detect_intent_texts.py
+  show_help: True
+- name: Detect Intent Audio
+  file: detect_intent_audio.py
+  show_help: True
+- name: Detect Intent Stream
+  file: detect_intent_stream.py
+  show_help: True
+
+cloud_client_library: true

dialogflow-cx/create_agent.py

@@ -0,0 +1,40 @@
+# Copyright 2023 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.
+
+
+"""DialogFlow API Create Agent Sample"""
+
+## [START dialogflow_cx_create_agent_sample]
+from google.cloud.dialogflowcx_v3.services.agents.client import AgentsClient
+from google.cloud.dialogflowcx_v3.types.agent import Agent
+
+
+def create_agent(project_id, display_name):
+
+    parent = "projects/" + project_id + "/locations/global"
+
+    agents_client = AgentsClient()
+
+    agent = Agent(
+        display_name=display_name,
+        default_language_code="en",
+        time_zone="America/Los_Angeles",
+    )
+
+    response = agents_client.create_agent(request={"agent": agent, "parent": parent})
+
+    return response
+
+
+## [END dialogflow_cx_create_agent_sample]

dialogflow-cx/create_agent_test.py

@@ -0,0 +1,42 @@
+# Copyright 2023 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.
+
+"""Test for create_agent"""
+
+import os
+import uuid
+
+from google.cloud.dialogflowcx_v3.services.agents.client import AgentsClient
+from google.cloud.dialogflowcx_v3.types.agent import DeleteAgentRequest
+
+import pytest
+
+from create_agent import create_agent
+
+PROJECT_ID = os.getenv("GOOGLE_CLOUD_PROJECT")
+pytest.AGENT_PATH = ""
+
+
+def delete_agent(name):
+    agents_client = AgentsClient()
+    request = DeleteAgentRequest(name=name)
+    agents_client.delete_agent(request=request)
+
+
+def test_create_agent():
+    agentName = f"fake_agent_{uuid.uuid4()}"
+    response = create_agent(PROJECT_ID, agentName)
+    delete_agent(response.name)
+
+    assert response.display_name == agentName