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

yandex/cloud/ai/assistants/v1/runs/run_pb2.pyi

@@ -25,6 +25,8 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class Run(google.protobuf.message.Message):
+    """Represents a run of an assistant over a specific thread of messages."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     @typing.final
@@ -54,21 +56,41 @@ class Run(google.protobuf.message.Message):
     CUSTOM_PROMPT_TRUNCATION_OPTIONS_FIELD_NUMBER: builtins.int
     CUSTOM_COMPLETION_OPTIONS_FIELD_NUMBER: builtins.int
     id: builtins.str
+    """Unique identifier of the run."""
     assistant_id: builtins.str
+    """Identifier for the assistant that is being run."""
     thread_id: builtins.str
+    """Identifier for the thread of messages that this run is associated with."""
     created_by: builtins.str
+    """Identifier of the subject who created this run."""
     @property
-    def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
+    def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
+        """Timestamp representing when the run was created."""
+
     @property
-    def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]: ...
+    def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
+        """Set of key-value pairs that can be used to organize and categorize the run."""
+
     @property
-    def state(self) -> global___RunState: ...
+    def state(self) -> global___RunState:
+        """Current state of the run, including its status and any associated data."""
+
     @property
-    def usage(self) -> global___ContentUsage: ...
+    def usage(self) -> global___ContentUsage:
+        """Information about the content usage during the run, such as the number of [tokens](/docs/foundation-models/concepts/yandexgpt/tokens) used by the completion model."""
+
     @property
-    def custom_prompt_truncation_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.PromptTruncationOptions: ...
+    def custom_prompt_truncation_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.PromptTruncationOptions:
+        """Configuration options for truncating the prompt when the token count exceeds a specified limit.
+        If specified, these options will override the assistant's prompt truncation settings for this run.
+        """
+
     @property
-    def custom_completion_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions: ...
+    def custom_completion_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions:
+        """Configuration options for completion generation.
+        If specified, these options will override the assistant's completion settings for this run.
+        """
+
     def __init__(
         self,
         *,
@@ -90,6 +112,8 @@ global___Run = Run
 
 @typing.final
 class RunState(google.protobuf.message.Message):
+    """Represents the current state of a run."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     class _RunStatus:
@@ -99,26 +123,43 @@ class RunState(google.protobuf.message.Message):
     class _RunStatusEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[RunState._RunStatus.ValueType], builtins.type):
         DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
         RUN_STATUS_UNSPECIFIED: RunState._RunStatus.ValueType  # 0
+        """Default unspecified status."""
         PENDING: RunState._RunStatus.ValueType  # 1
+        """Run has been created but has not started yet."""
         IN_PROGRESS: RunState._RunStatus.ValueType  # 2
+        """Run is currently in progress."""
         FAILED: RunState._RunStatus.ValueType  # 3
+        """Run has failed due to an error."""
         COMPLETED: RunState._RunStatus.ValueType  # 4
+        """Run has completed successfully."""
+
+    class RunStatus(_RunStatus, metaclass=_RunStatusEnumTypeWrapper):
+        """Enum representing the status of a run."""
 
-    class RunStatus(_RunStatus, metaclass=_RunStatusEnumTypeWrapper): ...
     RUN_STATUS_UNSPECIFIED: RunState.RunStatus.ValueType  # 0
+    """Default unspecified status."""
     PENDING: RunState.RunStatus.ValueType  # 1
+    """Run has been created but has not started yet."""
     IN_PROGRESS: RunState.RunStatus.ValueType  # 2
+    """Run is currently in progress."""
     FAILED: RunState.RunStatus.ValueType  # 3
+    """Run has failed due to an error."""
     COMPLETED: RunState.RunStatus.ValueType  # 4
+    """Run has completed successfully."""
 
     STATUS_FIELD_NUMBER: builtins.int
     ERROR_FIELD_NUMBER: builtins.int
     COMPLETED_MESSAGE_FIELD_NUMBER: builtins.int
     status: global___RunState.RunStatus.ValueType
+    """Current status of a run."""
     @property
-    def error(self) -> yandex.cloud.ai.common.common_pb2.Error: ...
+    def error(self) -> yandex.cloud.ai.common.common_pb2.Error:
+        """Error information if a run has failed."""
+
     @property
-    def completed_message(self) -> yandex.cloud.ai.assistants.v1.threads.message_pb2.Message: ...
+    def completed_message(self) -> yandex.cloud.ai.assistants.v1.threads.message_pb2.Message:
+        """Final message generated by an assistant if a run has completed successfully."""
+
     def __init__(
         self,
         *,
@@ -134,14 +175,19 @@ global___RunState = RunState
 
 @typing.final
 class ContentUsage(google.protobuf.message.Message):
+    """Represents the content usage during a run, such as the number of [tokens](/docs/foundation-models/concepts/yandexgpt/tokens) used by the completion model."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     PROMPT_TOKENS_FIELD_NUMBER: builtins.int
     COMPLETION_TOKENS_FIELD_NUMBER: builtins.int
     TOTAL_TOKENS_FIELD_NUMBER: builtins.int
     prompt_tokens: builtins.int
+    """The number of tokens used in the prompt."""
     completion_tokens: builtins.int
+    """The number of tokens used in the completion response."""
     total_tokens: builtins.int
+    """The total number of tokens used (prompt + completion)."""
     def __init__(
         self,
         *,

yandex/cloud/ai/assistants/v1/runs/run_service_pb2.pyi

@@ -26,6 +26,8 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class CreateRunRequest(google.protobuf.message.Message):
+    """Request message for creating a new run."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     @typing.final
@@ -52,16 +54,31 @@ class CreateRunRequest(google.protobuf.message.Message):
     CUSTOM_COMPLETION_OPTIONS_FIELD_NUMBER: builtins.int
     STREAM_FIELD_NUMBER: builtins.int
     assistant_id: builtins.str
+    """ID of the assistant for which the run is being created"""
     thread_id: builtins.str
+    """ID of the thread associated with the run."""
     stream: builtins.bool
+    """Enables streaming of intermediate events, such as partial messages."""
     @property
-    def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]: ...
+    def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
+        """Set of key-value pairs to label the run."""
+
     @property
-    def additional_messages(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.threads.message_pb2.MessageData]: ...
+    def additional_messages(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.threads.message_pb2.MessageData]:
+        """Additional messages that will be written to the thread before the run starts."""
+
     @property
-    def custom_prompt_truncation_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.PromptTruncationOptions: ...
+    def custom_prompt_truncation_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.PromptTruncationOptions:
+        """Configuration options for truncating the prompt when the token count exceeds a specified limit.
+        If specified, these options will override the assistant's prompt truncation settings for this run.
+        """
+
     @property
-    def custom_completion_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions: ...
+    def custom_completion_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions:
+        """Configuration options for completion generation.
+        If specified, these options will override the assistant's completion settings for this run.
+        """
+
     def __init__(
         self,
         *,
@@ -80,13 +97,18 @@ global___CreateRunRequest = CreateRunRequest
 
 @typing.final
 class ListenRunRequest(google.protobuf.message.Message):
+    """Request message for listing to a run events."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     RUN_ID_FIELD_NUMBER: builtins.int
     EVENTS_START_IDX_FIELD_NUMBER: builtins.int
     run_id: builtins.str
+    """ID of the run to listen to."""
     @property
-    def events_start_idx(self) -> google.protobuf.wrappers_pb2.Int64Value: ...
+    def events_start_idx(self) -> google.protobuf.wrappers_pb2.Int64Value:
+        """Starting index for events. If provided, listening will start from this event."""
+
     def __init__(
         self,
         *,
@@ -100,10 +122,13 @@ global___ListenRunRequest = ListenRunRequest
 
 @typing.final
 class GetRunRequest(google.protobuf.message.Message):
+    """Request message for retrieving a specific run by its ID."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     RUN_ID_FIELD_NUMBER: builtins.int
     run_id: builtins.str
+    """ID of the run to retrieve."""
     def __init__(
         self,
         *,
@@ -115,10 +140,13 @@ global___GetRunRequest = GetRunRequest
 
 @typing.final
 class GetLastRunByThreadRequest(google.protobuf.message.Message):
+    """Request message for retrieving the last run associated with a specific thread."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     THREAD_ID_FIELD_NUMBER: builtins.int
     thread_id: builtins.str
+    """ID of the thread for which the last run is being fetched."""
     def __init__(
         self,
         *,
@@ -130,14 +158,19 @@ global___GetLastRunByThreadRequest = GetLastRunByThreadRequest
 
 @typing.final
 class ListRunsRequest(google.protobuf.message.Message):
+    """Request message for listing runs."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     FOLDER_ID_FIELD_NUMBER: builtins.int
     PAGE_SIZE_FIELD_NUMBER: builtins.int
     PAGE_TOKEN_FIELD_NUMBER: builtins.int
     folder_id: builtins.str
+    """Folder ID from which to list runs."""
     page_size: builtins.int
+    """Maximum number of threads to return per page."""
     page_token: builtins.str
+    """Token to retrieve the next page of results."""
     def __init__(
         self,
         *,
@@ -151,13 +184,18 @@ global___ListRunsRequest = ListRunsRequest
 
 @typing.final
 class ListRunsResponse(google.protobuf.message.Message):
+    """Response message for the list operation."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     RUNS_FIELD_NUMBER: builtins.int
     NEXT_PAGE_TOKEN_FIELD_NUMBER: builtins.int
     next_page_token: builtins.str
+    """Token to retrieve the next page of results."""
     @property
-    def runs(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run]: ...
+    def runs(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run]:
+        """List of runs in the specified folder."""
+
     def __init__(
         self,
         *,
@@ -170,12 +208,16 @@ global___ListRunsResponse = ListRunsResponse
 
 @typing.final
 class StreamCursor(google.protobuf.message.Message):
+    """Represents the cursor position in a stream of events."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     CURRENT_EVENT_IDX_FIELD_NUMBER: builtins.int
     NUM_USER_EVENTS_RECEIVED_FIELD_NUMBER: builtins.int
     current_event_idx: builtins.int
+    """Index of the current event in the stream."""
     num_user_events_received: builtins.int
+    """The number of user events received so far."""
     def __init__(
         self,
         *,
@@ -188,6 +230,8 @@ global___StreamCursor = StreamCursor
 
 @typing.final
 class StreamEvent(google.protobuf.message.Message):
+    """Represents an event in the stream of a run."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     class _EventType:
@@ -197,15 +241,25 @@ class StreamEvent(google.protobuf.message.Message):
     class _EventTypeEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[StreamEvent._EventType.ValueType], builtins.type):
         DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
         EVENT_TYPE_UNSPECIFIED: StreamEvent._EventType.ValueType  # 0
+        """Unspecified event type."""
         PARTIAL_MESSAGE: StreamEvent._EventType.ValueType  # 1
+        """Partial message is available."""
         ERROR: StreamEvent._EventType.ValueType  # 2
+        """Run has failed due to an error."""
         DONE: StreamEvent._EventType.ValueType  # 3
+        """The run has completed."""
+
+    class EventType(_EventType, metaclass=_EventTypeEnumTypeWrapper):
+        """Enum representing events that can occur in the stream."""
 
-    class EventType(_EventType, metaclass=_EventTypeEnumTypeWrapper): ...
     EVENT_TYPE_UNSPECIFIED: StreamEvent.EventType.ValueType  # 0
+    """Unspecified event type."""
     PARTIAL_MESSAGE: StreamEvent.EventType.ValueType  # 1
+    """Partial message is available."""
     ERROR: StreamEvent.EventType.ValueType  # 2
+    """Run has failed due to an error."""
     DONE: StreamEvent.EventType.ValueType  # 3
+    """The run has completed."""
 
     EVENT_TYPE_FIELD_NUMBER: builtins.int
     STREAM_CURSOR_FIELD_NUMBER: builtins.int
@@ -213,14 +267,23 @@ class StreamEvent(google.protobuf.message.Message):
     PARTIAL_MESSAGE_FIELD_NUMBER: builtins.int
     COMPLETED_MESSAGE_FIELD_NUMBER: builtins.int
     event_type: global___StreamEvent.EventType.ValueType
+    """The type of event."""
     @property
-    def stream_cursor(self) -> global___StreamCursor: ...
+    def stream_cursor(self) -> global___StreamCursor:
+        """The current position in the stream."""
+
     @property
-    def error(self) -> yandex.cloud.ai.common.common_pb2.Error: ...
+    def error(self) -> yandex.cloud.ai.common.common_pb2.Error:
+        """Error information if the run has failed."""
+
     @property
-    def partial_message(self) -> yandex.cloud.ai.assistants.v1.threads.message_pb2.MessageContent: ...
+    def partial_message(self) -> yandex.cloud.ai.assistants.v1.threads.message_pb2.MessageContent:
+        """Partially generated message."""
+
     @property
-    def completed_message(self) -> yandex.cloud.ai.assistants.v1.threads.message_pb2.Message: ...
+    def completed_message(self) -> yandex.cloud.ai.assistants.v1.threads.message_pb2.Message:
+        """Final message generated by an assistant if a run has completed successfully."""
+
     def __init__(
         self,
         *,

yandex/cloud/ai/assistants/v1/runs/run_service_pb2_grpc.py

@@ -7,7 +7,8 @@ from yandex.cloud.ai.assistants.v1.runs import run_service_pb2 as yandex_dot_clo
 
 
 class RunServiceStub(object):
-    """Missing associated documentation comment in .proto file."""
+    """RunService provides operations for managing runs.
+    """
 
     def __init__(self, channel):
         """Constructor.
@@ -43,34 +44,42 @@ class RunServiceStub(object):
 
 
 class RunServiceServicer(object):
-    """Missing associated documentation comment in .proto file."""
+    """RunService provides operations for managing runs.
+    """
 
     def Create(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """Create a new run for a given assistant and thread.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def Listen(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """Listen to events from a specific run.
+        If the run was created with `stream = false`, Listen will only respond with the final status of the run
+        and will not stream partial messages or intermediate events.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def Get(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """Retrieve details of a specific run by its ID.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def GetLastByThread(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """Retrieves the most recent run for a specific thread.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def List(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """List runs in a specific folder.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
@@ -111,7 +120,8 @@ def add_RunServiceServicer_to_server(servicer, server):
 
  # This class is part of an EXPERIMENTAL API.
 class RunService(object):
-    """Missing associated documentation comment in .proto file."""
+    """RunService provides operations for managing runs.
+    """
 
     @staticmethod
     def Create(request,

yandex/cloud/ai/assistants/v1/runs/run_service_pb2_grpc.pyi

@@ -19,92 +19,122 @@ class _ServicerContext(grpc.ServicerContext, grpc.aio.ServicerContext):  # type:
     ...
 
 class RunServiceStub:
+    """RunService provides operations for managing runs."""
+
     def __init__(self, channel: typing.Union[grpc.Channel, grpc.aio.Channel]) -> None: ...
     Create: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.CreateRunRequest,
         yandex.cloud.ai.assistants.v1.runs.run_pb2.Run,
     ]
+    """Create a new run for a given assistant and thread."""
 
     Listen: grpc.UnaryStreamMultiCallable[
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListenRunRequest,
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.StreamEvent,
     ]
+    """Listen to events from a specific run.
+    If the run was created with `stream = false`, Listen will only respond with the final status of the run
+    and will not stream partial messages or intermediate events.
+    """
 
     Get: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.GetRunRequest,
         yandex.cloud.ai.assistants.v1.runs.run_pb2.Run,
     ]
+    """Retrieve details of a specific run by its ID."""
 
     GetLastByThread: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.GetLastRunByThreadRequest,
         yandex.cloud.ai.assistants.v1.runs.run_pb2.Run,
     ]
+    """Retrieves the most recent run for a specific thread."""
 
     List: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListRunsRequest,
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListRunsResponse,
     ]
+    """List runs in a specific folder."""
 
 class RunServiceAsyncStub:
+    """RunService provides operations for managing runs."""
+
     Create: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.CreateRunRequest,
         yandex.cloud.ai.assistants.v1.runs.run_pb2.Run,
     ]
+    """Create a new run for a given assistant and thread."""
 
     Listen: grpc.aio.UnaryStreamMultiCallable[
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListenRunRequest,
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.StreamEvent,
     ]
+    """Listen to events from a specific run.
+    If the run was created with `stream = false`, Listen will only respond with the final status of the run
+    and will not stream partial messages or intermediate events.
+    """
 
     Get: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.GetRunRequest,
         yandex.cloud.ai.assistants.v1.runs.run_pb2.Run,
     ]
+    """Retrieve details of a specific run by its ID."""
 
     GetLastByThread: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.GetLastRunByThreadRequest,
         yandex.cloud.ai.assistants.v1.runs.run_pb2.Run,
     ]
+    """Retrieves the most recent run for a specific thread."""
 
     List: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListRunsRequest,
         yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListRunsResponse,
     ]
+    """List runs in a specific folder."""
 
 class RunServiceServicer(metaclass=abc.ABCMeta):
+    """RunService provides operations for managing runs."""
+
     @abc.abstractmethod
     def Create(
         self,
         request: yandex.cloud.ai.assistants.v1.runs.run_service_pb2.CreateRunRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run]]: ...
+    ) -> typing.Union[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run]]:
+        """Create a new run for a given assistant and thread."""
 
     @abc.abstractmethod
     def Listen(
         self,
         request: yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListenRunRequest,
         context: _ServicerContext,
-    ) -> typing.Union[collections.abc.Iterator[yandex.cloud.ai.assistants.v1.runs.run_service_pb2.StreamEvent], collections.abc.AsyncIterator[yandex.cloud.ai.assistants.v1.runs.run_service_pb2.StreamEvent]]: ...
+    ) -> typing.Union[collections.abc.Iterator[yandex.cloud.ai.assistants.v1.runs.run_service_pb2.StreamEvent], collections.abc.AsyncIterator[yandex.cloud.ai.assistants.v1.runs.run_service_pb2.StreamEvent]]:
+        """Listen to events from a specific run.
+        If the run was created with `stream = false`, Listen will only respond with the final status of the run
+        and will not stream partial messages or intermediate events.
+        """
 
     @abc.abstractmethod
     def Get(
         self,
         request: yandex.cloud.ai.assistants.v1.runs.run_service_pb2.GetRunRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run]]: ...
+    ) -> typing.Union[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run]]:
+        """Retrieve details of a specific run by its ID."""
 
     @abc.abstractmethod
     def GetLastByThread(
         self,
         request: yandex.cloud.ai.assistants.v1.runs.run_service_pb2.GetLastRunByThreadRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run]]: ...
+    ) -> typing.Union[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.runs.run_pb2.Run]]:
+        """Retrieves the most recent run for a specific thread."""
 
     @abc.abstractmethod
     def List(
         self,
         request: yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListRunsRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListRunsResponse, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListRunsResponse]]: ...
+    ) -> typing.Union[yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListRunsResponse, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.runs.run_service_pb2.ListRunsResponse]]:
+        """List runs in a specific folder."""
 
 def add_RunServiceServicer_to_server(servicer: RunServiceServicer, server: typing.Union[grpc.Server, grpc.aio.Server]) -> None: ...

yandex/cloud/ai/assistants/v1/searchindex/common_pb2.pyi

@@ -12,12 +12,23 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class StaticChunkingStrategy(google.protobuf.message.Message):
+    """Defines a chunking strategy where chunks are created with a fixed maximum chunk size and an overlap between consecutive chunks."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     MAX_CHUNK_SIZE_TOKENS_FIELD_NUMBER: builtins.int
     CHUNK_OVERLAP_TOKENS_FIELD_NUMBER: builtins.int
     max_chunk_size_tokens: builtins.int
+    """The maximum number of tokens allowed in a single chunk.
+    Constraints: must be within the range [100, 2048].
+    Default value: 800
+    """
     chunk_overlap_tokens: builtins.int
+    """The number of tokens that should overlap between consecutive chunks.
+    This allows for some context from the previous chunk to be included in the next chunk.
+    Constraints: must be less than or equal to half of `max_chunk_size_tokens`.
+    Default value: 400
+    """
     def __init__(
         self,
         *,
@@ -30,6 +41,10 @@ global___StaticChunkingStrategy = StaticChunkingStrategy
 
 @typing.final
 class ChunkingStrategy(google.protobuf.message.Message):
+    """Defines a general strategy for chunking text into smaller segments.
+    Currently, only StaticChunkingStrategy is supported.
+    """
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     STATIC_STRATEGY_FIELD_NUMBER: builtins.int

yandex/cloud/ai/assistants/v1/searchindex/search_index_file_pb2.pyi

@@ -14,6 +14,8 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class SearchIndexFile(google.protobuf.message.Message):
+    """Represents a file that has been indexed within a search index."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     ID_FIELD_NUMBER: builtins.int
@@ -22,10 +24,15 @@ class SearchIndexFile(google.protobuf.message.Message):
     CREATED_AT_FIELD_NUMBER: builtins.int
     CHUNKING_STRATEGY_FIELD_NUMBER: builtins.int
     id: builtins.str
+    """Unique identifier of the file that was used for indexing."""
     search_index_id: builtins.str
+    """ID of the search index that contains this file."""
     created_by: builtins.str
+    """Identifier of the subject who created the file in the search index."""
     @property
-    def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
+    def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
+        """Timestamp representing when the file was created."""
+
     @property
     def chunking_strategy(self) -> yandex.cloud.ai.assistants.v1.searchindex.common_pb2.ChunkingStrategy: ...
     def __init__(

yandex/cloud/ai/assistants/v1/searchindex/search_index_file_service_pb2.pyi

@@ -15,12 +15,16 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class GetSearchIndexFileRequest(google.protobuf.message.Message):
+    """Request message for retrieving a file from a search index."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     FILE_ID_FIELD_NUMBER: builtins.int
     SEARCH_INDEX_ID_FIELD_NUMBER: builtins.int
     file_id: builtins.str
+    """ID of the file to retrieve."""
     search_index_id: builtins.str
+    """ID of the search index that contains the file."""
     def __init__(
         self,
         *,
@@ -33,14 +37,19 @@ global___GetSearchIndexFileRequest = GetSearchIndexFileRequest
 
 @typing.final
 class ListSearchIndexFilesRequest(google.protobuf.message.Message):
+    """Request message for listing files in a specific search index."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     SEARCH_INDEX_ID_FIELD_NUMBER: builtins.int
     PAGE_SIZE_FIELD_NUMBER: builtins.int
     PAGE_TOKEN_FIELD_NUMBER: builtins.int
     search_index_id: builtins.str
+    """ID of the search index whose files will be listed."""
     page_size: builtins.int
+    """Maximum number of files to return per page."""
     page_token: builtins.str
+    """Token to retrieve the next page of results."""
     def __init__(
         self,
         *,
@@ -54,13 +63,18 @@ global___ListSearchIndexFilesRequest = ListSearchIndexFilesRequest
 
 @typing.final
 class ListSearchIndexFilesResponse(google.protobuf.message.Message):
+    """Response message for the list operation."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     FILES_FIELD_NUMBER: builtins.int
     NEXT_PAGE_TOKEN_FIELD_NUMBER: builtins.int
     next_page_token: builtins.str
+    """Token to retrieve the next page of results."""
     @property
-    def files(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.searchindex.search_index_file_pb2.SearchIndexFile]: ...
+    def files(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.searchindex.search_index_file_pb2.SearchIndexFile]:
+        """List of files in the specified search index."""
+
     def __init__(
         self,
         *,