docs: add generated snippets (#473)

* chore: use gapic-generator-python 0.63.2
docs: add generated snippets

PiperOrigin-RevId: 427792504

Source-Link: googleapis/googleapis@55b9e1e

Source-Link: https://github.com/googleapis/googleapis-gen/commit/bf4e86b753f42cb0edb1fd51fbe840d7da0a1cde
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYmY0ZTg2Yjc1M2Y0MmNiMGVkYjFmZDUxZmJlODQwZDdkYTBhMWNkZSJ9

* 🦉 Updates from OwlBot

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/services/agents/async_client.py

@@ -209,6 +209,25 @@ async def get_agent(
     ) -> agent.Agent:
         r"""Retrieves the specified agent.
 
+        .. code-block::
+
+            from google.cloud import dialogflow_v2
+
+            def sample_get_agent():
+                # Create a client
+                client = dialogflow_v2.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflow_v2.GetAgentRequest(
+                    parent="parent_value",
+                )
+
+                # Make the request
+                response = client.get_agent(request=request)
+
+                # Handle the response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflow_v2.types.GetAgentRequest, dict]):
                 The request object. The request message for
@@ -293,6 +312,32 @@ async def set_agent(
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/es/docs/training>`__.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflow_v2
+
+            def sample_set_agent():
+                # Create a client
+                client = dialogflow_v2.AgentsClient()
+
+                # Initialize request argument(s)
+                agent = dialogflow_v2.Agent()
+                agent.parent = "parent_value"
+                agent.display_name = "display_name_value"
+                agent.default_language_code = "default_language_code_value"
+                agent.time_zone = "time_zone_value"
+
+                request = dialogflow_v2.SetAgentRequest(
+                    agent=agent,
+                )
+
+                # Make the request
+                response = client.set_agent(request=request)
+
+                # Handle the response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflow_v2.types.SetAgentRequest, dict]):
                 The request object. The request message for
@@ -373,6 +418,22 @@ async def delete_agent(
     ) -> None:
         r"""Deletes the specified agent.
 
+        .. code-block::
+
+            from google.cloud import dialogflow_v2
+
+            def sample_delete_agent():
+                # Create a client
+                client = dialogflow_v2.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflow_v2.DeleteAgentRequest(
+                    parent="parent_value",
+                )
+
+                # Make the request
+                client.delete_agent(request=request)
+
         Args:
             request (Union[google.cloud.dialogflow_v2.types.DeleteAgentRequest, dict]):
                 The request object. The request message for
@@ -443,6 +504,27 @@ async def search_agents(
         wildcard project collection id "-". Refer to `List
         Sub-Collections <https://cloud.google.com/apis/design/design_patterns#list_sub-collections>`__.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflow_v2
+
+            def sample_search_agents():
+                # Create a client
+                client = dialogflow_v2.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflow_v2.SearchAgentsRequest(
+                    parent="parent_value",
+                )
+
+                # Make the request
+                page_result = client.search_agents(request=request)
+
+                # Handle the response
+                for response in page_result:
+                    print(response)
+
         Args:
             request (Union[google.cloud.dialogflow_v2.types.SearchAgentsRequest, dict]):
                 The request object. The request message for
@@ -537,6 +619,30 @@ async def train_agent(
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/es/docs/training>`__.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflow_v2
+
+            def sample_train_agent():
+                # Create a client
+                client = dialogflow_v2.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflow_v2.TrainAgentRequest(
+                    parent="parent_value",
+                )
+
+                # Make the request
+                operation = client.train_agent(request=request)
+
+                print("Waiting for operation to complete...")
+
+                response = operation.result()
+
+                # Handle the response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflow_v2.types.TrainAgentRequest, dict]):
                 The request object. The request message for
@@ -639,6 +745,31 @@ async def export_agent(
         -  ``response``:
            [ExportAgentResponse][google.cloud.dialogflow.v2.ExportAgentResponse]
 
+
+        .. code-block::
+
+            from google.cloud import dialogflow_v2
+
+            def sample_export_agent():
+                # Create a client
+                client = dialogflow_v2.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflow_v2.ExportAgentRequest(
+                    parent="parent_value",
+                    agent_uri="agent_uri_value",
+                )
+
+                # Make the request
+                operation = client.export_agent(request=request)
+
+                print("Waiting for operation to complete...")
+
+                response = operation.result()
+
+                # Handle the response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflow_v2.types.ExportAgentRequest, dict]):
                 The request object. The request message for
@@ -749,6 +880,31 @@ async def import_agent(
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/es/docs/training>`__.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflow_v2
+
+            def sample_import_agent():
+                # Create a client
+                client = dialogflow_v2.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflow_v2.ImportAgentRequest(
+                    agent_uri="agent_uri_value",
+                    parent="parent_value",
+                )
+
+                # Make the request
+                operation = client.import_agent(request=request)
+
+                print("Waiting for operation to complete...")
+
+                response = operation.result()
+
+                # Handle the response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflow_v2.types.ImportAgentRequest, dict]):
                 The request object. The request message for
@@ -845,6 +1001,31 @@ async def restore_agent(
         queries. See the `training
         documentation <https://cloud.google.com/dialogflow/es/docs/training>`__.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflow_v2
+
+            def sample_restore_agent():
+                # Create a client
+                client = dialogflow_v2.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflow_v2.RestoreAgentRequest(
+                    agent_uri="agent_uri_value",
+                    parent="parent_value",
+                )
+
+                # Make the request
+                operation = client.restore_agent(request=request)
+
+                print("Waiting for operation to complete...")
+
+                response = operation.result()
+
+                # Handle the response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflow_v2.types.RestoreAgentRequest, dict]):
                 The request object. The request message for
@@ -917,6 +1098,26 @@ async def get_validation_result(
         performed during training time and is updated
         automatically when training is completed.
 
+
+        .. code-block::
+
+            from google.cloud import dialogflow_v2
+
+            def sample_get_validation_result():
+                # Create a client
+                client = dialogflow_v2.AgentsClient()
+
+                # Initialize request argument(s)
+                request = dialogflow_v2.GetValidationResultRequest(
+                    parent="parent_value",
+                )
+
+                # Make the request
+                response = client.get_validation_result(request=request)
+
+                # Handle the response
+                print(response)
+
         Args:
             request (Union[google.cloud.dialogflow_v2.types.GetValidationResultRequest, dict]):
                 The request object. The request message for