google-apis-ces_v1 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: bf45178bf3c68ee20684f5f428ec6103cd30c68934e23dae9c935718726258ec
4
- data.tar.gz: 977cfabdd6487dd54535811523e00265f1b9520ec195cd204af64b0706bb899b
3
+ metadata.gz: 873278c671d2dd73502342cb7379aa4eba49f5517dfebfc9d926bea5e7e131b6
4
+ data.tar.gz: a87af2b5d2d64b8f52011862c8b78e7b4ddcaa11b985c5bd2b5b3b477b324c22
5
5
  SHA512:
6
- metadata.gz: 0a03b9e31664a8f19bd65047e51044583ffd84030bb3878e3a3c1280379bc9b37ef1d5ef164afac6376c334dac79d97aeba41b36edf3bdc96fa450004677229e
7
- data.tar.gz: df73ef5fb0e38b0d169728dc1d1ccde663a1ae28b26de32c0215ac7e4d3f3a63dceffb9c1f8775175d0aa72f5fb5d75d0fa37ca172214cb3fb8cfd059ba08a6f
6
+ metadata.gz: 53e24eb0fed81227aa3034e19bc3f09ee5f939290062c8ac19d83b221cbbf7eedb4734fe50d6d61aeb6a63984cf06ea6a1a7caa1ad32b40d4249354f66f872b7
7
+ data.tar.gz: 99e1c5ef68963bdc980ed20e1fc7e6bc1ce92a093a68631f223a3b149ab6f3bca869df12c9766df3abcee6b21026301906bb7868aee5f51db290525ba9c1a2fb
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Release history for google-apis-ces_v1
2
2
 
3
+ ### v0.6.0 (2026-04-26)
4
+
5
+ * Regenerated from discovery document revision 20260422
6
+
3
7
  ### v0.5.0 (2026-03-15)
4
8
 
5
9
  * Regenerated from discovery document revision 20260312
@@ -377,6 +377,12 @@ module Google
377
377
  class AgentTool
378
378
  include Google::Apis::Core::Hashable
379
379
 
380
+ # Optional. The resource name of the agent that is the entry point of the tool.
381
+ # Format: `projects/`project`/locations/`location`/agents/`agent``
382
+ # Corresponds to the JSON property `agent`
383
+ # @return [String]
384
+ attr_accessor :agent
385
+
380
386
  # Optional. Description of the tool's purpose.
381
387
  # Corresponds to the JSON property `description`
382
388
  # @return [String]
@@ -387,8 +393,9 @@ module Google
387
393
  # @return [String]
388
394
  attr_accessor :name
389
395
 
390
- # Optional. The resource name of the root agent that is the entry point of the
391
- # tool. Format: `projects/`project`/locations/`location`/agents/`agent``
396
+ # Optional. Deprecated: Use `agent` instead. The resource name of the root agent
397
+ # that is the entry point of the tool. Format: `projects/`project`/locations/`
398
+ # location`/agents/`agent``
392
399
  # Corresponds to the JSON property `rootAgent`
393
400
  # @return [String]
394
401
  attr_accessor :root_agent
@@ -399,6 +406,7 @@ module Google
399
406
 
400
407
  # Update properties of this object
401
408
  def update!(**args)
409
+ @agent = args[:agent] if args.key?(:agent)
402
410
  @description = args[:description] if args.key?(:description)
403
411
  @name = args[:name] if args.key?(:name)
404
412
  @root_agent = args[:root_agent] if args.key?(:root_agent)
@@ -1045,7 +1053,7 @@ module Google
1045
1053
  class BigQueryExportSettings
1046
1054
  include Google::Apis::Core::Hashable
1047
1055
 
1048
- # Optional. The BigQuery dataset to export the data to.
1056
+ # Optional. The BigQuery **dataset ID** to export the data to.
1049
1057
  # Corresponds to the JSON property `dataset`
1050
1058
  # @return [String]
1051
1059
  attr_accessor :dataset
@@ -1056,10 +1064,10 @@ module Google
1056
1064
  attr_accessor :enabled
1057
1065
  alias_method :enabled?, :enabled
1058
1066
 
1059
- # Optional. The project ID of the BigQuery dataset to export the data to. Note:
1060
- # If the BigQuery dataset is in a different project from the app, you should
1061
- # grant `roles/bigquery.admin` role to the CES service agent `service-@gcp-sa-
1062
- # ces.iam.gserviceaccount.com`.
1067
+ # Optional. The **project ID** of the BigQuery dataset to export the data to.
1068
+ # Note: If the BigQuery dataset is in a different project from the app, you
1069
+ # should grant `roles/bigquery.admin` role to the CES service agent `service-@
1070
+ # gcp-sa-ces.iam.gserviceaccount.com`.
1063
1071
  # Corresponds to the JSON property `project`
1064
1072
  # @return [String]
1065
1073
  attr_accessor :project
@@ -1857,6 +1865,12 @@ module Google
1857
1865
  attr_accessor :disable_conversation_logging
1858
1866
  alias_method :disable_conversation_logging?, :disable_conversation_logging
1859
1867
 
1868
+ # Optional. Controls the retention window for the conversation. If not set, the
1869
+ # conversation will be retained for 365 days.
1870
+ # Corresponds to the JSON property `retentionWindow`
1871
+ # @return [String]
1872
+ attr_accessor :retention_window
1873
+
1860
1874
  def initialize(**args)
1861
1875
  update!(**args)
1862
1876
  end
@@ -1864,6 +1878,7 @@ module Google
1864
1878
  # Update properties of this object
1865
1879
  def update!(**args)
1866
1880
  @disable_conversation_logging = args[:disable_conversation_logging] if args.key?(:disable_conversation_logging)
1881
+ @retention_window = args[:retention_window] if args.key?(:retention_window)
1867
1882
  end
1868
1883
  end
1869
1884
 
@@ -2478,6 +2493,11 @@ module Google
2478
2493
  # @return [String]
2479
2494
  attr_accessor :etag
2480
2495
 
2496
+ # Experiment for the deployment.
2497
+ # Corresponds to the JSON property `experimentConfig`
2498
+ # @return [Google::Apis::CesV1::ExperimentConfig]
2499
+ attr_accessor :experiment_config
2500
+
2481
2501
  # Identifier. The resource name of the deployment. Format: `projects/`project`/
2482
2502
  # locations/`location`/apps/`app`/deployments/`deployment``
2483
2503
  # Corresponds to the JSON property `name`
@@ -2500,6 +2520,7 @@ module Google
2500
2520
  @create_time = args[:create_time] if args.key?(:create_time)
2501
2521
  @display_name = args[:display_name] if args.key?(:display_name)
2502
2522
  @etag = args[:etag] if args.key?(:etag)
2523
+ @experiment_config = args[:experiment_config] if args.key?(:experiment_config)
2503
2524
  @name = args[:name] if args.key?(:name)
2504
2525
  @update_time = args[:update_time] if args.key?(:update_time)
2505
2526
  end
@@ -2659,18 +2680,83 @@ module Google
2659
2680
  class ErrorHandlingSettings
2660
2681
  include Google::Apis::Core::Hashable
2661
2682
 
2683
+ # Configuration for ending the session in case of system errors (e.g. LLM errors)
2684
+ # .
2685
+ # Corresponds to the JSON property `endSessionConfig`
2686
+ # @return [Google::Apis::CesV1::ErrorHandlingSettingsEndSessionConfig]
2687
+ attr_accessor :end_session_config
2688
+
2662
2689
  # Optional. The strategy to use for error handling.
2663
2690
  # Corresponds to the JSON property `errorHandlingStrategy`
2664
2691
  # @return [String]
2665
2692
  attr_accessor :error_handling_strategy
2666
2693
 
2694
+ # Configuration for handling fallback responses.
2695
+ # Corresponds to the JSON property `fallbackResponseConfig`
2696
+ # @return [Google::Apis::CesV1::ErrorHandlingSettingsFallbackResponseConfig]
2697
+ attr_accessor :fallback_response_config
2698
+
2667
2699
  def initialize(**args)
2668
2700
  update!(**args)
2669
2701
  end
2670
2702
 
2671
2703
  # Update properties of this object
2672
2704
  def update!(**args)
2705
+ @end_session_config = args[:end_session_config] if args.key?(:end_session_config)
2673
2706
  @error_handling_strategy = args[:error_handling_strategy] if args.key?(:error_handling_strategy)
2707
+ @fallback_response_config = args[:fallback_response_config] if args.key?(:fallback_response_config)
2708
+ end
2709
+ end
2710
+
2711
+ # Configuration for ending the session in case of system errors (e.g. LLM errors)
2712
+ # .
2713
+ class ErrorHandlingSettingsEndSessionConfig
2714
+ include Google::Apis::Core::Hashable
2715
+
2716
+ # Optional. Whether to escalate the session in EndSession. If session is
2717
+ # escalated, metadata in EndSession will contain `session_escalated = true`. See
2718
+ # https://docs.cloud.google.com/customer-engagement-ai/conversational-agents/ps/
2719
+ # deploy/google-telephony-platform#transfer_a_call_to_a_human_agent for details.
2720
+ # Corresponds to the JSON property `escalateSession`
2721
+ # @return [Boolean]
2722
+ attr_accessor :escalate_session
2723
+ alias_method :escalate_session?, :escalate_session
2724
+
2725
+ def initialize(**args)
2726
+ update!(**args)
2727
+ end
2728
+
2729
+ # Update properties of this object
2730
+ def update!(**args)
2731
+ @escalate_session = args[:escalate_session] if args.key?(:escalate_session)
2732
+ end
2733
+ end
2734
+
2735
+ # Configuration for handling fallback responses.
2736
+ class ErrorHandlingSettingsFallbackResponseConfig
2737
+ include Google::Apis::Core::Hashable
2738
+
2739
+ # Optional. The fallback messages in case of system errors (e.g. LLM errors),
2740
+ # mapped by [supported language code](https://docs.cloud.google.com/customer-
2741
+ # engagement-ai/conversational-agents/ps/reference/language).
2742
+ # Corresponds to the JSON property `customFallbackMessages`
2743
+ # @return [Hash<String,String>]
2744
+ attr_accessor :custom_fallback_messages
2745
+
2746
+ # Optional. The maximum number of fallback attempts to make before the agent
2747
+ # emitting EndSession Signal.
2748
+ # Corresponds to the JSON property `maxFallbackAttempts`
2749
+ # @return [Fixnum]
2750
+ attr_accessor :max_fallback_attempts
2751
+
2752
+ def initialize(**args)
2753
+ update!(**args)
2754
+ end
2755
+
2756
+ # Update properties of this object
2757
+ def update!(**args)
2758
+ @custom_fallback_messages = args[:custom_fallback_messages] if args.key?(:custom_fallback_messages)
2759
+ @max_fallback_attempts = args[:max_fallback_attempts] if args.key?(:max_fallback_attempts)
2674
2760
  end
2675
2761
  end
2676
2762
 
@@ -2924,6 +3010,11 @@ module Google
2924
3010
  # @return [Hash<String,Object>]
2925
3011
  attr_accessor :context
2926
3012
 
3013
+ # Mock tool calls configuration for the session.
3014
+ # Corresponds to the JSON property `mockConfig`
3015
+ # @return [Google::Apis::CesV1::MockConfig]
3016
+ attr_accessor :mock_config
3017
+
2927
3018
  # Optional. The name of the tool to execute. Format: projects/`project`/
2928
3019
  # locations/`location`/apps/`app`/tools/`tool`
2929
3020
  # Corresponds to the JSON property `tool`
@@ -2948,6 +3039,7 @@ module Google
2948
3039
  def update!(**args)
2949
3040
  @args = args[:args] if args.key?(:args)
2950
3041
  @context = args[:context] if args.key?(:context)
3042
+ @mock_config = args[:mock_config] if args.key?(:mock_config)
2951
3043
  @tool = args[:tool] if args.key?(:tool)
2952
3044
  @toolset_tool = args[:toolset_tool] if args.key?(:toolset_tool)
2953
3045
  @variables = args[:variables] if args.key?(:variables)
@@ -2995,6 +3087,84 @@ module Google
2995
3087
  end
2996
3088
  end
2997
3089
 
3090
+ # Experiment for the deployment.
3091
+ class ExperimentConfig
3092
+ include Google::Apis::Core::Hashable
3093
+
3094
+ # Version release for the experiment.
3095
+ # Corresponds to the JSON property `versionRelease`
3096
+ # @return [Google::Apis::CesV1::ExperimentConfigVersionRelease]
3097
+ attr_accessor :version_release
3098
+
3099
+ def initialize(**args)
3100
+ update!(**args)
3101
+ end
3102
+
3103
+ # Update properties of this object
3104
+ def update!(**args)
3105
+ @version_release = args[:version_release] if args.key?(:version_release)
3106
+ end
3107
+ end
3108
+
3109
+ # Version release for the experiment.
3110
+ class ExperimentConfigVersionRelease
3111
+ include Google::Apis::Core::Hashable
3112
+
3113
+ # Optional. State of the version release.
3114
+ # Corresponds to the JSON property `state`
3115
+ # @return [String]
3116
+ attr_accessor :state
3117
+
3118
+ # Optional. Traffic allocations for the version release.
3119
+ # Corresponds to the JSON property `trafficAllocations`
3120
+ # @return [Array<Google::Apis::CesV1::ExperimentConfigVersionReleaseTrafficAllocation>]
3121
+ attr_accessor :traffic_allocations
3122
+
3123
+ def initialize(**args)
3124
+ update!(**args)
3125
+ end
3126
+
3127
+ # Update properties of this object
3128
+ def update!(**args)
3129
+ @state = args[:state] if args.key?(:state)
3130
+ @traffic_allocations = args[:traffic_allocations] if args.key?(:traffic_allocations)
3131
+ end
3132
+ end
3133
+
3134
+ # Traffic allocation for the version release.
3135
+ class ExperimentConfigVersionReleaseTrafficAllocation
3136
+ include Google::Apis::Core::Hashable
3137
+
3138
+ # Optional. App version of the traffic allocation. Format: `projects/`project`/
3139
+ # locations/`location`/apps/`app`/versions/`version``
3140
+ # Corresponds to the JSON property `appVersion`
3141
+ # @return [String]
3142
+ attr_accessor :app_version
3143
+
3144
+ # Optional. Id of the traffic allocation. Free format string, up to 128
3145
+ # characters.
3146
+ # Corresponds to the JSON property `id`
3147
+ # @return [String]
3148
+ attr_accessor :id
3149
+
3150
+ # Optional. Traffic percentage of the traffic allocation. Must be between 0 and
3151
+ # 100.
3152
+ # Corresponds to the JSON property `trafficPercentage`
3153
+ # @return [Fixnum]
3154
+ attr_accessor :traffic_percentage
3155
+
3156
+ def initialize(**args)
3157
+ update!(**args)
3158
+ end
3159
+
3160
+ # Update properties of this object
3161
+ def update!(**args)
3162
+ @app_version = args[:app_version] if args.key?(:app_version)
3163
+ @id = args[:id] if args.key?(:id)
3164
+ @traffic_percentage = args[:traffic_percentage] if args.key?(:traffic_percentage)
3165
+ end
3166
+ end
3167
+
2998
3168
  # Request message for AgentService.ExportApp.
2999
3169
  class ExportAppRequest
3000
3170
  include Google::Apis::Core::Hashable
@@ -3820,10 +3990,12 @@ module Google
3820
3990
  attr_accessor :enable_multilingual_support
3821
3991
  alias_method :enable_multilingual_support?, :enable_multilingual_support
3822
3992
 
3823
- # Optional. The action to perform when an agent receives input in an unsupported
3824
- # language. This can be a predefined action or a custom tool call. Valid values
3825
- # are: - A tool's full resource name, which triggers a specific tool execution. -
3826
- # A predefined system action, such as "escalate" or "exit", which triggers an
3993
+ # Optional. Deprecated: This feature is no longer supported. Use `
3994
+ # enable_multilingual_support` instead to improve handling of multilingual input.
3995
+ # The action to perform when an agent receives input in an unsupported language.
3996
+ # This can be a predefined action or a custom tool call. Valid values are: - A
3997
+ # tool's full resource name, which triggers a specific tool execution. - A
3998
+ # predefined system action, such as "escalate" or "exit", which triggers an
3827
3999
  # EndSession signal with corresponding metadata to terminate the conversation.
3828
4000
  # Corresponds to the JSON property `fallbackAction`
3829
4001
  # @return [String]
@@ -4260,6 +4432,11 @@ module Google
4260
4432
  # @return [Google::Apis::CesV1::RedactionConfig]
4261
4433
  attr_accessor :redaction_config
4262
4434
 
4435
+ # Configuration for how the audio interactions should be recorded.
4436
+ # Corresponds to the JSON property `unredactedAudioRecordingConfig`
4437
+ # @return [Google::Apis::CesV1::AudioRecordingConfig]
4438
+ attr_accessor :unredacted_audio_recording_config
4439
+
4263
4440
  def initialize(**args)
4264
4441
  update!(**args)
4265
4442
  end
@@ -4273,6 +4450,7 @@ module Google
4273
4450
  @evaluation_audio_recording_config = args[:evaluation_audio_recording_config] if args.key?(:evaluation_audio_recording_config)
4274
4451
  @metric_analysis_settings = args[:metric_analysis_settings] if args.key?(:metric_analysis_settings)
4275
4452
  @redaction_config = args[:redaction_config] if args.key?(:redaction_config)
4453
+ @unredacted_audio_recording_config = args[:unredacted_audio_recording_config] if args.key?(:unredacted_audio_recording_config)
4276
4454
  end
4277
4455
  end
4278
4456
 
@@ -4456,6 +4634,81 @@ module Google
4456
4634
  end
4457
4635
  end
4458
4636
 
4637
+ # Mock tool calls configuration for the session.
4638
+ class MockConfig
4639
+ include Google::Apis::Core::Hashable
4640
+
4641
+ # Optional. All tool calls to mock for the duration of the session.
4642
+ # Corresponds to the JSON property `mockedToolCalls`
4643
+ # @return [Array<Google::Apis::CesV1::MockedToolCall>]
4644
+ attr_accessor :mocked_tool_calls
4645
+
4646
+ # Required. Beavhior for tool calls that don't match any args patterns in
4647
+ # mocked_tool_calls.
4648
+ # Corresponds to the JSON property `unmatchedToolCallBehavior`
4649
+ # @return [String]
4650
+ attr_accessor :unmatched_tool_call_behavior
4651
+
4652
+ def initialize(**args)
4653
+ update!(**args)
4654
+ end
4655
+
4656
+ # Update properties of this object
4657
+ def update!(**args)
4658
+ @mocked_tool_calls = args[:mocked_tool_calls] if args.key?(:mocked_tool_calls)
4659
+ @unmatched_tool_call_behavior = args[:unmatched_tool_call_behavior] if args.key?(:unmatched_tool_call_behavior)
4660
+ end
4661
+ end
4662
+
4663
+ # A mocked tool call. Expresses the target tool + a pattern to match against
4664
+ # that tool's args / inputs. If the pattern matches, then the mock response will
4665
+ # be returned.
4666
+ class MockedToolCall
4667
+ include Google::Apis::Core::Hashable
4668
+
4669
+ # Required. A pattern to match against the args / inputs of all dispatched tool
4670
+ # calls. If the tool call inputs match this pattern, then mock output will be
4671
+ # returned.
4672
+ # Corresponds to the JSON property `expectedArgsPattern`
4673
+ # @return [Hash<String,Object>]
4674
+ attr_accessor :expected_args_pattern
4675
+
4676
+ # Optional. The mock response / output to return if the tool call args / inputs
4677
+ # match the pattern.
4678
+ # Corresponds to the JSON property `mockResponse`
4679
+ # @return [Hash<String,Object>]
4680
+ attr_accessor :mock_response
4681
+
4682
+ # Optional. Deprecated. Use tool_identifier instead.
4683
+ # Corresponds to the JSON property `tool`
4684
+ # @return [String]
4685
+ attr_accessor :tool
4686
+
4687
+ # Optional. The name of the tool to mock. Format: `projects/`project`/locations/`
4688
+ # location`/apps/`app`/tools/`tool``
4689
+ # Corresponds to the JSON property `toolId`
4690
+ # @return [String]
4691
+ attr_accessor :tool_id
4692
+
4693
+ # A tool that is created from a toolset.
4694
+ # Corresponds to the JSON property `toolset`
4695
+ # @return [Google::Apis::CesV1::ToolsetTool]
4696
+ attr_accessor :toolset
4697
+
4698
+ def initialize(**args)
4699
+ update!(**args)
4700
+ end
4701
+
4702
+ # Update properties of this object
4703
+ def update!(**args)
4704
+ @expected_args_pattern = args[:expected_args_pattern] if args.key?(:expected_args_pattern)
4705
+ @mock_response = args[:mock_response] if args.key?(:mock_response)
4706
+ @tool = args[:tool] if args.key?(:tool)
4707
+ @tool_id = args[:tool_id] if args.key?(:tool_id)
4708
+ @toolset = args[:toolset] if args.key?(:toolset)
4709
+ end
4710
+ end
4711
+
4459
4712
  # Model settings contains various configurations for the LLM model.
4460
4713
  class ModelSettings
4461
4714
  include Google::Apis::Core::Hashable
@@ -5553,6 +5806,15 @@ module Google
5553
5806
  # @return [String]
5554
5807
  attr_accessor :deployment
5555
5808
 
5809
+ # Optional. Whether to enable streaming text outputs from the model. By default,
5810
+ # text outputs from the model are collected before sending to the client. NOTE:
5811
+ # This is only supported for text (non-voice) sessions via StreamRunSession or
5812
+ # BidiRunSession.
5813
+ # Corresponds to the JSON property `enableTextStreaming`
5814
+ # @return [Boolean]
5815
+ attr_accessor :enable_text_streaming
5816
+ alias_method :enable_text_streaming?, :enable_text_streaming
5817
+
5556
5818
  # Optional. The entry agent to handle the session. If not specified, the session
5557
5819
  # will be handled by the root agent of the app. Format: `projects/`project`/
5558
5820
  # locations/`location`/apps/`app`/agents/`agent``
@@ -5612,6 +5874,7 @@ module Google
5612
5874
  # Update properties of this object
5613
5875
  def update!(**args)
5614
5876
  @deployment = args[:deployment] if args.key?(:deployment)
5877
+ @enable_text_streaming = args[:enable_text_streaming] if args.key?(:enable_text_streaming)
5615
5878
  @entry_agent = args[:entry_agent] if args.key?(:entry_agent)
5616
5879
  @historical_contexts = args[:historical_contexts] if args.key?(:historical_contexts)
5617
5880
  @input_audio_config = args[:input_audio_config] if args.key?(:input_audio_config)
@@ -6735,6 +6998,11 @@ module Google
6735
6998
  # @return [Google::Apis::CesV1::Schema]
6736
6999
  attr_accessor :parameters
6737
7000
 
7001
+ # Configuration for the text response returned with the widget.
7002
+ # Corresponds to the JSON property `textResponseConfig`
7003
+ # @return [Google::Apis::CesV1::WidgetToolTextResponseConfig]
7004
+ attr_accessor :text_response_config
7005
+
6738
7006
  # Optional. Configuration for rendering the widget.
6739
7007
  # Corresponds to the JSON property `uiConfig`
6740
7008
  # @return [Hash<String,Object>]
@@ -6756,6 +7024,7 @@ module Google
6756
7024
  @description = args[:description] if args.key?(:description)
6757
7025
  @name = args[:name] if args.key?(:name)
6758
7026
  @parameters = args[:parameters] if args.key?(:parameters)
7027
+ @text_response_config = args[:text_response_config] if args.key?(:text_response_config)
6759
7028
  @ui_config = args[:ui_config] if args.key?(:ui_config)
6760
7029
  @widget_type = args[:widget_type] if args.key?(:widget_type)
6761
7030
  end
@@ -6777,9 +7046,12 @@ module Google
6777
7046
  # @return [String]
6778
7047
  attr_accessor :mode
6779
7048
 
6780
- # Optional. A Python script used to transform the source tool's output into the
6781
- # widget's input format. This is used when the mapping is too complex for simple
6782
- # field mappings.
7049
+ # A Python function tool.
7050
+ # Corresponds to the JSON property `pythonFunction`
7051
+ # @return [Google::Apis::CesV1::PythonFunction]
7052
+ attr_accessor :python_function
7053
+
7054
+ # Deprecated: Use `python_function` instead.
6783
7055
  # Corresponds to the JSON property `pythonScript`
6784
7056
  # @return [String]
6785
7057
  attr_accessor :python_script
@@ -6799,10 +7071,43 @@ module Google
6799
7071
  def update!(**args)
6800
7072
  @field_mappings = args[:field_mappings] if args.key?(:field_mappings)
6801
7073
  @mode = args[:mode] if args.key?(:mode)
7074
+ @python_function = args[:python_function] if args.key?(:python_function)
6802
7075
  @python_script = args[:python_script] if args.key?(:python_script)
6803
7076
  @source_tool_name = args[:source_tool_name] if args.key?(:source_tool_name)
6804
7077
  end
6805
7078
  end
7079
+
7080
+ # Configuration for the text response returned with the widget.
7081
+ class WidgetToolTextResponseConfig
7082
+ include Google::Apis::Core::Hashable
7083
+
7084
+ # Optional. The static text response to return when type is STATIC.
7085
+ # Corresponds to the JSON property `staticText`
7086
+ # @return [String]
7087
+ attr_accessor :static_text
7088
+
7089
+ # Optional. Instruction for the LLM on how to generate the text response. Used
7090
+ # as the description for the text response parameter if type is LLM_GENERATED.
7091
+ # Corresponds to the JSON property `textResponseInstruction`
7092
+ # @return [String]
7093
+ attr_accessor :text_response_instruction
7094
+
7095
+ # Optional. The strategy for providing the text response.
7096
+ # Corresponds to the JSON property `type`
7097
+ # @return [String]
7098
+ attr_accessor :type
7099
+
7100
+ def initialize(**args)
7101
+ update!(**args)
7102
+ end
7103
+
7104
+ # Update properties of this object
7105
+ def update!(**args)
7106
+ @static_text = args[:static_text] if args.key?(:static_text)
7107
+ @text_response_instruction = args[:text_response_instruction] if args.key?(:text_response_instruction)
7108
+ @type = args[:type] if args.key?(:type)
7109
+ end
7110
+ end
6806
7111
  end
6807
7112
  end
6808
7113
  end
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module CesV1
18
18
  # Version of the google-apis-ces_v1 gem
19
- GEM_VERSION = "0.5.0"
19
+ GEM_VERSION = "0.6.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
22
  GENERATOR_VERSION = "0.18.0"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20260312"
25
+ REVISION = "20260422"
26
26
  end
27
27
  end
28
28
  end
@@ -412,6 +412,18 @@ module Google
412
412
  include Google::Apis::Core::JsonObjectSupport
413
413
  end
414
414
 
415
+ class ErrorHandlingSettingsEndSessionConfig
416
+ class Representation < Google::Apis::Core::JsonRepresentation; end
417
+
418
+ include Google::Apis::Core::JsonObjectSupport
419
+ end
420
+
421
+ class ErrorHandlingSettingsFallbackResponseConfig
422
+ class Representation < Google::Apis::Core::JsonRepresentation; end
423
+
424
+ include Google::Apis::Core::JsonObjectSupport
425
+ end
426
+
415
427
  class EvaluationMetricsThresholds
416
428
  class Representation < Google::Apis::Core::JsonRepresentation; end
417
429
 
@@ -466,6 +478,24 @@ module Google
466
478
  include Google::Apis::Core::JsonObjectSupport
467
479
  end
468
480
 
481
+ class ExperimentConfig
482
+ class Representation < Google::Apis::Core::JsonRepresentation; end
483
+
484
+ include Google::Apis::Core::JsonObjectSupport
485
+ end
486
+
487
+ class ExperimentConfigVersionRelease
488
+ class Representation < Google::Apis::Core::JsonRepresentation; end
489
+
490
+ include Google::Apis::Core::JsonObjectSupport
491
+ end
492
+
493
+ class ExperimentConfigVersionReleaseTrafficAllocation
494
+ class Representation < Google::Apis::Core::JsonRepresentation; end
495
+
496
+ include Google::Apis::Core::JsonObjectSupport
497
+ end
498
+
469
499
  class ExportAppRequest
470
500
  class Representation < Google::Apis::Core::JsonRepresentation; end
471
501
 
@@ -712,6 +742,18 @@ module Google
712
742
  include Google::Apis::Core::JsonObjectSupport
713
743
  end
714
744
 
745
+ class MockConfig
746
+ class Representation < Google::Apis::Core::JsonRepresentation; end
747
+
748
+ include Google::Apis::Core::JsonObjectSupport
749
+ end
750
+
751
+ class MockedToolCall
752
+ class Representation < Google::Apis::Core::JsonRepresentation; end
753
+
754
+ include Google::Apis::Core::JsonObjectSupport
755
+ end
756
+
715
757
  class ModelSettings
716
758
  class Representation < Google::Apis::Core::JsonRepresentation; end
717
759
 
@@ -1078,6 +1120,12 @@ module Google
1078
1120
  include Google::Apis::Core::JsonObjectSupport
1079
1121
  end
1080
1122
 
1123
+ class WidgetToolTextResponseConfig
1124
+ class Representation < Google::Apis::Core::JsonRepresentation; end
1125
+
1126
+ include Google::Apis::Core::JsonObjectSupport
1127
+ end
1128
+
1081
1129
  class Action
1082
1130
  # @private
1083
1131
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -1165,6 +1213,7 @@ module Google
1165
1213
  class AgentTool
1166
1214
  # @private
1167
1215
  class Representation < Google::Apis::Core::JsonRepresentation
1216
+ property :agent, as: 'agent'
1168
1217
  property :description, as: 'description'
1169
1218
  property :name, as: 'name'
1170
1219
  property :root_agent, as: 'rootAgent'
@@ -1559,6 +1608,7 @@ module Google
1559
1608
  # @private
1560
1609
  class Representation < Google::Apis::Core::JsonRepresentation
1561
1610
  property :disable_conversation_logging, as: 'disableConversationLogging'
1611
+ property :retention_window, as: 'retentionWindow'
1562
1612
  end
1563
1613
  end
1564
1614
 
@@ -1742,6 +1792,8 @@ module Google
1742
1792
  property :create_time, as: 'createTime'
1743
1793
  property :display_name, as: 'displayName'
1744
1794
  property :etag, as: 'etag'
1795
+ property :experiment_config, as: 'experimentConfig', class: Google::Apis::CesV1::ExperimentConfig, decorator: Google::Apis::CesV1::ExperimentConfig::Representation
1796
+
1745
1797
  property :name, as: 'name'
1746
1798
  property :update_time, as: 'updateTime'
1747
1799
  end
@@ -1797,7 +1849,26 @@ module Google
1797
1849
  class ErrorHandlingSettings
1798
1850
  # @private
1799
1851
  class Representation < Google::Apis::Core::JsonRepresentation
1852
+ property :end_session_config, as: 'endSessionConfig', class: Google::Apis::CesV1::ErrorHandlingSettingsEndSessionConfig, decorator: Google::Apis::CesV1::ErrorHandlingSettingsEndSessionConfig::Representation
1853
+
1800
1854
  property :error_handling_strategy, as: 'errorHandlingStrategy'
1855
+ property :fallback_response_config, as: 'fallbackResponseConfig', class: Google::Apis::CesV1::ErrorHandlingSettingsFallbackResponseConfig, decorator: Google::Apis::CesV1::ErrorHandlingSettingsFallbackResponseConfig::Representation
1856
+
1857
+ end
1858
+ end
1859
+
1860
+ class ErrorHandlingSettingsEndSessionConfig
1861
+ # @private
1862
+ class Representation < Google::Apis::Core::JsonRepresentation
1863
+ property :escalate_session, as: 'escalateSession'
1864
+ end
1865
+ end
1866
+
1867
+ class ErrorHandlingSettingsFallbackResponseConfig
1868
+ # @private
1869
+ class Representation < Google::Apis::Core::JsonRepresentation
1870
+ hash :custom_fallback_messages, as: 'customFallbackMessages'
1871
+ property :max_fallback_attempts, as: 'maxFallbackAttempts'
1801
1872
  end
1802
1873
  end
1803
1874
 
@@ -1875,6 +1946,8 @@ module Google
1875
1946
  class Representation < Google::Apis::Core::JsonRepresentation
1876
1947
  hash :args, as: 'args'
1877
1948
  hash :context, as: 'context'
1949
+ property :mock_config, as: 'mockConfig', class: Google::Apis::CesV1::MockConfig, decorator: Google::Apis::CesV1::MockConfig::Representation
1950
+
1878
1951
  property :tool, as: 'tool'
1879
1952
  property :toolset_tool, as: 'toolsetTool', class: Google::Apis::CesV1::ToolsetTool, decorator: Google::Apis::CesV1::ToolsetTool::Representation
1880
1953
 
@@ -1893,6 +1966,32 @@ module Google
1893
1966
  end
1894
1967
  end
1895
1968
 
1969
+ class ExperimentConfig
1970
+ # @private
1971
+ class Representation < Google::Apis::Core::JsonRepresentation
1972
+ property :version_release, as: 'versionRelease', class: Google::Apis::CesV1::ExperimentConfigVersionRelease, decorator: Google::Apis::CesV1::ExperimentConfigVersionRelease::Representation
1973
+
1974
+ end
1975
+ end
1976
+
1977
+ class ExperimentConfigVersionRelease
1978
+ # @private
1979
+ class Representation < Google::Apis::Core::JsonRepresentation
1980
+ property :state, as: 'state'
1981
+ collection :traffic_allocations, as: 'trafficAllocations', class: Google::Apis::CesV1::ExperimentConfigVersionReleaseTrafficAllocation, decorator: Google::Apis::CesV1::ExperimentConfigVersionReleaseTrafficAllocation::Representation
1982
+
1983
+ end
1984
+ end
1985
+
1986
+ class ExperimentConfigVersionReleaseTrafficAllocation
1987
+ # @private
1988
+ class Representation < Google::Apis::Core::JsonRepresentation
1989
+ property :app_version, as: 'appVersion'
1990
+ property :id, as: 'id'
1991
+ property :traffic_percentage, as: 'trafficPercentage'
1992
+ end
1993
+ end
1994
+
1896
1995
  class ExportAppRequest
1897
1996
  # @private
1898
1997
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -2264,6 +2363,8 @@ module Google
2264
2363
 
2265
2364
  property :redaction_config, as: 'redactionConfig', class: Google::Apis::CesV1::RedactionConfig, decorator: Google::Apis::CesV1::RedactionConfig::Representation
2266
2365
 
2366
+ property :unredacted_audio_recording_config, as: 'unredactedAudioRecordingConfig', class: Google::Apis::CesV1::AudioRecordingConfig, decorator: Google::Apis::CesV1::AudioRecordingConfig::Representation
2367
+
2267
2368
  end
2268
2369
  end
2269
2370
 
@@ -2318,6 +2419,27 @@ module Google
2318
2419
  end
2319
2420
  end
2320
2421
 
2422
+ class MockConfig
2423
+ # @private
2424
+ class Representation < Google::Apis::Core::JsonRepresentation
2425
+ collection :mocked_tool_calls, as: 'mockedToolCalls', class: Google::Apis::CesV1::MockedToolCall, decorator: Google::Apis::CesV1::MockedToolCall::Representation
2426
+
2427
+ property :unmatched_tool_call_behavior, as: 'unmatchedToolCallBehavior'
2428
+ end
2429
+ end
2430
+
2431
+ class MockedToolCall
2432
+ # @private
2433
+ class Representation < Google::Apis::Core::JsonRepresentation
2434
+ hash :expected_args_pattern, as: 'expectedArgsPattern'
2435
+ hash :mock_response, as: 'mockResponse'
2436
+ property :tool, as: 'tool'
2437
+ property :tool_id, as: 'toolId'
2438
+ property :toolset, as: 'toolset', class: Google::Apis::CesV1::ToolsetTool, decorator: Google::Apis::CesV1::ToolsetTool::Representation
2439
+
2440
+ end
2441
+ end
2442
+
2321
2443
  class ModelSettings
2322
2444
  # @private
2323
2445
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -2631,6 +2753,7 @@ module Google
2631
2753
  # @private
2632
2754
  class Representation < Google::Apis::Core::JsonRepresentation
2633
2755
  property :deployment, as: 'deployment'
2756
+ property :enable_text_streaming, as: 'enableTextStreaming'
2634
2757
  property :entry_agent, as: 'entryAgent'
2635
2758
  collection :historical_contexts, as: 'historicalContexts', class: Google::Apis::CesV1::Message, decorator: Google::Apis::CesV1::Message::Representation
2636
2759
 
@@ -2969,6 +3092,8 @@ module Google
2969
3092
  property :name, as: 'name'
2970
3093
  property :parameters, as: 'parameters', class: Google::Apis::CesV1::Schema, decorator: Google::Apis::CesV1::Schema::Representation
2971
3094
 
3095
+ property :text_response_config, as: 'textResponseConfig', class: Google::Apis::CesV1::WidgetToolTextResponseConfig, decorator: Google::Apis::CesV1::WidgetToolTextResponseConfig::Representation
3096
+
2972
3097
  hash :ui_config, as: 'uiConfig'
2973
3098
  property :widget_type, as: 'widgetType'
2974
3099
  end
@@ -2979,10 +3104,21 @@ module Google
2979
3104
  class Representation < Google::Apis::Core::JsonRepresentation
2980
3105
  hash :field_mappings, as: 'fieldMappings'
2981
3106
  property :mode, as: 'mode'
3107
+ property :python_function, as: 'pythonFunction', class: Google::Apis::CesV1::PythonFunction, decorator: Google::Apis::CesV1::PythonFunction::Representation
3108
+
2982
3109
  property :python_script, as: 'pythonScript'
2983
3110
  property :source_tool_name, as: 'sourceToolName'
2984
3111
  end
2985
3112
  end
3113
+
3114
+ class WidgetToolTextResponseConfig
3115
+ # @private
3116
+ class Representation < Google::Apis::Core::JsonRepresentation
3117
+ property :static_text, as: 'staticText'
3118
+ property :text_response_instruction, as: 'textResponseInstruction'
3119
+ property :type, as: 'type'
3120
+ end
3121
+ end
2986
3122
  end
2987
3123
  end
2988
3124
  end
@@ -82,15 +82,20 @@ module Google
82
82
  end
83
83
 
84
84
  # Lists information about the supported locations for this service. This method
85
- # can be called in two ways: * **List all public locations:** Use the path `GET /
86
- # v1/locations`. * **List project-visible locations:** Use the path `GET /v1/
87
- # projects/`project_id`/locations`. This may include public locations as well as
88
- # private or other locations specifically visible to the project.
85
+ # lists locations based on the resource scope provided in the
86
+ # ListLocationsRequest.name field: * **Global locations**: If `name` is empty,
87
+ # the method lists the public locations available to all projects. * **Project-
88
+ # specific locations**: If `name` follows the format `projects/`project``, the
89
+ # method lists locations visible to that specific project. This includes public,
90
+ # private, or other project-specific locations enabled for the project. For gRPC
91
+ # and client library implementations, the resource name is passed as the `name`
92
+ # field. For direct service calls, the resource name is incorporated into the
93
+ # request path based on the specific service implementation and version.
89
94
  # @param [String] name
90
95
  # The resource that owns the locations collection, if applicable.
91
96
  # @param [Array<String>, String] extra_location_types
92
- # Optional. Do not use this field. It is unsupported and is ignored unless
93
- # explicitly documented otherwise. This is primarily for internal usage.
97
+ # Optional. Do not use this field unless explicitly documented otherwise. This
98
+ # is primarily for internal usage.
94
99
  # @param [String] filter
95
100
  # A filter to narrow down results to a preferred subset. The filtering language
96
101
  # accepts strings like `"displayName=tokyo"`, and is documented in more detail
@@ -1525,6 +1530,45 @@ module Google
1525
1530
  execute_or_queue_command(command, &block)
1526
1531
  end
1527
1532
 
1533
+ # Initiates a single-turn interaction with the CES agent. Uses server-side
1534
+ # streaming to deliver incremental results and partial responses as they are
1535
+ # generated. By default, complete responses (e.g., messages from callbacks or
1536
+ # full LLM responses) are sent to the client as soon as they are available. To
1537
+ # enable streaming individual text chunks directly from the model, set
1538
+ # enable_text_streaming to true.
1539
+ # @param [String] session
1540
+ # Required. The unique identifier of the session. Format: `projects/`project`/
1541
+ # locations/`location`/apps/`app`/sessions/`session``
1542
+ # @param [Google::Apis::CesV1::RunSessionRequest] run_session_request_object
1543
+ # @param [String] fields
1544
+ # Selector specifying which fields to include in a partial response.
1545
+ # @param [String] quota_user
1546
+ # Available to use for quota purposes for server-side applications. Can be any
1547
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1548
+ # @param [Google::Apis::RequestOptions] options
1549
+ # Request-specific options
1550
+ #
1551
+ # @yield [result, err] Result & error if block supplied
1552
+ # @yieldparam result [Google::Apis::CesV1::RunSessionResponse] parsed result object
1553
+ # @yieldparam err [StandardError] error object if request failed
1554
+ #
1555
+ # @return [Google::Apis::CesV1::RunSessionResponse]
1556
+ #
1557
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1558
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1559
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1560
+ def stream_project_location_app_session_run_session(session, run_session_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1561
+ command = make_simple_command(:post, 'v1/{+session}:streamRunSession', options)
1562
+ command.request_representation = Google::Apis::CesV1::RunSessionRequest::Representation
1563
+ command.request_object = run_session_request_object
1564
+ command.response_representation = Google::Apis::CesV1::RunSessionResponse::Representation
1565
+ command.response_class = Google::Apis::CesV1::RunSessionResponse
1566
+ command.params['session'] = session unless session.nil?
1567
+ command.query['fields'] = fields unless fields.nil?
1568
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1569
+ execute_or_queue_command(command, &block)
1570
+ end
1571
+
1528
1572
  # Creates a new tool in the given app.
1529
1573
  # @param [String] parent
1530
1574
  # Required. The resource name of the app to create a tool in.
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-ces_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.5.0
4
+ version: 0.6.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-ces_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-ces_v1/v0.5.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-ces_v1/v0.6.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-ces_v1
63
63
  rdoc_options: []
64
64
  require_paths: