yandexcloud 0.321.0__py3-none-any.whl → 0.322.0__py3-none-any.whl

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.

Potentially problematic release.


This version of yandexcloud might be problematic. Click here for more details.

Files changed (103) hide show
  1. yandex/cloud/ai/assistants/v1/assistant_pb2.pyi +38 -8
  2. yandex/cloud/ai/assistants/v1/assistant_service_pb2.pyi +89 -15
  3. yandex/cloud/ai/assistants/v1/assistant_service_pb2_grpc.py +18 -9
  4. yandex/cloud/ai/assistants/v1/assistant_service_pb2_grpc.pyi +30 -6
  5. yandex/cloud/ai/assistants/v1/common_pb2.pyi +37 -6
  6. yandex/cloud/ai/assistants/v1/runs/run_pb2.pyi +55 -9
  7. yandex/cloud/ai/assistants/v1/runs/run_service_pb2.pyi +74 -11
  8. yandex/cloud/ai/assistants/v1/runs/run_service_pb2_grpc.py +18 -8
  9. yandex/cloud/ai/assistants/v1/runs/run_service_pb2_grpc.pyi +35 -5
  10. yandex/cloud/ai/assistants/v1/searchindex/common_pb2.pyi +15 -0
  11. yandex/cloud/ai/assistants/v1/searchindex/search_index_file_pb2.pyi +8 -1
  12. yandex/cloud/ai/assistants/v1/searchindex/search_index_file_service_pb2.pyi +15 -1
  13. yandex/cloud/ai/assistants/v1/searchindex/search_index_file_service_pb2_grpc.py +10 -5
  14. yandex/cloud/ai/assistants/v1/searchindex/search_index_file_service_pb2_grpc.pyi +14 -2
  15. yandex/cloud/ai/assistants/v1/searchindex/search_index_pb2.pyi +45 -9
  16. yandex/cloud/ai/assistants/v1/searchindex/search_index_service_pb2.pyi +52 -9
  17. yandex/cloud/ai/assistants/v1/searchindex/search_index_service_pb2_grpc.py +16 -8
  18. yandex/cloud/ai/assistants/v1/searchindex/search_index_service_pb2_grpc.pyi +26 -5
  19. yandex/cloud/ai/assistants/v1/threads/message_pb2.py +18 -16
  20. yandex/cloud/ai/assistants/v1/threads/message_pb2.pyi +84 -10
  21. yandex/cloud/ai/assistants/v1/threads/message_service_pb2.pyi +21 -3
  22. yandex/cloud/ai/assistants/v1/threads/message_service_pb2_grpc.py +13 -6
  23. yandex/cloud/ai/assistants/v1/threads/message_service_pb2_grpc.pyi +24 -3
  24. yandex/cloud/ai/assistants/v1/threads/thread_pb2.pyi +22 -5
  25. yandex/cloud/ai/assistants/v1/threads/thread_service_pb2.pyi +47 -7
  26. yandex/cloud/ai/assistants/v1/threads/thread_service_pb2_grpc.py +16 -8
  27. yandex/cloud/ai/assistants/v1/threads/thread_service_pb2_grpc.pyi +26 -5
  28. yandex/cloud/ai/assistants/v1/users/user_pb2.pyi +21 -5
  29. yandex/cloud/ai/assistants/v1/users/user_service_pb2.pyi +43 -6
  30. yandex/cloud/ai/assistants/v1/users/user_service_pb2_grpc.py +16 -8
  31. yandex/cloud/ai/assistants/v1/users/user_service_pb2_grpc.pyi +26 -5
  32. yandex/cloud/ai/dataset/__init__.py +0 -0
  33. yandex/cloud/ai/dataset/v1/__init__.py +0 -0
  34. yandex/cloud/ai/dataset/v1/dataset_pb2.py +35 -0
  35. yandex/cloud/ai/dataset/v1/dataset_pb2.pyi +161 -0
  36. yandex/cloud/ai/dataset/v1/dataset_pb2_grpc.py +4 -0
  37. yandex/cloud/ai/dataset/v1/dataset_pb2_grpc.pyi +17 -0
  38. yandex/cloud/ai/dataset/v1/dataset_service_pb2.py +117 -0
  39. yandex/cloud/ai/dataset/v1/dataset_service_pb2.pyi +520 -0
  40. yandex/cloud/ai/dataset/v1/dataset_service_pb2_grpc.py +378 -0
  41. yandex/cloud/ai/dataset/v1/dataset_service_pb2_grpc.pyi +237 -0
  42. yandex/cloud/ai/files/v1/file_pb2.pyi +22 -5
  43. yandex/cloud/ai/files/v1/file_service_pb2.pyi +53 -6
  44. yandex/cloud/ai/files/v1/file_service_pb2_grpc.py +18 -9
  45. yandex/cloud/ai/files/v1/file_service_pb2_grpc.pyi +30 -6
  46. yandex/cloud/ai/foundation_models/v1/text_common_pb2.py +30 -13
  47. yandex/cloud/ai/foundation_models/v1/text_common_pb2.pyi +197 -0
  48. yandex/cloud/ai/foundation_models/v1/text_generation/text_generation_service_pb2.py +14 -14
  49. yandex/cloud/ai/foundation_models/v1/text_generation/text_generation_service_pb2.pyi +9 -1
  50. yandex/cloud/apploadbalancer/v1/load_balancer_pb2.py +52 -51
  51. yandex/cloud/apploadbalancer/v1/load_balancer_pb2.pyi +11 -1
  52. yandex/cloud/apploadbalancer/v1/rate_limit_pb2.py +35 -0
  53. yandex/cloud/apploadbalancer/v1/rate_limit_pb2.pyi +62 -0
  54. yandex/cloud/apploadbalancer/v1/rate_limit_pb2_grpc.py +4 -0
  55. yandex/cloud/apploadbalancer/v1/rate_limit_pb2_grpc.pyi +17 -0
  56. yandex/cloud/apploadbalancer/v1/virtual_host_pb2.py +44 -43
  57. yandex/cloud/apploadbalancer/v1/virtual_host_pb2.pyi +25 -6
  58. yandex/cloud/apploadbalancer/v1/virtual_host_service_pb2.py +30 -29
  59. yandex/cloud/apploadbalancer/v1/virtual_host_service_pb2.pyi +17 -4
  60. yandex/cloud/compute/v1/disk_pb2.py +12 -11
  61. yandex/cloud/compute/v1/disk_pb2.pyi +9 -2
  62. yandex/cloud/compute/v1/disk_service_pb2.py +36 -34
  63. yandex/cloud/compute/v1/disk_service_pb2.pyi +5 -1
  64. yandex/cloud/compute/v1/image_pb2.py +12 -11
  65. yandex/cloud/compute/v1/image_pb2.pyi +9 -2
  66. yandex/cloud/compute/v1/instance_service_pb2.py +39 -37
  67. yandex/cloud/compute/v1/instance_service_pb2.pyi +11 -7
  68. yandex/cloud/compute/v1/kek_pb2.py +26 -0
  69. yandex/cloud/compute/v1/kek_pb2.pyi +31 -0
  70. yandex/cloud/compute/v1/kek_pb2_grpc.py +4 -0
  71. yandex/cloud/compute/v1/kek_pb2_grpc.pyi +17 -0
  72. yandex/cloud/compute/v1/snapshot_pb2.py +8 -7
  73. yandex/cloud/compute/v1/snapshot_pb2.pyi +9 -2
  74. yandex/cloud/datasphere/v1/project_pb2.py +6 -8
  75. yandex/cloud/datasphere/v1/project_pb2.pyi +1 -35
  76. yandex/cloud/datasphere/v1/project_service_pb2.py +39 -70
  77. yandex/cloud/datasphere/v1/project_service_pb2.pyi +0 -171
  78. yandex/cloud/datasphere/v1/project_service_pb2_grpc.py +0 -102
  79. yandex/cloud/datasphere/v1/project_service_pb2_grpc.pyi +0 -60
  80. yandex/cloud/datasphere/v2/jobs/jobs_pb2.py +21 -19
  81. yandex/cloud/datasphere/v2/jobs/jobs_pb2.pyi +50 -1
  82. yandex/cloud/datasphere/v2/project_pb2.py +11 -15
  83. yandex/cloud/datasphere/v2/project_pb2.pyi +1 -55
  84. yandex/cloud/datasphere/v2/project_service_pb2.py +73 -84
  85. yandex/cloud/datasphere/v2/project_service_pb2.pyi +102 -119
  86. yandex/cloud/datasphere/v2/project_service_pb2_grpc.py +34 -70
  87. yandex/cloud/datasphere/v2/project_service_pb2_grpc.pyi +20 -52
  88. yandex/cloud/datasphere/v2/resource_types_pb2.py +2 -2
  89. yandex/cloud/datasphere/v2/resource_types_pb2.pyi +0 -4
  90. yandex/cloud/k8s/v1/cluster_service_pb2.py +38 -38
  91. yandex/cloud/k8s/v1/cluster_service_pb2.pyi +8 -2
  92. yandex/cloud/mdb/kafka/v1/cluster_pb2.py +26 -24
  93. yandex/cloud/mdb/kafka/v1/cluster_pb2.pyi +32 -5
  94. yandex/cloud/mdb/kafka/v1/connector_service_pb2.py +37 -37
  95. yandex/cloud/mdb/kafka/v1/user_pb2.pyi +1 -0
  96. yandex/cloud/mdb/redis/v1/config/redis_pb2.py +16 -8
  97. yandex/cloud/mdb/redis/v1/config/redis_pb2.pyi +56 -2
  98. {yandexcloud-0.321.0.dist-info → yandexcloud-0.322.0.dist-info}/METADATA +1 -1
  99. {yandexcloud-0.321.0.dist-info → yandexcloud-0.322.0.dist-info}/RECORD +103 -85
  100. {yandexcloud-0.321.0.dist-info → yandexcloud-0.322.0.dist-info}/WHEEL +1 -1
  101. {yandexcloud-0.321.0.dist-info → yandexcloud-0.322.0.dist-info}/AUTHORS +0 -0
  102. {yandexcloud-0.321.0.dist-info → yandexcloud-0.322.0.dist-info}/LICENSE +0 -0
  103. {yandexcloud-0.321.0.dist-info → yandexcloud-0.322.0.dist-info}/top_level.txt +0 -0
@@ -7,16 +7,50 @@ import builtins
7
7
  import collections.abc
8
8
  import google.protobuf.descriptor
9
9
  import google.protobuf.internal.containers
10
+ import google.protobuf.internal.enum_type_wrapper
10
11
  import google.protobuf.message
11
12
  import google.protobuf.timestamp_pb2
13
+ import sys
12
14
  import typing
13
15
 
16
+ if sys.version_info >= (3, 10):
17
+ import typing as typing_extensions
18
+ else:
19
+ import typing_extensions
20
+
14
21
  DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
15
22
 
16
23
  @typing.final
17
24
  class Message(google.protobuf.message.Message):
18
25
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
19
26
 
27
+ class _MessageStatus:
28
+ ValueType = typing.NewType("ValueType", builtins.int)
29
+ V: typing_extensions.TypeAlias = ValueType
30
+
31
+ class _MessageStatusEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[Message._MessageStatus.ValueType], builtins.type):
32
+ DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
33
+ MESSAGE_STATUS_UNSPECIFIED: Message._MessageStatus.ValueType # 0
34
+ """Unspecified message status."""
35
+ COMPLETED: Message._MessageStatus.ValueType # 1
36
+ """Message was successfully created by a user or generated by an assistant."""
37
+ TRUNCATED: Message._MessageStatus.ValueType # 2
38
+ """Message generation was truncated due to reaching the maximum allowed number of tokens."""
39
+ FILTERED_CONTENT: Message._MessageStatus.ValueType # 3
40
+ """Message generation was stopped because potentially sensitive content was detected either in the prompt or in the generated response."""
41
+
42
+ class MessageStatus(_MessageStatus, metaclass=_MessageStatusEnumTypeWrapper):
43
+ """Enum representing the status of a message."""
44
+
45
+ MESSAGE_STATUS_UNSPECIFIED: Message.MessageStatus.ValueType # 0
46
+ """Unspecified message status."""
47
+ COMPLETED: Message.MessageStatus.ValueType # 1
48
+ """Message was successfully created by a user or generated by an assistant."""
49
+ TRUNCATED: Message.MessageStatus.ValueType # 2
50
+ """Message generation was truncated due to reaching the maximum allowed number of tokens."""
51
+ FILTERED_CONTENT: Message.MessageStatus.ValueType # 3
52
+ """Message generation was stopped because potentially sensitive content was detected either in the prompt or in the generated response."""
53
+
20
54
  @typing.final
21
55
  class LabelsEntry(google.protobuf.message.Message):
22
56
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
@@ -40,17 +74,31 @@ class Message(google.protobuf.message.Message):
40
74
  AUTHOR_FIELD_NUMBER: builtins.int
41
75
  LABELS_FIELD_NUMBER: builtins.int
42
76
  CONTENT_FIELD_NUMBER: builtins.int
77
+ STATUS_FIELD_NUMBER: builtins.int
43
78
  id: builtins.str
79
+ """Unique identifier of the message."""
44
80
  thread_id: builtins.str
81
+ """ID of the thread that this message belongs to."""
45
82
  created_by: builtins.str
83
+ """Identifier of the subject who created this message."""
84
+ status: global___Message.MessageStatus.ValueType
85
+ """Status of the message."""
46
86
  @property
47
- def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
87
+ def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
88
+ """Timestamp representing when the message was created."""
89
+
48
90
  @property
49
- def author(self) -> global___Author: ...
91
+ def author(self) -> global___Author:
92
+ """Author of the message, containing details about the message's creator."""
93
+
50
94
  @property
51
- def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]: ...
95
+ def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
96
+ """Set of key-value pairs that can be used to organize and categorize the message."""
97
+
52
98
  @property
53
- def content(self) -> global___MessageContent: ...
99
+ def content(self) -> global___MessageContent:
100
+ """Content of the message."""
101
+
54
102
  def __init__(
55
103
  self,
56
104
  *,
@@ -61,19 +109,24 @@ class Message(google.protobuf.message.Message):
61
109
  author: global___Author | None = ...,
62
110
  labels: collections.abc.Mapping[builtins.str, builtins.str] | None = ...,
63
111
  content: global___MessageContent | None = ...,
112
+ status: global___Message.MessageStatus.ValueType = ...,
64
113
  ) -> None: ...
65
114
  def HasField(self, field_name: typing.Literal["author", b"author", "content", b"content", "created_at", b"created_at"]) -> builtins.bool: ...
66
- def ClearField(self, field_name: typing.Literal["author", b"author", "content", b"content", "created_at", b"created_at", "created_by", b"created_by", "id", b"id", "labels", b"labels", "thread_id", b"thread_id"]) -> None: ...
115
+ def ClearField(self, field_name: typing.Literal["author", b"author", "content", b"content", "created_at", b"created_at", "created_by", b"created_by", "id", b"id", "labels", b"labels", "status", b"status", "thread_id", b"thread_id"]) -> None: ...
67
116
 
68
117
  global___Message = Message
69
118
 
70
119
  @typing.final
71
120
  class MessageContent(google.protobuf.message.Message):
121
+ """Represents the content of a message, which can consist of multiple parts."""
122
+
72
123
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
73
124
 
74
125
  CONTENT_FIELD_NUMBER: builtins.int
75
126
  @property
76
- def content(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___ContentPart]: ...
127
+ def content(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___ContentPart]:
128
+ """A list of content parts that make up the message."""
129
+
77
130
  def __init__(
78
131
  self,
79
132
  *,
@@ -85,6 +138,10 @@ global___MessageContent = MessageContent
85
138
 
86
139
  @typing.final
87
140
  class MessageData(google.protobuf.message.Message):
141
+ """Represents the data required to create or initialize a message in a thread.
142
+ This message is used, for example, to initialize a thread with some messages upon its creation.
143
+ """
144
+
88
145
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
89
146
 
90
147
  @typing.final
@@ -107,11 +164,17 @@ class MessageData(google.protobuf.message.Message):
107
164
  LABELS_FIELD_NUMBER: builtins.int
108
165
  CONTENT_FIELD_NUMBER: builtins.int
109
166
  @property
110
- def author(self) -> global___Author: ...
167
+ def author(self) -> global___Author:
168
+ """Author of the message, containing details about the message's creator."""
169
+
111
170
  @property
112
- def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]: ...
171
+ def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
172
+ """Set of key-value pairs that can be used to organize and categorize the message."""
173
+
113
174
  @property
114
- def content(self) -> global___MessageContent: ...
175
+ def content(self) -> global___MessageContent:
176
+ """Content of the message."""
177
+
115
178
  def __init__(
116
179
  self,
117
180
  *,
@@ -126,10 +189,13 @@ global___MessageData = MessageData
126
189
 
127
190
  @typing.final
128
191
  class Text(google.protobuf.message.Message):
192
+ """Text represents a textual content part of a message."""
193
+
129
194
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
130
195
 
131
196
  CONTENT_FIELD_NUMBER: builtins.int
132
197
  content: builtins.str
198
+ """Text content of the message."""
133
199
  def __init__(
134
200
  self,
135
201
  *,
@@ -141,11 +207,15 @@ global___Text = Text
141
207
 
142
208
  @typing.final
143
209
  class ContentPart(google.protobuf.message.Message):
210
+ """ContentPart represents an individual part of the message content, which can be of various types."""
211
+
144
212
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
145
213
 
146
214
  TEXT_FIELD_NUMBER: builtins.int
147
215
  @property
148
- def text(self) -> global___Text: ...
216
+ def text(self) -> global___Text:
217
+ """Text content of the message part."""
218
+
149
219
  def __init__(
150
220
  self,
151
221
  *,
@@ -159,12 +229,16 @@ global___ContentPart = ContentPart
159
229
 
160
230
  @typing.final
161
231
  class Author(google.protobuf.message.Message):
232
+ """Author of the message, containing details about the message's creator."""
233
+
162
234
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
163
235
 
164
236
  ID_FIELD_NUMBER: builtins.int
165
237
  ROLE_FIELD_NUMBER: builtins.int
166
238
  id: builtins.str
239
+ """Unique identifier of the author. This could be either the user's ID or the assistant's ID, depending on the role."""
167
240
  role: builtins.str
241
+ """Role of the author, indicating whether the message was created by a "user" or an "assistant"."""
168
242
  def __init__(
169
243
  self,
170
244
  *,
@@ -15,6 +15,8 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
15
15
 
16
16
  @typing.final
17
17
  class CreateMessageRequest(google.protobuf.message.Message):
18
+ """Request to create a new message in a specific thread."""
19
+
18
20
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
19
21
 
20
22
  @typing.final
@@ -38,12 +40,21 @@ class CreateMessageRequest(google.protobuf.message.Message):
38
40
  LABELS_FIELD_NUMBER: builtins.int
39
41
  CONTENT_FIELD_NUMBER: builtins.int
40
42
  thread_id: builtins.str
43
+ """ID of the thread to which the message will be added."""
41
44
  @property
42
- def author(self) -> yandex.cloud.ai.assistants.v1.threads.message_pb2.Author: ...
45
+ def author(self) -> yandex.cloud.ai.assistants.v1.threads.message_pb2.Author:
46
+ """Author of the message, containing details about the message's creator.
47
+ If not provided, the default author ID specified in the corresponding thread will be used.
48
+ """
49
+
43
50
  @property
44
- def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]: ...
51
+ def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
52
+ """Set of key-value pairs to label the message."""
53
+
45
54
  @property
46
- def content(self) -> yandex.cloud.ai.assistants.v1.threads.message_pb2.MessageContent: ...
55
+ def content(self) -> yandex.cloud.ai.assistants.v1.threads.message_pb2.MessageContent:
56
+ """Content of the message."""
57
+
47
58
  def __init__(
48
59
  self,
49
60
  *,
@@ -59,12 +70,16 @@ global___CreateMessageRequest = CreateMessageRequest
59
70
 
60
71
  @typing.final
61
72
  class GetMessageRequest(google.protobuf.message.Message):
73
+ """Request message for retrieving a message from a thread."""
74
+
62
75
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
63
76
 
64
77
  THREAD_ID_FIELD_NUMBER: builtins.int
65
78
  MESSAGE_ID_FIELD_NUMBER: builtins.int
66
79
  thread_id: builtins.str
80
+ """ID of the thread that contains the message."""
67
81
  message_id: builtins.str
82
+ """ID of the message to retrieve."""
68
83
  def __init__(
69
84
  self,
70
85
  *,
@@ -77,10 +92,13 @@ global___GetMessageRequest = GetMessageRequest
77
92
 
78
93
  @typing.final
79
94
  class ListMessagesRequest(google.protobuf.message.Message):
95
+ """Request message for listing messages in a specific thread."""
96
+
80
97
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
81
98
 
82
99
  THREAD_ID_FIELD_NUMBER: builtins.int
83
100
  thread_id: builtins.str
101
+ """ID of the thread whose messages will be listed."""
84
102
  def __init__(
85
103
  self,
86
104
  *,
@@ -7,7 +7,8 @@ from yandex.cloud.ai.assistants.v1.threads import message_service_pb2 as yandex_
7
7
 
8
8
 
9
9
  class MessageServiceStub(object):
10
- """Missing associated documentation comment in .proto file."""
10
+ """MessageService provides operations for managing messages.
11
+ """
11
12
 
12
13
  def __init__(self, channel):
13
14
  """Constructor.
@@ -33,22 +34,27 @@ class MessageServiceStub(object):
33
34
 
34
35
 
35
36
  class MessageServiceServicer(object):
36
- """Missing associated documentation comment in .proto file."""
37
+ """MessageService provides operations for managing messages.
38
+ """
37
39
 
38
40
  def Create(self, request, context):
39
- """Missing associated documentation comment in .proto file."""
41
+ """Create a new message.
42
+ """
40
43
  context.set_code(grpc.StatusCode.UNIMPLEMENTED)
41
44
  context.set_details('Method not implemented!')
42
45
  raise NotImplementedError('Method not implemented!')
43
46
 
44
47
  def Get(self, request, context):
45
- """Missing associated documentation comment in .proto file."""
48
+ """Retrieve details of a specific message by its ID.
49
+ """
46
50
  context.set_code(grpc.StatusCode.UNIMPLEMENTED)
47
51
  context.set_details('Method not implemented!')
48
52
  raise NotImplementedError('Method not implemented!')
49
53
 
50
54
  def List(self, request, context):
51
- """Missing associated documentation comment in .proto file."""
55
+ """List messages in a specific thread.
56
+ By default, messages are listed in reverse chronological order, i.e., from the newest to the oldest.
57
+ """
52
58
  context.set_code(grpc.StatusCode.UNIMPLEMENTED)
53
59
  context.set_details('Method not implemented!')
54
60
  raise NotImplementedError('Method not implemented!')
@@ -79,7 +85,8 @@ def add_MessageServiceServicer_to_server(servicer, server):
79
85
 
80
86
  # This class is part of an EXPERIMENTAL API.
81
87
  class MessageService(object):
82
- """Missing associated documentation comment in .proto file."""
88
+ """MessageService provides operations for managing messages.
89
+ """
83
90
 
84
91
  @staticmethod
85
92
  def Create(request,
@@ -19,58 +19,79 @@ class _ServicerContext(grpc.ServicerContext, grpc.aio.ServicerContext): # type:
19
19
  ...
20
20
 
21
21
  class MessageServiceStub:
22
+ """MessageService provides operations for managing messages."""
23
+
22
24
  def __init__(self, channel: typing.Union[grpc.Channel, grpc.aio.Channel]) -> None: ...
23
25
  Create: grpc.UnaryUnaryMultiCallable[
24
26
  yandex.cloud.ai.assistants.v1.threads.message_service_pb2.CreateMessageRequest,
25
27
  yandex.cloud.ai.assistants.v1.threads.message_pb2.Message,
26
28
  ]
29
+ """Create a new message."""
27
30
 
28
31
  Get: grpc.UnaryUnaryMultiCallable[
29
32
  yandex.cloud.ai.assistants.v1.threads.message_service_pb2.GetMessageRequest,
30
33
  yandex.cloud.ai.assistants.v1.threads.message_pb2.Message,
31
34
  ]
35
+ """Retrieve details of a specific message by its ID."""
32
36
 
33
37
  List: grpc.UnaryStreamMultiCallable[
34
38
  yandex.cloud.ai.assistants.v1.threads.message_service_pb2.ListMessagesRequest,
35
39
  yandex.cloud.ai.assistants.v1.threads.message_pb2.Message,
36
40
  ]
41
+ """List messages in a specific thread.
42
+ By default, messages are listed in reverse chronological order, i.e., from the newest to the oldest.
43
+ """
37
44
 
38
45
  class MessageServiceAsyncStub:
46
+ """MessageService provides operations for managing messages."""
47
+
39
48
  Create: grpc.aio.UnaryUnaryMultiCallable[
40
49
  yandex.cloud.ai.assistants.v1.threads.message_service_pb2.CreateMessageRequest,
41
50
  yandex.cloud.ai.assistants.v1.threads.message_pb2.Message,
42
51
  ]
52
+ """Create a new message."""
43
53
 
44
54
  Get: grpc.aio.UnaryUnaryMultiCallable[
45
55
  yandex.cloud.ai.assistants.v1.threads.message_service_pb2.GetMessageRequest,
46
56
  yandex.cloud.ai.assistants.v1.threads.message_pb2.Message,
47
57
  ]
58
+ """Retrieve details of a specific message by its ID."""
48
59
 
49
60
  List: grpc.aio.UnaryStreamMultiCallable[
50
61
  yandex.cloud.ai.assistants.v1.threads.message_service_pb2.ListMessagesRequest,
51
62
  yandex.cloud.ai.assistants.v1.threads.message_pb2.Message,
52
63
  ]
64
+ """List messages in a specific thread.
65
+ By default, messages are listed in reverse chronological order, i.e., from the newest to the oldest.
66
+ """
53
67
 
54
68
  class MessageServiceServicer(metaclass=abc.ABCMeta):
69
+ """MessageService provides operations for managing messages."""
70
+
55
71
  @abc.abstractmethod
56
72
  def Create(
57
73
  self,
58
74
  request: yandex.cloud.ai.assistants.v1.threads.message_service_pb2.CreateMessageRequest,
59
75
  context: _ServicerContext,
60
- ) -> typing.Union[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message]]: ...
76
+ ) -> typing.Union[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message]]:
77
+ """Create a new message."""
61
78
 
62
79
  @abc.abstractmethod
63
80
  def Get(
64
81
  self,
65
82
  request: yandex.cloud.ai.assistants.v1.threads.message_service_pb2.GetMessageRequest,
66
83
  context: _ServicerContext,
67
- ) -> typing.Union[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message]]: ...
84
+ ) -> typing.Union[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message]]:
85
+ """Retrieve details of a specific message by its ID."""
68
86
 
69
87
  @abc.abstractmethod
70
88
  def List(
71
89
  self,
72
90
  request: yandex.cloud.ai.assistants.v1.threads.message_service_pb2.ListMessagesRequest,
73
91
  context: _ServicerContext,
74
- ) -> typing.Union[collections.abc.Iterator[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message], collections.abc.AsyncIterator[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message]]: ...
92
+ ) -> typing.Union[collections.abc.Iterator[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message], collections.abc.AsyncIterator[yandex.cloud.ai.assistants.v1.threads.message_pb2.Message]]:
93
+ """List messages in a specific thread.
94
+ By default, messages are listed in reverse chronological order, i.e., from the newest to the oldest.
95
+ """
75
96
 
76
97
  def add_MessageServiceServicer_to_server(servicer: MessageServiceServicer, server: typing.Union[grpc.Server, grpc.aio.Server]) -> None: ...
@@ -47,22 +47,39 @@ class Thread(google.protobuf.message.Message):
47
47
  EXPIRES_AT_FIELD_NUMBER: builtins.int
48
48
  LABELS_FIELD_NUMBER: builtins.int
49
49
  id: builtins.str
50
+ """Unique identifier of the thread."""
50
51
  folder_id: builtins.str
52
+ """ID of the folder that the thread belongs to."""
51
53
  name: builtins.str
54
+ """Name of the thread."""
52
55
  description: builtins.str
56
+ """Description of the thread."""
53
57
  default_message_author_id: builtins.str
58
+ """Default user ID that will be used as the author for thread messages if no other author is specified."""
54
59
  created_by: builtins.str
60
+ """Identifier of the subject who created this thread."""
55
61
  updated_by: builtins.str
62
+ """Identifier of the subject who last updated this thread."""
56
63
  @property
57
- def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
64
+ def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
65
+ """Timestamp representing when the thread was created."""
66
+
58
67
  @property
59
- def updated_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
68
+ def updated_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
69
+ """Timestamp representing the last time this thread was updated."""
70
+
60
71
  @property
61
- def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig: ...
72
+ def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig:
73
+ """Configuration for the expiration of the thread, defining when and how the thread will expire."""
74
+
62
75
  @property
63
- def expires_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
76
+ def expires_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
77
+ """Timestamp representing when the thread will expire."""
78
+
64
79
  @property
65
- def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]: ...
80
+ def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
81
+ """Set of key-value pairs that can be used to organize and categorize the thread."""
82
+
66
83
  def __init__(
67
84
  self,
68
85
  *,
@@ -18,6 +18,8 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
18
18
 
19
19
  @typing.final
20
20
  class CreateThreadRequest(google.protobuf.message.Message):
21
+ """Request message for creating a new thread."""
22
+
21
23
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
22
24
 
23
25
  @typing.final
@@ -45,14 +47,23 @@ class CreateThreadRequest(google.protobuf.message.Message):
45
47
  LABELS_FIELD_NUMBER: builtins.int
46
48
  folder_id: builtins.str
47
49
  name: builtins.str
50
+ """Name of the thread."""
48
51
  description: builtins.str
52
+ """Description of the thread."""
49
53
  default_message_author_id: builtins.str
54
+ """Default user ID that will be used as the author for thread messages if no other author is specified."""
50
55
  @property
51
- def messages(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.threads.message_pb2.MessageData]: ...
56
+ def messages(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.threads.message_pb2.MessageData]:
57
+ """List of messages to initialize the thread."""
58
+
52
59
  @property
53
- def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig: ...
60
+ def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig:
61
+ """Expiration configuration for the thread."""
62
+
54
63
  @property
55
- def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]: ...
64
+ def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
65
+ """Set of key-value pairs to label the thread."""
66
+
56
67
  def __init__(
57
68
  self,
58
69
  *,
@@ -71,10 +82,13 @@ global___CreateThreadRequest = CreateThreadRequest
71
82
 
72
83
  @typing.final
73
84
  class GetThreadRequest(google.protobuf.message.Message):
85
+ """Request message for retrieving a thread by ID."""
86
+
74
87
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
75
88
 
76
89
  THREAD_ID_FIELD_NUMBER: builtins.int
77
90
  thread_id: builtins.str
91
+ """ID of the thread to retrieve."""
78
92
  def __init__(
79
93
  self,
80
94
  *,
@@ -86,6 +100,8 @@ global___GetThreadRequest = GetThreadRequest
86
100
 
87
101
  @typing.final
88
102
  class UpdateThreadRequest(google.protobuf.message.Message):
103
+ """Request message for updating an existing thread."""
104
+
89
105
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
90
106
 
91
107
  @typing.final
@@ -111,14 +127,23 @@ class UpdateThreadRequest(google.protobuf.message.Message):
111
127
  EXPIRATION_CONFIG_FIELD_NUMBER: builtins.int
112
128
  LABELS_FIELD_NUMBER: builtins.int
113
129
  thread_id: builtins.str
130
+ """ID of the thread to update."""
114
131
  name: builtins.str
132
+ """New name for the thread."""
115
133
  description: builtins.str
134
+ """New description for the thread."""
116
135
  @property
117
- def update_mask(self) -> google.protobuf.field_mask_pb2.FieldMask: ...
136
+ def update_mask(self) -> google.protobuf.field_mask_pb2.FieldMask:
137
+ """Field mask specifying which fields to update."""
138
+
118
139
  @property
119
- def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig: ...
140
+ def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig:
141
+ """New expiration configuration for the thread."""
142
+
120
143
  @property
121
- def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]: ...
144
+ def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
145
+ """New set of labels for the thread."""
146
+
122
147
  def __init__(
123
148
  self,
124
149
  *,
@@ -136,10 +161,13 @@ global___UpdateThreadRequest = UpdateThreadRequest
136
161
 
137
162
  @typing.final
138
163
  class DeleteThreadRequest(google.protobuf.message.Message):
164
+ """Request message for deleting a thread by ID."""
165
+
139
166
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
140
167
 
141
168
  THREAD_ID_FIELD_NUMBER: builtins.int
142
169
  thread_id: builtins.str
170
+ """ID of the thread to delete."""
143
171
  def __init__(
144
172
  self,
145
173
  *,
@@ -151,6 +179,8 @@ global___DeleteThreadRequest = DeleteThreadRequest
151
179
 
152
180
  @typing.final
153
181
  class DeleteThreadResponse(google.protobuf.message.Message):
182
+ """Response message for the delete operation."""
183
+
154
184
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
155
185
 
156
186
  def __init__(
@@ -161,14 +191,19 @@ global___DeleteThreadResponse = DeleteThreadResponse
161
191
 
162
192
  @typing.final
163
193
  class ListThreadsRequest(google.protobuf.message.Message):
194
+ """Request message for listing threads in a specific folder."""
195
+
164
196
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
165
197
 
166
198
  FOLDER_ID_FIELD_NUMBER: builtins.int
167
199
  PAGE_SIZE_FIELD_NUMBER: builtins.int
168
200
  PAGE_TOKEN_FIELD_NUMBER: builtins.int
169
201
  folder_id: builtins.str
202
+ """Folder ID from which to list threads."""
170
203
  page_size: builtins.int
204
+ """Maximum number of threads to return per page."""
171
205
  page_token: builtins.str
206
+ """Token to retrieve the next page of results."""
172
207
  def __init__(
173
208
  self,
174
209
  *,
@@ -182,13 +217,18 @@ global___ListThreadsRequest = ListThreadsRequest
182
217
 
183
218
  @typing.final
184
219
  class ListThreadsResponse(google.protobuf.message.Message):
220
+ """Response message for the list operation."""
221
+
185
222
  DESCRIPTOR: google.protobuf.descriptor.Descriptor
186
223
 
187
224
  THREADS_FIELD_NUMBER: builtins.int
188
225
  NEXT_PAGE_TOKEN_FIELD_NUMBER: builtins.int
189
226
  next_page_token: builtins.str
227
+ """Token to retrieve the next page of results."""
190
228
  @property
191
- def threads(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.threads.thread_pb2.Thread]: ...
229
+ def threads(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.threads.thread_pb2.Thread]:
230
+ """List of threads in the specified folder."""
231
+
192
232
  def __init__(
193
233
  self,
194
234
  *,
@@ -7,7 +7,8 @@ from yandex.cloud.ai.assistants.v1.threads import thread_service_pb2 as yandex_d
7
7
 
8
8
 
9
9
  class ThreadServiceStub(object):
10
- """Missing associated documentation comment in .proto file."""
10
+ """ThreadService provides operations for managing threads.
11
+ """
11
12
 
12
13
  def __init__(self, channel):
13
14
  """Constructor.
@@ -43,34 +44,40 @@ class ThreadServiceStub(object):
43
44
 
44
45
 
45
46
  class ThreadServiceServicer(object):
46
- """Missing associated documentation comment in .proto file."""
47
+ """ThreadService provides operations for managing threads.
48
+ """
47
49
 
48
50
  def Create(self, request, context):
49
- """Missing associated documentation comment in .proto file."""
51
+ """Create a new thread.
52
+ """
50
53
  context.set_code(grpc.StatusCode.UNIMPLEMENTED)
51
54
  context.set_details('Method not implemented!')
52
55
  raise NotImplementedError('Method not implemented!')
53
56
 
54
57
  def Get(self, request, context):
55
- """Missing associated documentation comment in .proto file."""
58
+ """Retrieve details of a specific thread by its ID.
59
+ """
56
60
  context.set_code(grpc.StatusCode.UNIMPLEMENTED)
57
61
  context.set_details('Method not implemented!')
58
62
  raise NotImplementedError('Method not implemented!')
59
63
 
60
64
  def Update(self, request, context):
61
- """Missing associated documentation comment in .proto file."""
65
+ """Update an existing thread.
66
+ """
62
67
  context.set_code(grpc.StatusCode.UNIMPLEMENTED)
63
68
  context.set_details('Method not implemented!')
64
69
  raise NotImplementedError('Method not implemented!')
65
70
 
66
71
  def Delete(self, request, context):
67
- """Missing associated documentation comment in .proto file."""
72
+ """Delete a thread by its ID.
73
+ """
68
74
  context.set_code(grpc.StatusCode.UNIMPLEMENTED)
69
75
  context.set_details('Method not implemented!')
70
76
  raise NotImplementedError('Method not implemented!')
71
77
 
72
78
  def List(self, request, context):
73
- """Missing associated documentation comment in .proto file."""
79
+ """List threads in a specific folder.
80
+ """
74
81
  context.set_code(grpc.StatusCode.UNIMPLEMENTED)
75
82
  context.set_details('Method not implemented!')
76
83
  raise NotImplementedError('Method not implemented!')
@@ -111,7 +118,8 @@ def add_ThreadServiceServicer_to_server(servicer, server):
111
118
 
112
119
  # This class is part of an EXPERIMENTAL API.
113
120
  class ThreadService(object):
114
- """Missing associated documentation comment in .proto file."""
121
+ """ThreadService provides operations for managing threads.
122
+ """
115
123
 
116
124
  @staticmethod
117
125
  def Create(request,