google-cloud-gemini_data_analytics-v1beta 1.0.0 → 1.2.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.
Files changed (71) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +4 -4
  3. data/README.md +5 -6
  4. data/lib/google/cloud/gemini_data_analytics/v1beta/bindings_override.rb +2 -2
  5. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/client.rb +697 -0
  6. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/credentials.rb +47 -0
  7. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest/client.rb +643 -0
  8. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest/service_stub.rb +283 -0
  9. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service/rest.rb +53 -0
  10. data/lib/google/cloud/gemini_data_analytics/v1beta/data_a2_a_service.rb +55 -0
  11. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/client.rb +237 -2
  12. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/credentials.rb +1 -1
  13. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/operations.rb +1 -1
  14. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/paths.rb +1 -1
  15. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest/client.rb +223 -2
  16. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest/operations.rb +1 -1
  17. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest/service_stub.rb +124 -1
  18. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service/rest.rb +1 -1
  19. data/lib/google/cloud/gemini_data_analytics/v1beta/data_agent_service.rb +1 -1
  20. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/client.rb +106 -1
  21. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/credentials.rb +1 -1
  22. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/paths.rb +1 -1
  23. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/rest/client.rb +99 -1
  24. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/rest/service_stub.rb +63 -1
  25. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service/rest.rb +1 -1
  26. data/lib/google/cloud/gemini_data_analytics/v1beta/data_chat_service.rb +1 -1
  27. data/lib/google/cloud/gemini_data_analytics/v1beta/rest.rb +3 -2
  28. data/lib/google/cloud/gemini_data_analytics/v1beta/version.rb +1 -1
  29. data/lib/google/cloud/gemini_data_analytics/v1beta.rb +4 -3
  30. data/lib/google/cloud/geminidataanalytics/v1beta/context_pb.rb +2 -1
  31. data/lib/google/cloud/geminidataanalytics/v1beta/conversation_pb.rb +3 -1
  32. data/lib/google/cloud/geminidataanalytics/v1beta/data_a2a_service_pb.rb +64 -0
  33. data/lib/google/cloud/geminidataanalytics/v1beta/data_a2a_service_services_pb.rb +52 -0
  34. data/lib/google/cloud/geminidataanalytics/v1beta/data_agent_pb.rb +2 -1
  35. data/lib/google/cloud/geminidataanalytics/v1beta/data_agent_service_pb.rb +6 -1
  36. data/lib/google/cloud/geminidataanalytics/v1beta/data_agent_service_services_pb.rb +7 -1
  37. data/lib/google/cloud/geminidataanalytics/v1beta/data_chat_service_pb.rb +2 -1
  38. data/lib/google/cloud/geminidataanalytics/v1beta/data_chat_service_services_pb.rb +3 -1
  39. data/lib/google/cloud/geminidataanalytics/v1beta/datasource_pb.rb +5 -1
  40. data/lib/google/cloud/geminidataanalytics/v1beta/usage_pb.rb +21 -0
  41. data/lib/google-cloud-gemini_data_analytics-v1beta.rb +1 -1
  42. data/proto_docs/google/api/client.rb +1 -1
  43. data/proto_docs/google/api/field_behavior.rb +1 -1
  44. data/proto_docs/google/api/field_info.rb +1 -1
  45. data/proto_docs/google/api/launch_stage.rb +1 -1
  46. data/proto_docs/google/api/resource.rb +1 -1
  47. data/proto_docs/google/cloud/geminidataanalytics/v1beta/agent_context.rb +1 -1
  48. data/proto_docs/google/cloud/geminidataanalytics/v1beta/context.rb +83 -2
  49. data/proto_docs/google/cloud/geminidataanalytics/v1beta/conversation.rb +28 -4
  50. data/proto_docs/google/cloud/geminidataanalytics/v1beta/credentials.rb +1 -1
  51. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_a2a_service.rb +825 -0
  52. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_agent.rb +52 -1
  53. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_agent_service.rb +101 -1
  54. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_analytics_agent.rb +1 -1
  55. data/proto_docs/google/cloud/geminidataanalytics/v1beta/data_chat_service.rb +23 -4
  56. data/proto_docs/google/cloud/geminidataanalytics/v1beta/datasource.rb +108 -18
  57. data/proto_docs/google/cloud/geminidataanalytics/v1beta/usage.rb +38 -0
  58. data/proto_docs/google/iam/v1/iam_policy.rb +1 -1
  59. data/proto_docs/google/iam/v1/options.rb +1 -1
  60. data/proto_docs/google/iam/v1/policy.rb +1 -1
  61. data/proto_docs/google/longrunning/operations.rb +1 -1
  62. data/proto_docs/google/protobuf/any.rb +1 -1
  63. data/proto_docs/google/protobuf/duration.rb +1 -1
  64. data/proto_docs/google/protobuf/empty.rb +1 -1
  65. data/proto_docs/google/protobuf/field_mask.rb +1 -1
  66. data/proto_docs/google/protobuf/struct.rb +1 -1
  67. data/proto_docs/google/protobuf/timestamp.rb +8 -7
  68. data/proto_docs/google/protobuf/wrappers.rb +1 -1
  69. data/proto_docs/google/rpc/status.rb +1 -1
  70. data/proto_docs/google/type/expr.rb +1 -1
  71. metadata +20 -7
@@ -0,0 +1,825 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2026 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+
20
+ module Google
21
+ module Cloud
22
+ module GeminiDataAnalytics
23
+ module V1beta
24
+ # Configuration of a send message request.
25
+ # @!attribute [rw] accepted_output_modes
26
+ # @return [::Array<::String>]
27
+ # Optional. The output modes that the agent is expected to respond with.
28
+ # @!attribute [rw] push_notification
29
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::PushNotificationConfig]
30
+ # Optional. A configuration of a webhook that can be used to receive updates.
31
+ # @!attribute [rw] history_length
32
+ # @return [::Integer]
33
+ # Optional. The maximum number of messages to include in the history. If 0,
34
+ # the history will be unlimited.
35
+ # @!attribute [rw] blocking
36
+ # @return [::Boolean]
37
+ # Optional. If true, the message will be blocking until the task is
38
+ # completed. If false, the task will be returned immediately.
39
+ class SendMessageConfiguration
40
+ include ::Google::Protobuf::MessageExts
41
+ extend ::Google::Protobuf::MessageExts::ClassMethods
42
+ end
43
+
44
+ # A2ATask is the core unit of action for A2A. It has a current status
45
+ # and when results are created for the task they are stored in the
46
+ # artifact. If there are multiple turns for a task, these are stored in
47
+ # history.
48
+ # @!attribute [rw] id
49
+ # @return [::String]
50
+ # Optional. Unique identifier (e.g. UUID) for the task, generated by the
51
+ # server for a new task.
52
+ # @!attribute [rw] context_id
53
+ # @return [::String]
54
+ # Optional. Unique identifier (e.g. UUID) for the contextual collection of
55
+ # interactions (tasks and messages). Created by the A2A server.
56
+ # @!attribute [rw] status
57
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::TaskStatus]
58
+ # Optional. The current status of a Task, including state and a message.
59
+ # @!attribute [rw] artifacts
60
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::A2AArtifact>]
61
+ # Optional. A set of output artifacts for a Task.
62
+ # @!attribute [rw] history
63
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::A2AMessage>]
64
+ # Optional. The history of interactions from a task.
65
+ # @!attribute [rw] metadata
66
+ # @return [::Google::Protobuf::Struct]
67
+ # Optional. A key/value object to store custom metadata about a task.
68
+ class A2ATask
69
+ include ::Google::Protobuf::MessageExts
70
+ extend ::Google::Protobuf::MessageExts::ClassMethods
71
+ end
72
+
73
+ # A container for the status of a task.
74
+ # @!attribute [r] state
75
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::TaskState]
76
+ # Output only. The current state of this task.
77
+ # @!attribute [rw] update
78
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::A2AMessage]
79
+ # Optional. A message associated with the status.
80
+ # @!attribute [r] timestamp
81
+ # @return [::Google::Protobuf::Timestamp]
82
+ # Output only. Timestamp when the status was recorded.
83
+ class TaskStatus
84
+ include ::Google::Protobuf::MessageExts
85
+ extend ::Google::Protobuf::MessageExts::ClassMethods
86
+ end
87
+
88
+ # Part represents a container for a section of communication content.
89
+ # Parts can be purely textual, some sort of file (image, video, etc) or
90
+ # a structured data blob (i.e. JSON).
91
+ # @!attribute [rw] text
92
+ # @return [::String]
93
+ # Plain text content.
94
+ #
95
+ # Note: The following fields are mutually exclusive: `text`, `file`, `data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
96
+ # @!attribute [rw] file
97
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::FilePart]
98
+ # File content payload.
99
+ #
100
+ # Note: The following fields are mutually exclusive: `file`, `text`, `data`. If a field in that set is populated, all other fields in the set will automatically be cleared.
101
+ # @!attribute [rw] data
102
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::DataPart]
103
+ # Structured data content payload.
104
+ #
105
+ # Note: The following fields are mutually exclusive: `data`, `text`, `file`. If a field in that set is populated, all other fields in the set will automatically be cleared.
106
+ # @!attribute [rw] metadata
107
+ # @return [::Google::Protobuf::Struct]
108
+ # Optional. Metadata associated with the part.
109
+ class Part
110
+ include ::Google::Protobuf::MessageExts
111
+ extend ::Google::Protobuf::MessageExts::ClassMethods
112
+ end
113
+
114
+ # FilePart represents the different ways files can be provided.
115
+ # @!attribute [rw] file_with_uri
116
+ # @return [::String]
117
+ # The URI pointing to the file.
118
+ #
119
+ # Note: The following fields are mutually exclusive: `file_with_uri`, `file_with_bytes`. If a field in that set is populated, all other fields in the set will automatically be cleared.
120
+ # @!attribute [rw] file_with_bytes
121
+ # @return [::String]
122
+ # The raw bytes of the file.
123
+ #
124
+ # Note: The following fields are mutually exclusive: `file_with_bytes`, `file_with_uri`. If a field in that set is populated, all other fields in the set will automatically be cleared.
125
+ # @!attribute [rw] mime_type
126
+ # @return [::String]
127
+ # Optional. The MIME type of the file.
128
+ # @!attribute [rw] name
129
+ # @return [::String]
130
+ # Optional. The name of the file.
131
+ class FilePart
132
+ include ::Google::Protobuf::MessageExts
133
+ extend ::Google::Protobuf::MessageExts::ClassMethods
134
+ end
135
+
136
+ # DataPart represents a structured blob. This is most commonly a JSON payload.
137
+ # @!attribute [rw] data
138
+ # @return [::Google::Protobuf::Struct]
139
+ # Optional. The structured data payload.
140
+ class DataPart
141
+ include ::Google::Protobuf::MessageExts
142
+ extend ::Google::Protobuf::MessageExts::ClassMethods
143
+ end
144
+
145
+ # A2AMessage is one unit of communication between client and server.
146
+ # @!attribute [rw] message_id
147
+ # @return [::String]
148
+ # Optional. The unique identifier (e.g. UUID) of the message.
149
+ # @!attribute [rw] context_id
150
+ # @return [::String]
151
+ # Optional. The context id of the message.
152
+ # @!attribute [rw] task_id
153
+ # @return [::String]
154
+ # Optional. The task id of the message.
155
+ # @!attribute [rw] role
156
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::Role]
157
+ # Optional. A role for the message.
158
+ # @!attribute [rw] content
159
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::Part>]
160
+ # Optional. Content is the container of the message content.
161
+ # @!attribute [rw] metadata
162
+ # @return [::Google::Protobuf::Struct]
163
+ # Optional. Any optional metadata to provide along with the message.
164
+ # @!attribute [rw] extensions
165
+ # @return [::Array<::String>]
166
+ # Optional. The URIs of extensions that are present or contributed to this
167
+ # Message.
168
+ class A2AMessage
169
+ include ::Google::Protobuf::MessageExts
170
+ extend ::Google::Protobuf::MessageExts::ClassMethods
171
+ end
172
+
173
+ # A2AArtifact is the container for task completed results.
174
+ # @!attribute [rw] artifact_id
175
+ # @return [::String]
176
+ # Optional. Unique identifier (e.g. UUID) for the artifact.
177
+ # @!attribute [rw] name
178
+ # @return [::String]
179
+ # Optional. A human readable name for the artifact.
180
+ # @!attribute [rw] description
181
+ # @return [::String]
182
+ # Optional. A human readable description of the artifact, optional.
183
+ # @!attribute [rw] parts
184
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::Part>]
185
+ # Optional. The content of the artifact.
186
+ # @!attribute [rw] metadata
187
+ # @return [::Google::Protobuf::Struct]
188
+ # Optional. Optional metadata included with the artifact.
189
+ # @!attribute [rw] extensions
190
+ # @return [::Array<::String>]
191
+ # Optional. The URIs of extensions that are present or contributed to this
192
+ # Artifact.
193
+ class A2AArtifact
194
+ include ::Google::Protobuf::MessageExts
195
+ extend ::Google::Protobuf::MessageExts::ClassMethods
196
+ end
197
+
198
+ # TaskStatusUpdateEvent is a delta event on a task indicating that a task
199
+ # has changed.
200
+ # @!attribute [rw] task_id
201
+ # @return [::String]
202
+ # Optional. The id of the task that is changed.
203
+ # @!attribute [rw] context_id
204
+ # @return [::String]
205
+ # Optional. The id of the context that the task belongs to.
206
+ # @!attribute [rw] status
207
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::TaskStatus]
208
+ # Optional. The new status of the task.
209
+ # @!attribute [rw] final
210
+ # @return [::Boolean]
211
+ # Optional. Whether this is the last status update expected for this task.
212
+ # @!attribute [rw] metadata
213
+ # @return [::Google::Protobuf::Struct]
214
+ # Optional. Optional metadata to associate with the task update.
215
+ class TaskStatusUpdateEvent
216
+ include ::Google::Protobuf::MessageExts
217
+ extend ::Google::Protobuf::MessageExts::ClassMethods
218
+ end
219
+
220
+ # TaskArtifactUpdateEvent represents a task delta where an artifact has
221
+ # been generated.
222
+ # @!attribute [rw] task_id
223
+ # @return [::String]
224
+ # Optional. The id of the task for this artifact.
225
+ # @!attribute [rw] context_id
226
+ # @return [::String]
227
+ # Optional. The id of the context that this task belongs to.
228
+ # @!attribute [rw] artifact
229
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::A2AArtifact]
230
+ # Optional. The artifact itself.
231
+ # @!attribute [rw] append
232
+ # @return [::Boolean]
233
+ # Optional. Whether this should be appended to a prior one produced.
234
+ # @!attribute [rw] last_chunk
235
+ # @return [::Boolean]
236
+ # Optional. Whether this represents the last part of an artifact.
237
+ # @!attribute [rw] metadata
238
+ # @return [::Google::Protobuf::Struct]
239
+ # Optional. Optional metadata associated with the artifact update.
240
+ class TaskArtifactUpdateEvent
241
+ include ::Google::Protobuf::MessageExts
242
+ extend ::Google::Protobuf::MessageExts::ClassMethods
243
+ end
244
+
245
+ # Configuration for setting up push notifications for task updates.
246
+ # @!attribute [rw] id
247
+ # @return [::String]
248
+ # Optional. A unique identifier (e.g. UUID) for this push notification.
249
+ # @!attribute [rw] url
250
+ # @return [::String]
251
+ # Optional. Url to send the notification to.
252
+ # @!attribute [rw] token
253
+ # @return [::String]
254
+ # Optional. Token unique for this task/session.
255
+ # @!attribute [rw] authentication
256
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AuthenticationInfo]
257
+ # Optional. Information about the authentication to send with the
258
+ # notification.
259
+ class PushNotificationConfig
260
+ include ::Google::Protobuf::MessageExts
261
+ extend ::Google::Protobuf::MessageExts::ClassMethods
262
+ end
263
+
264
+ # Defines authentication details, used for push notifications.
265
+ # @!attribute [rw] schemes
266
+ # @return [::Array<::String>]
267
+ # Optional. Supported authentication schemes - e.g. Basic, Bearer, etc.
268
+ # @!attribute [rw] credentials
269
+ # @return [::String]
270
+ # Optional. Optional credentials.
271
+ class AuthenticationInfo
272
+ include ::Google::Protobuf::MessageExts
273
+ extend ::Google::Protobuf::MessageExts::ClassMethods
274
+ end
275
+
276
+ # Defines additional transport information for the agent.
277
+ # @!attribute [rw] url
278
+ # @return [::String]
279
+ # Optional. The url this interface is found at.
280
+ # @!attribute [rw] transport
281
+ # @return [::String]
282
+ # Optional. The transport supported at this url.
283
+ # @!attribute [rw] tenant
284
+ # @return [::String]
285
+ # Optional. Tenant to be set in the request when calling the agent.
286
+ class AgentInterface
287
+ include ::Google::Protobuf::MessageExts
288
+ extend ::Google::Protobuf::MessageExts::ClassMethods
289
+ end
290
+
291
+ # AgentCard conveys key information about an agent.
292
+ # @!attribute [rw] protocol_version
293
+ # @return [::String]
294
+ # Optional. The version of the A2A protocol this agent supports.
295
+ # @!attribute [rw] name
296
+ # @return [::String]
297
+ # Optional. A human readable name for the agent.
298
+ # @!attribute [rw] description
299
+ # @return [::String]
300
+ # Optional. A description of the agent's domain of action/solution space.
301
+ # @!attribute [rw] url
302
+ # @return [::String]
303
+ # Optional. A URL to the address the agent is hosted at.
304
+ # @!attribute [rw] preferred_transport
305
+ # @return [::String]
306
+ # Optional. The transport of the preferred endpoint. If empty, defaults to
307
+ # JSONRPC.
308
+ # @!attribute [rw] additional_interfaces
309
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::AgentInterface>]
310
+ # Optional. Announcement of additional supported transports.
311
+ # @!attribute [rw] provider
312
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AgentProvider]
313
+ # Optional. The service provider of the agent.
314
+ # @!attribute [rw] version
315
+ # @return [::String]
316
+ # Optional. The version of the agent.
317
+ # @!attribute [rw] documentation_url
318
+ # @return [::String]
319
+ # Optional. A url to provide additional documentation about the agent.
320
+ # @!attribute [rw] capabilities
321
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AgentCapabilities]
322
+ # Optional. A2A Capability set supported by the agent.
323
+ # @!attribute [rw] security_schemes
324
+ # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::GeminiDataAnalytics::V1beta::SecurityScheme}]
325
+ # The security scheme details used for authenticating with this agent.
326
+ # @!attribute [rw] security
327
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::Security>]
328
+ # Security requirements for contacting the agent.
329
+ # @!attribute [rw] default_input_modes
330
+ # @return [::Array<::String>]
331
+ # Optional. The set of interaction modes that the agent supports across all
332
+ # skills.
333
+ # @!attribute [rw] default_output_modes
334
+ # @return [::Array<::String>]
335
+ # Optional. The mime types supported as outputs from this agent.
336
+ # @!attribute [rw] skills
337
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::AgentSkill>]
338
+ # Optional. Skills represent a unit of ability an agent can perform.
339
+ # @!attribute [rw] supports_authenticated_extended_card
340
+ # @return [::Boolean]
341
+ # Optional. Whether the agent supports providing an extended agent card when
342
+ # the user is authenticated.
343
+ # @!attribute [rw] signatures
344
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::AgentCardSignature>]
345
+ # Optional. JSON Web Signatures computed for this AgentCard.
346
+ # @!attribute [rw] icon_url
347
+ # @return [::String]
348
+ # Optional. An optional URL to an icon for the agent.
349
+ class AgentCard
350
+ include ::Google::Protobuf::MessageExts
351
+ extend ::Google::Protobuf::MessageExts::ClassMethods
352
+
353
+ # @!attribute [rw] key
354
+ # @return [::String]
355
+ # @!attribute [rw] value
356
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::SecurityScheme]
357
+ class SecuritySchemesEntry
358
+ include ::Google::Protobuf::MessageExts
359
+ extend ::Google::Protobuf::MessageExts::ClassMethods
360
+ end
361
+ end
362
+
363
+ # Represents information about the service provider of an agent.
364
+ # @!attribute [rw] url
365
+ # @return [::String]
366
+ # Optional. The provider's reference url.
367
+ # @!attribute [rw] organization
368
+ # @return [::String]
369
+ # Optional. The provider's organization name.
370
+ class AgentProvider
371
+ include ::Google::Protobuf::MessageExts
372
+ extend ::Google::Protobuf::MessageExts::ClassMethods
373
+ end
374
+
375
+ # Defines the A2A feature set supported by the agent.
376
+ # @!attribute [rw] streaming
377
+ # @return [::Boolean]
378
+ # Optional. If the agent will support streaming responses.
379
+ # @!attribute [rw] push_notifications
380
+ # @return [::Boolean]
381
+ # Optional. If the agent can send push notifications to the client's webhook.
382
+ # @!attribute [rw] extensions
383
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::AgentExtension>]
384
+ # Optional. Extensions supported by this agent.
385
+ class AgentCapabilities
386
+ include ::Google::Protobuf::MessageExts
387
+ extend ::Google::Protobuf::MessageExts::ClassMethods
388
+ end
389
+
390
+ # A declaration of an extension supported by an Agent.
391
+ # @!attribute [rw] uri
392
+ # @return [::String]
393
+ # Optional. The URI of the extension.
394
+ # @!attribute [rw] description
395
+ # @return [::String]
396
+ # Optional. A description of how this agent uses this extension.
397
+ # @!attribute [rw] required
398
+ # @return [::Boolean]
399
+ # Optional. Whether the client must follow specific requirements of the
400
+ # extension.
401
+ # @!attribute [rw] params
402
+ # @return [::Google::Protobuf::Struct]
403
+ # Optional. Optional configuration for the extension.
404
+ class AgentExtension
405
+ include ::Google::Protobuf::MessageExts
406
+ extend ::Google::Protobuf::MessageExts::ClassMethods
407
+ end
408
+
409
+ # AgentSkill represents a unit of action/solution that the agent can perform.
410
+ # @!attribute [rw] id
411
+ # @return [::String]
412
+ # Optional. Unique identifier of the skill within this agent.
413
+ # @!attribute [rw] name
414
+ # @return [::String]
415
+ # Optional. A human readable name for the skill.
416
+ # @!attribute [rw] description
417
+ # @return [::String]
418
+ # Optional. A human readable description of the skill details and behaviors.
419
+ # @!attribute [rw] tags
420
+ # @return [::Array<::String>]
421
+ # Optional. A set of tags for the skill to enhance
422
+ # categorization/utilization.
423
+ # @!attribute [rw] examples
424
+ # @return [::Array<::String>]
425
+ # Optional. A set of example queries that this skill is designed to address.
426
+ # @!attribute [rw] input_modes
427
+ # @return [::Array<::String>]
428
+ # Optional. Possible input modalities supported.
429
+ # @!attribute [rw] output_modes
430
+ # @return [::Array<::String>]
431
+ # Optional. Possible output modalities produced.
432
+ # @!attribute [rw] security
433
+ # @return [::Array<::Google::Cloud::GeminiDataAnalytics::V1beta::Security>]
434
+ # Security schemes necessary for the agent to leverage this skill.
435
+ class AgentSkill
436
+ include ::Google::Protobuf::MessageExts
437
+ extend ::Google::Protobuf::MessageExts::ClassMethods
438
+ end
439
+
440
+ # AgentCardSignature represents a JWS signature of an AgentCard.
441
+ # @!attribute [rw] protected
442
+ # @return [::String]
443
+ # Required. The protected JWS header for the signature. Base64url-encoded.
444
+ # @!attribute [rw] signature
445
+ # @return [::String]
446
+ # Required. The computed signature, base64url-encoded.
447
+ # @!attribute [rw] header
448
+ # @return [::Google::Protobuf::Struct]
449
+ # Optional. The unprotected JWS header values.
450
+ class AgentCardSignature
451
+ include ::Google::Protobuf::MessageExts
452
+ extend ::Google::Protobuf::MessageExts::ClassMethods
453
+ end
454
+
455
+ # StringList is a wrapper for a repeated list of strings.
456
+ # @!attribute [rw] list
457
+ # @return [::Array<::String>]
458
+ # The list of strings.
459
+ class StringList
460
+ include ::Google::Protobuf::MessageExts
461
+ extend ::Google::Protobuf::MessageExts::ClassMethods
462
+ end
463
+
464
+ # Security requirements for contacting the agent.
465
+ # @!attribute [rw] schemes
466
+ # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::GeminiDataAnalytics::V1beta::StringList}]
467
+ # Map of scheme names to lists of scopes or configurations.
468
+ class Security
469
+ include ::Google::Protobuf::MessageExts
470
+ extend ::Google::Protobuf::MessageExts::ClassMethods
471
+
472
+ # @!attribute [rw] key
473
+ # @return [::String]
474
+ # @!attribute [rw] value
475
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::StringList]
476
+ class SchemesEntry
477
+ include ::Google::Protobuf::MessageExts
478
+ extend ::Google::Protobuf::MessageExts::ClassMethods
479
+ end
480
+ end
481
+
482
+ # SecurityScheme defines a security scheme for contacting the agent.
483
+ # @!attribute [rw] api_key_security_scheme
484
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::APIKeySecurityScheme]
485
+ # API key security scheme.
486
+ #
487
+ # Note: The following fields are mutually exclusive: `api_key_security_scheme`, `http_auth_security_scheme`, `oauth2_security_scheme`, `open_id_connect_security_scheme`, `mtls_security_scheme`. If a field in that set is populated, all other fields in the set will automatically be cleared.
488
+ # @!attribute [rw] http_auth_security_scheme
489
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::HTTPAuthSecurityScheme]
490
+ # HTTP authentication security scheme.
491
+ #
492
+ # Note: The following fields are mutually exclusive: `http_auth_security_scheme`, `api_key_security_scheme`, `oauth2_security_scheme`, `open_id_connect_security_scheme`, `mtls_security_scheme`. If a field in that set is populated, all other fields in the set will automatically be cleared.
493
+ # @!attribute [rw] oauth2_security_scheme
494
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::OAuth2SecurityScheme]
495
+ # OAuth2 security scheme.
496
+ #
497
+ # Note: The following fields are mutually exclusive: `oauth2_security_scheme`, `api_key_security_scheme`, `http_auth_security_scheme`, `open_id_connect_security_scheme`, `mtls_security_scheme`. If a field in that set is populated, all other fields in the set will automatically be cleared.
498
+ # @!attribute [rw] open_id_connect_security_scheme
499
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::OpenIdConnectSecurityScheme]
500
+ # OpenID Connect security scheme.
501
+ #
502
+ # Note: The following fields are mutually exclusive: `open_id_connect_security_scheme`, `api_key_security_scheme`, `http_auth_security_scheme`, `oauth2_security_scheme`, `mtls_security_scheme`. If a field in that set is populated, all other fields in the set will automatically be cleared.
503
+ # @!attribute [rw] mtls_security_scheme
504
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::MutualTlsSecurityScheme]
505
+ # Mutual TLS security scheme.
506
+ #
507
+ # Note: The following fields are mutually exclusive: `mtls_security_scheme`, `api_key_security_scheme`, `http_auth_security_scheme`, `oauth2_security_scheme`, `open_id_connect_security_scheme`. If a field in that set is populated, all other fields in the set will automatically be cleared.
508
+ class SecurityScheme
509
+ include ::Google::Protobuf::MessageExts
510
+ extend ::Google::Protobuf::MessageExts::ClassMethods
511
+ end
512
+
513
+ # APIKeySecurityScheme defines an API key security scheme.
514
+ # @!attribute [rw] description
515
+ # @return [::String]
516
+ # Optional. Description of this security scheme.
517
+ # @!attribute [rw] location
518
+ # @return [::String]
519
+ # Optional. Location of the API key, valid values are "query", "header", or
520
+ # "cookie".
521
+ # @!attribute [rw] name
522
+ # @return [::String]
523
+ # Optional. Name of the header, query or cookie parameter to be used.
524
+ class APIKeySecurityScheme
525
+ include ::Google::Protobuf::MessageExts
526
+ extend ::Google::Protobuf::MessageExts::ClassMethods
527
+ end
528
+
529
+ # HTTPAuthSecurityScheme defines an HTTP authentication security scheme.
530
+ # @!attribute [rw] description
531
+ # @return [::String]
532
+ # Optional. Description of this security scheme.
533
+ # @!attribute [rw] scheme
534
+ # @return [::String]
535
+ # Optional. The name of the HTTP Authentication scheme to be used in the
536
+ # Authorization header.
537
+ # @!attribute [rw] bearer_format
538
+ # @return [::String]
539
+ # Optional. A hint to the client to identify how the bearer token is
540
+ # formatted.
541
+ class HTTPAuthSecurityScheme
542
+ include ::Google::Protobuf::MessageExts
543
+ extend ::Google::Protobuf::MessageExts::ClassMethods
544
+ end
545
+
546
+ # OAuth2SecurityScheme defines an OAuth2 security scheme.
547
+ # @!attribute [rw] description
548
+ # @return [::String]
549
+ # Optional. Description of this security scheme.
550
+ # @!attribute [rw] flows
551
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::OAuthFlows]
552
+ # Optional. An object containing configuration information for the flow types
553
+ # supported.
554
+ # @!attribute [rw] oauth2_metadata_url
555
+ # @return [::String]
556
+ # Optional. URL to the oauth2 authorization server metadata.
557
+ class OAuth2SecurityScheme
558
+ include ::Google::Protobuf::MessageExts
559
+ extend ::Google::Protobuf::MessageExts::ClassMethods
560
+ end
561
+
562
+ # OpenIdConnectSecurityScheme defines an OpenID Connect security scheme.
563
+ # @!attribute [rw] description
564
+ # @return [::String]
565
+ # Optional. Description of this security scheme.
566
+ # @!attribute [rw] open_id_connect_url
567
+ # @return [::String]
568
+ # Optional. Well-known URL to discover the OpenID Connect provider metadata.
569
+ class OpenIdConnectSecurityScheme
570
+ include ::Google::Protobuf::MessageExts
571
+ extend ::Google::Protobuf::MessageExts::ClassMethods
572
+ end
573
+
574
+ # MutualTlsSecurityScheme defines a Mutual TLS security scheme.
575
+ # @!attribute [rw] description
576
+ # @return [::String]
577
+ # Optional. Description of this security scheme.
578
+ class MutualTlsSecurityScheme
579
+ include ::Google::Protobuf::MessageExts
580
+ extend ::Google::Protobuf::MessageExts::ClassMethods
581
+ end
582
+
583
+ # OAuthFlows contains configuration information for supported OAuth flows.
584
+ # @!attribute [rw] authorization_code
585
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::AuthorizationCodeOAuthFlow]
586
+ # Authorization code flow.
587
+ #
588
+ # Note: The following fields are mutually exclusive: `authorization_code`, `client_credentials`, `implicit`, `password`. If a field in that set is populated, all other fields in the set will automatically be cleared.
589
+ # @!attribute [rw] client_credentials
590
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ClientCredentialsOAuthFlow]
591
+ # Client credentials flow.
592
+ #
593
+ # Note: The following fields are mutually exclusive: `client_credentials`, `authorization_code`, `implicit`, `password`. If a field in that set is populated, all other fields in the set will automatically be cleared.
594
+ # @!attribute [rw] implicit
595
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::ImplicitOAuthFlow]
596
+ # Implicit flow.
597
+ #
598
+ # Note: The following fields are mutually exclusive: `implicit`, `authorization_code`, `client_credentials`, `password`. If a field in that set is populated, all other fields in the set will automatically be cleared.
599
+ # @!attribute [rw] password
600
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::PasswordOAuthFlow]
601
+ # Resource owner password credentials flow.
602
+ #
603
+ # Note: The following fields are mutually exclusive: `password`, `authorization_code`, `client_credentials`, `implicit`. If a field in that set is populated, all other fields in the set will automatically be cleared.
604
+ class OAuthFlows
605
+ include ::Google::Protobuf::MessageExts
606
+ extend ::Google::Protobuf::MessageExts::ClassMethods
607
+ end
608
+
609
+ # AuthorizationCodeOAuthFlow defines an authorization code OAuth flow.
610
+ # @!attribute [rw] authorization_url
611
+ # @return [::String]
612
+ # Optional. The authorization URL to be used for this flow.
613
+ # @!attribute [rw] token_url
614
+ # @return [::String]
615
+ # Optional. The token URL to be used for this flow.
616
+ # @!attribute [rw] refresh_url
617
+ # @return [::String]
618
+ # Optional. The URL to be used for obtaining refresh tokens.
619
+ # @!attribute [rw] scopes
620
+ # @return [::Google::Protobuf::Map{::String => ::String}]
621
+ # The available scopes for the OAuth2 security scheme.
622
+ class AuthorizationCodeOAuthFlow
623
+ include ::Google::Protobuf::MessageExts
624
+ extend ::Google::Protobuf::MessageExts::ClassMethods
625
+
626
+ # @!attribute [rw] key
627
+ # @return [::String]
628
+ # @!attribute [rw] value
629
+ # @return [::String]
630
+ class ScopesEntry
631
+ include ::Google::Protobuf::MessageExts
632
+ extend ::Google::Protobuf::MessageExts::ClassMethods
633
+ end
634
+ end
635
+
636
+ # ClientCredentialsOAuthFlow defines a client credentials OAuth flow.
637
+ # @!attribute [rw] token_url
638
+ # @return [::String]
639
+ # Optional. The token URL to be used for this flow.
640
+ # @!attribute [rw] refresh_url
641
+ # @return [::String]
642
+ # Optional. The URL to be used for obtaining refresh tokens.
643
+ # @!attribute [rw] scopes
644
+ # @return [::Google::Protobuf::Map{::String => ::String}]
645
+ # The available scopes for the OAuth2 security scheme.
646
+ class ClientCredentialsOAuthFlow
647
+ include ::Google::Protobuf::MessageExts
648
+ extend ::Google::Protobuf::MessageExts::ClassMethods
649
+
650
+ # @!attribute [rw] key
651
+ # @return [::String]
652
+ # @!attribute [rw] value
653
+ # @return [::String]
654
+ class ScopesEntry
655
+ include ::Google::Protobuf::MessageExts
656
+ extend ::Google::Protobuf::MessageExts::ClassMethods
657
+ end
658
+ end
659
+
660
+ # ImplicitOAuthFlow defines an implicit OAuth flow.
661
+ # @!attribute [rw] authorization_url
662
+ # @return [::String]
663
+ # Optional. The authorization URL to be used for this flow.
664
+ # @!attribute [rw] refresh_url
665
+ # @return [::String]
666
+ # Optional. The URL to be used for obtaining refresh tokens.
667
+ # @!attribute [rw] scopes
668
+ # @return [::Google::Protobuf::Map{::String => ::String}]
669
+ # The available scopes for the OAuth2 security scheme.
670
+ class ImplicitOAuthFlow
671
+ include ::Google::Protobuf::MessageExts
672
+ extend ::Google::Protobuf::MessageExts::ClassMethods
673
+
674
+ # @!attribute [rw] key
675
+ # @return [::String]
676
+ # @!attribute [rw] value
677
+ # @return [::String]
678
+ class ScopesEntry
679
+ include ::Google::Protobuf::MessageExts
680
+ extend ::Google::Protobuf::MessageExts::ClassMethods
681
+ end
682
+ end
683
+
684
+ # PasswordOAuthFlow defines a password OAuth flow.
685
+ # @!attribute [rw] token_url
686
+ # @return [::String]
687
+ # Optional. The token URL to be used for this flow.
688
+ # @!attribute [rw] refresh_url
689
+ # @return [::String]
690
+ # Optional. The URL to be used for obtaining refresh tokens.
691
+ # @!attribute [rw] scopes
692
+ # @return [::Google::Protobuf::Map{::String => ::String}]
693
+ # The available scopes for the OAuth2 security scheme.
694
+ class PasswordOAuthFlow
695
+ include ::Google::Protobuf::MessageExts
696
+ extend ::Google::Protobuf::MessageExts::ClassMethods
697
+
698
+ # @!attribute [rw] key
699
+ # @return [::String]
700
+ # @!attribute [rw] value
701
+ # @return [::String]
702
+ class ScopesEntry
703
+ include ::Google::Protobuf::MessageExts
704
+ extend ::Google::Protobuf::MessageExts::ClassMethods
705
+ end
706
+ end
707
+
708
+ # Request message for SendMessage and SendStreamingMessage.
709
+ # @!attribute [rw] message
710
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::A2AMessage]
711
+ # Required. The message to send to the agent.
712
+ # @!attribute [rw] configuration
713
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::SendMessageConfiguration]
714
+ # Optional. Configuration for the send request.
715
+ # @!attribute [rw] metadata
716
+ # @return [::Google::Protobuf::Struct]
717
+ # Optional. Optional metadata for the request.
718
+ # @!attribute [rw] tenant
719
+ # @return [::String]
720
+ # Optional. Optional tenant, provided as a path parameter.
721
+ class SendMessageRequest
722
+ include ::Google::Protobuf::MessageExts
723
+ extend ::Google::Protobuf::MessageExts::ClassMethods
724
+ end
725
+
726
+ # Request message for GetAgentCard.
727
+ # @!attribute [rw] tenant
728
+ # @return [::String]
729
+ # Optional. Optional tenant, provided as a path parameter.
730
+ class GetAgentCardRequest
731
+ include ::Google::Protobuf::MessageExts
732
+ extend ::Google::Protobuf::MessageExts::ClassMethods
733
+ end
734
+
735
+ # Response message for SendMessage.
736
+ # @!attribute [rw] task
737
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::A2ATask]
738
+ # Completed task.
739
+ #
740
+ # Note: The following fields are mutually exclusive: `task`, `msg`. If a field in that set is populated, all other fields in the set will automatically be cleared.
741
+ # @!attribute [rw] msg
742
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::A2AMessage]
743
+ # Single message response.
744
+ #
745
+ # Note: The following fields are mutually exclusive: `msg`, `task`. If a field in that set is populated, all other fields in the set will automatically be cleared.
746
+ class SendMessageResponse
747
+ include ::Google::Protobuf::MessageExts
748
+ extend ::Google::Protobuf::MessageExts::ClassMethods
749
+ end
750
+
751
+ # The stream response for a message.
752
+ # @!attribute [rw] task
753
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::A2ATask]
754
+ # Completed task event.
755
+ #
756
+ # Note: The following fields are mutually exclusive: `task`, `msg`, `status_update`, `artifact_update`. If a field in that set is populated, all other fields in the set will automatically be cleared.
757
+ # @!attribute [rw] msg
758
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::A2AMessage]
759
+ # Message event.
760
+ #
761
+ # Note: The following fields are mutually exclusive: `msg`, `task`, `status_update`, `artifact_update`. If a field in that set is populated, all other fields in the set will automatically be cleared.
762
+ # @!attribute [rw] status_update
763
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::TaskStatusUpdateEvent]
764
+ # Task status update event.
765
+ #
766
+ # Note: The following fields are mutually exclusive: `status_update`, `task`, `msg`, `artifact_update`. If a field in that set is populated, all other fields in the set will automatically be cleared.
767
+ # @!attribute [rw] artifact_update
768
+ # @return [::Google::Cloud::GeminiDataAnalytics::V1beta::TaskArtifactUpdateEvent]
769
+ # Task artifact update event.
770
+ #
771
+ # Note: The following fields are mutually exclusive: `artifact_update`, `task`, `msg`, `status_update`. If a field in that set is populated, all other fields in the set will automatically be cleared.
772
+ class StreamResponse
773
+ include ::Google::Protobuf::MessageExts
774
+ extend ::Google::Protobuf::MessageExts::ClassMethods
775
+ end
776
+
777
+ # The set of states a Task can be in.
778
+ module TaskState
779
+ # Default unspecified task state.
780
+ TASK_STATE_UNSPECIFIED = 0
781
+
782
+ # Represents the status that acknowledges a task is created.
783
+ TASK_STATE_SUBMITTED = 1
784
+
785
+ # Represents the status that a task is currently in progress.
786
+ TASK_STATE_WORKING = 2
787
+
788
+ # Represents the status that a task is completed. This is a terminal state.
789
+ TASK_STATE_COMPLETED = 3
790
+
791
+ # Represents the status that a task has failed. This is a terminal state.
792
+ TASK_STATE_FAILED = 4
793
+
794
+ # Represents the status that a task was cancelled before it finished.
795
+ # This is a terminal state.
796
+ TASK_STATE_CANCELLED = 5
797
+
798
+ # Represents the status that the task requires information to complete.
799
+ # This is an interrupted state.
800
+ TASK_STATE_INPUT_REQUIRED = 6
801
+
802
+ # Represents the status that a task has been rejected by the agent.
803
+ # This is a terminal state.
804
+ TASK_STATE_REJECTED = 7
805
+
806
+ # Represents the state that some authentication is needed from the upstream
807
+ # client.
808
+ TASK_STATE_AUTH_REQUIRED = 8
809
+ end
810
+
811
+ # Role indicates the sender of a message.
812
+ module Role
813
+ # Default unspecified role.
814
+ ROLE_UNSPECIFIED = 0
815
+
816
+ # USER role refers to communication from the client to the server.
817
+ ROLE_USER = 1
818
+
819
+ # AGENT role refers to communication from the server to the client.
820
+ ROLE_AGENT = 2
821
+ end
822
+ end
823
+ end
824
+ end
825
+ end