docs: add detect intent with intent input snippet (#417)

WIP

packages/google-cloud-dialogflow-cx/samples/snippets/detect_intent_with_intent_input.py

@@ -0,0 +1,95 @@
+#!/usr/bin/env python
+
+# Copyright 2022 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
+#
+#      http://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 Detect Intent Python sample with specified intent."""
+
+
+# [START dialogflow_cx_v3_detect_intent_with_intent_input_async]
+import uuid
+
+from google.cloud.dialogflowcx_v3.services.intents import IntentsClient
+from google.cloud.dialogflowcx_v3.services.sessions import SessionsClient
+from google.cloud.dialogflowcx_v3.types import session
+
+
+def run_sample():
+    # TODO(developer): Update these values when running the function
+    project_id = "YOUR-PROJECT-ID"
+    location = "YOUR-LOCATION-ID"
+    agent_id = "YOUR-AGENT-ID"
+    intent_id = "YOUR-INTENT-ID"
+    language_code = "en-us"
+
+    detect_intent_with_intent_input(
+        project_id,
+        location,
+        agent_id,
+        intent_id,
+        language_code,
+    )
+
+
+def detect_intent_with_intent_input(
+    project_id,
+    location,
+    agent_id,
+    intent_id,
+    language_code,
+):
+    """Returns the result of detect intent with sentiment analysis"""
+    client_options = None
+    if location != "global":
+        api_endpoint = f"{location}-dialogflow.googleapis.com:443"
+        print(f"API Endpoint: {api_endpoint}\n")
+        client_options = {"api_endpoint": api_endpoint}
+    session_client = SessionsClient(client_options=client_options)
+    session_id = str(uuid.uuid4())
+    intents_client = IntentsClient()
+
+    session_path = session_client.session_path(
+        project=project_id,
+        location=location,
+        agent=agent_id,
+        session=session_id,
+    )
+    intent_path = intents_client.intent_path(
+        project=project_id,
+        location=location,
+        agent=agent_id,
+        intent=intent_id,
+    )
+
+    intent = session.IntentInput(intent=intent_path)
+    query_input = session.QueryInput(
+      intent=intent,
+      language_code=language_code
+    )
+    request = session.DetectIntentRequest(
+        session=session_path,
+        query_input=query_input,
+    )
+
+    response = session_client.detect_intent(request=request)
+    response_text = []
+    for response_message in response.query_result.response_messages:
+        response_text.append(response_message.text.text)
+        print(response_message.text.text)
+    return response_text
+# [END dialogflow_cx_v3_detect_intent_with_intent_input_async]
+
+
+if __name__ == "__main__":
+    run_sample()

packages/google-cloud-dialogflow-cx/samples/snippets/detect_intent_with_intent_input_test.py

@@ -0,0 +1,38 @@
+# Copyright 2022, 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
+#
+#    http://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.
+
+"""Tests for detect_intent_with_sentiment_analysis.py"""
+
+from __future__ import absolute_import
+
+import os
+
+from detect_intent_with_intent_input import detect_intent_with_intent_input
+
+
+PROJECT_ID = os.getenv("GOOGLE_CLOUD_PROJECT")
+AGENT_ID = os.getenv("AGENT_ID")
+INTENT_ID = os.getenv("INTENT_ID")
+
+
+def test_detect_intent_with_intent_input():
+    response_text = detect_intent_with_intent_input(
+        PROJECT_ID,
+        'global',
+        AGENT_ID,
+        INTENT_ID,
+        "en-us",
+    )
+    assert len(response_text) == 2
+    assert response_text[0] == ["Let's find a one-way ticket for you. "]
+    assert response_text[1] == ["Which city are you leaving from?"]