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

yandex/cloud/ai/assistants/v1/assistant_pb2.pyi

@@ -17,6 +17,8 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class Assistant(google.protobuf.message.Message):
+    """Assistant represents an AI assistant configuration with various settings and metadata."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     @typing.final
@@ -52,29 +54,57 @@ class Assistant(google.protobuf.message.Message):
     COMPLETION_OPTIONS_FIELD_NUMBER: builtins.int
     TOOLS_FIELD_NUMBER: builtins.int
     id: builtins.str
+    """Unique identifier of the assistant."""
     folder_id: builtins.str
+    """ID of the folder that the assistant belongs to."""
     name: builtins.str
+    """Name of the assistant."""
     description: builtins.str
+    """Description of the assistant."""
     created_by: builtins.str
+    """Identifier of the subject who created this assistant."""
     updated_by: builtins.str
+    """Identifier of the subject who last updated this assistant."""
     model_uri: builtins.str
+    """The [ID of the model](/docs/foundation-models/concepts/yandexgpt/models) to be used for completion generation."""
     instruction: builtins.str
+    """Instructions or guidelines that the assistant should follow when generating responses or performing tasks.
+    These instructions can help guide the assistant's behavior and responses.
+    """
     @property
-    def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
+    def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
+        """Timestamp representing when the assistant was created."""
+
     @property
-    def updated_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
+    def updated_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
+        """Timestamp representing the last time this assistant was updated."""
+
     @property
-    def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig: ...
+    def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig:
+        """Configuration for the expiration of the assistant, defining when and how the assistant will expire."""
+
     @property
-    def expires_at(self) -> google.protobuf.timestamp_pb2.Timestamp: ...
+    def expires_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
+        """Timestamp representing when the assistant will expire."""
+
     @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 assistant."""
+
     @property
-    def prompt_truncation_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.PromptTruncationOptions: ...
+    def 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."""
+
     @property
-    def completion_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions: ...
+    def completion_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions:
+        """Configuration options for completion generation."""
+
     @property
-    def tools(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.common_pb2.Tool]: ...
+    def tools(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.common_pb2.Tool]:
+        """List of tools that the assistant can use to perform additional tasks.
+        One example is the SearchIndexTool, which is used for Retrieval-Augmented Generation (RAG).
+        """
+
     def __init__(
         self,
         *,

yandex/cloud/ai/assistants/v1/assistant_service_pb2.pyi

@@ -18,6 +18,8 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class CreateAssistantRequest(google.protobuf.message.Message):
+    """Request to create a new assistant."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     @typing.final
@@ -48,19 +50,37 @@ class CreateAssistantRequest(google.protobuf.message.Message):
     TOOLS_FIELD_NUMBER: builtins.int
     folder_id: builtins.str
     name: builtins.str
+    """Name of the assistant."""
     description: builtins.str
+    """Description of the assistant."""
     model_uri: builtins.str
+    """The [ID of the model](/docs/foundation-models/concepts/yandexgpt/models) to be used for completion generation."""
     instruction: builtins.str
+    """Instructions or guidelines that the assistant should follow when generating responses or performing tasks.
+    These instructions can help guide the assistant's behavior and responses.
+    """
     @property
-    def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig: ...
+    def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig:
+        """Expiration configuration for the assistant."""
+
     @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 user."""
+
     @property
-    def prompt_truncation_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.PromptTruncationOptions: ...
+    def 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."""
+
     @property
-    def completion_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions: ...
+    def completion_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions:
+        """Configuration options for completion generation."""
+
     @property
-    def tools(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.common_pb2.Tool]: ...
+    def tools(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.common_pb2.Tool]:
+        """List of tools that the assistant can use to perform additional tasks.
+        One example is the SearchIndexTool, which is used for Retrieval-Augmented Generation (RAG).
+        """
+
     def __init__(
         self,
         *,
@@ -82,10 +102,13 @@ global___CreateAssistantRequest = CreateAssistantRequest
 
 @typing.final
 class GetAssistantRequest(google.protobuf.message.Message):
+    """Request message for retrieving an assistant by ID."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     ASSISTANT_ID_FIELD_NUMBER: builtins.int
     assistant_id: builtins.str
+    """ID of the assistant to retrieve."""
     def __init__(
         self,
         *,
@@ -97,6 +120,8 @@ global___GetAssistantRequest = GetAssistantRequest
 
 @typing.final
 class UpdateAssistantRequest(google.protobuf.message.Message):
+    """Request message for updating an existing assistant."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     @typing.final
@@ -127,22 +152,39 @@ class UpdateAssistantRequest(google.protobuf.message.Message):
     COMPLETION_OPTIONS_FIELD_NUMBER: builtins.int
     TOOLS_FIELD_NUMBER: builtins.int
     assistant_id: builtins.str
+    """ID of the assistant to update."""
     name: builtins.str
+    """New name for the assistant."""
     description: builtins.str
+    """New description for the assistant."""
     model_uri: builtins.str
+    """The new [ID of the model](/docs/foundation-models/concepts/yandexgpt/models) to be used for completion generation."""
     instruction: builtins.str
+    """New instructions or guidelines for the assistant to follow."""
     @property
-    def update_mask(self) -> google.protobuf.field_mask_pb2.FieldMask: ...
+    def update_mask(self) -> google.protobuf.field_mask_pb2.FieldMask:
+        """Field mask specifying which fields to update."""
+
     @property
-    def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig: ...
+    def expiration_config(self) -> yandex.cloud.ai.common.common_pb2.ExpirationConfig:
+        """New expiration configuration for the assistant."""
+
     @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]:
+        """New set of labels for the assistant."""
+
     @property
-    def prompt_truncation_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.PromptTruncationOptions: ...
+    def prompt_truncation_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.PromptTruncationOptions:
+        """New configuration for truncating the prompt."""
+
     @property
-    def completion_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions: ...
+    def completion_options(self) -> yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions:
+        """New configuration for completion generation."""
+
     @property
-    def tools(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.common_pb2.Tool]: ...
+    def tools(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.common_pb2.Tool]:
+        """New list of tools the assistant can use."""
+
     def __init__(
         self,
         *,
@@ -165,10 +207,13 @@ global___UpdateAssistantRequest = UpdateAssistantRequest
 
 @typing.final
 class DeleteAssistantRequest(google.protobuf.message.Message):
+    """Request message for deleting an assistant by ID."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     ASSISTANT_ID_FIELD_NUMBER: builtins.int
     assistant_id: builtins.str
+    """ID of the assistant to delete."""
     def __init__(
         self,
         *,
@@ -180,6 +225,8 @@ global___DeleteAssistantRequest = DeleteAssistantRequest
 
 @typing.final
 class DeleteAssistantResponse(google.protobuf.message.Message):
+    """Response message for the delete operation."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     def __init__(
@@ -190,14 +237,19 @@ global___DeleteAssistantResponse = DeleteAssistantResponse
 
 @typing.final
 class ListAssistantsRequest(google.protobuf.message.Message):
+    """Request message for listing assistants in a specific folder."""
+
     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 assistants."""
     page_size: builtins.int
+    """Maximum number of assistants to return per page."""
     page_token: builtins.str
+    """Token to retrieve the next page of results."""
     def __init__(
         self,
         *,
@@ -211,13 +263,18 @@ global___ListAssistantsRequest = ListAssistantsRequest
 
 @typing.final
 class ListAssistantsResponse(google.protobuf.message.Message):
+    """Response message for the list operation."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     ASSISTANTS_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 assistants(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant]: ...
+    def assistants(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant]:
+        """List of assistants in the specified folder."""
+
     def __init__(
         self,
         *,
@@ -230,14 +287,19 @@ global___ListAssistantsResponse = ListAssistantsResponse
 
 @typing.final
 class ListAssistantVersionsRequest(google.protobuf.message.Message):
+    """Request to list all versions of a specific assistant."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     ASSISTANT_ID_FIELD_NUMBER: builtins.int
     PAGE_SIZE_FIELD_NUMBER: builtins.int
     PAGE_TOKEN_FIELD_NUMBER: builtins.int
     assistant_id: builtins.str
+    """ID of the assistant whose versions are to be listed."""
     page_size: builtins.int
+    """Maximum number of versions to return per page."""
     page_token: builtins.str
+    """Token to retrieve the next page of results."""
     def __init__(
         self,
         *,
@@ -251,16 +313,23 @@ global___ListAssistantVersionsRequest = ListAssistantVersionsRequest
 
 @typing.final
 class AssistantVersion(google.protobuf.message.Message):
+    """Represents a specific version of an assistant."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     ID_FIELD_NUMBER: builtins.int
     UPDATE_MASK_FIELD_NUMBER: builtins.int
     ASSISTANT_FIELD_NUMBER: builtins.int
     id: builtins.str
+    """ID of the assistant version."""
     @property
-    def update_mask(self) -> google.protobuf.field_mask_pb2.FieldMask: ...
+    def update_mask(self) -> google.protobuf.field_mask_pb2.FieldMask:
+        """Mask specifying which fields were updated in this version."""
+
     @property
-    def assistant(self) -> yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant: ...
+    def assistant(self) -> yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant:
+        """Assistant configuration for this version."""
+
     def __init__(
         self,
         *,
@@ -275,13 +344,18 @@ global___AssistantVersion = AssistantVersion
 
 @typing.final
 class ListAssistantVersionsResponse(google.protobuf.message.Message):
+    """Response message containing the list versions operation."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     VERSIONS_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 versions(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___AssistantVersion]: ...
+    def versions(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___AssistantVersion]:
+        """List of assistant versions."""
+
     def __init__(
         self,
         *,

yandex/cloud/ai/assistants/v1/assistant_service_pb2_grpc.py

@@ -7,7 +7,8 @@ from yandex.cloud.ai.assistants.v1 import assistant_service_pb2 as yandex_dot_cl
 
 
 class AssistantServiceStub(object):
-    """Missing associated documentation comment in .proto file."""
+    """AssistantService provides operations for managing assistants.
+    """
 
     def __init__(self, channel):
         """Constructor.
@@ -48,40 +49,47 @@ class AssistantServiceStub(object):
 
 
 class AssistantServiceServicer(object):
-    """Missing associated documentation comment in .proto file."""
+    """AssistantService provides operations for managing assistants.
+    """
 
     def Create(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """Create a new assistant.
+        """
         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 assistant by its ID.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def Update(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """Update an existing assistant.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def Delete(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """Delete an assistant by its ID.
+        """
         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 assistants in a specific folder.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def ListVersions(self, request, context):
-        """Missing associated documentation comment in .proto file."""
+        """Lists all versions of a specific assistant.
+        """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
@@ -127,7 +135,8 @@ def add_AssistantServiceServicer_to_server(servicer, server):
 
  # This class is part of an EXPERIMENTAL API.
 class AssistantService(object):
-    """Missing associated documentation comment in .proto file."""
+    """AssistantService provides operations for managing assistants.
+    """
 
     @staticmethod
     def Create(request,

yandex/cloud/ai/assistants/v1/assistant_service_pb2_grpc.pyi

@@ -19,109 +19,133 @@ class _ServicerContext(grpc.ServicerContext, grpc.aio.ServicerContext):  # type:
     ...
 
 class AssistantServiceStub:
+    """AssistantService provides operations for managing assistants."""
+
     def __init__(self, channel: typing.Union[grpc.Channel, grpc.aio.Channel]) -> None: ...
     Create: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.CreateAssistantRequest,
         yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant,
     ]
+    """Create a new assistant."""
 
     Get: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.GetAssistantRequest,
         yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant,
     ]
+    """Retrieve details of a specific assistant by its ID."""
 
     Update: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.UpdateAssistantRequest,
         yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant,
     ]
+    """Update an existing assistant."""
 
     Delete: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.DeleteAssistantRequest,
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.DeleteAssistantResponse,
     ]
+    """Delete an assistant by its ID."""
 
     List: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantsRequest,
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantsResponse,
     ]
+    """List assistants in a specific folder."""
 
     ListVersions: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantVersionsRequest,
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantVersionsResponse,
     ]
+    """Lists all versions of a specific assistant."""
 
 class AssistantServiceAsyncStub:
+    """AssistantService provides operations for managing assistants."""
+
     Create: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.CreateAssistantRequest,
         yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant,
     ]
+    """Create a new assistant."""
 
     Get: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.GetAssistantRequest,
         yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant,
     ]
+    """Retrieve details of a specific assistant by its ID."""
 
     Update: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.UpdateAssistantRequest,
         yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant,
     ]
+    """Update an existing assistant."""
 
     Delete: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.DeleteAssistantRequest,
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.DeleteAssistantResponse,
     ]
+    """Delete an assistant by its ID."""
 
     List: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantsRequest,
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantsResponse,
     ]
+    """List assistants in a specific folder."""
 
     ListVersions: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantVersionsRequest,
         yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantVersionsResponse,
     ]
+    """Lists all versions of a specific assistant."""
 
 class AssistantServiceServicer(metaclass=abc.ABCMeta):
+    """AssistantService provides operations for managing assistants."""
+
     @abc.abstractmethod
     def Create(
         self,
         request: yandex.cloud.ai.assistants.v1.assistant_service_pb2.CreateAssistantRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant]]: ...
+    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant]]:
+        """Create a new assistant."""
 
     @abc.abstractmethod
     def Get(
         self,
         request: yandex.cloud.ai.assistants.v1.assistant_service_pb2.GetAssistantRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant]]: ...
+    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant]]:
+        """Retrieve details of a specific assistant by its ID."""
 
     @abc.abstractmethod
     def Update(
         self,
         request: yandex.cloud.ai.assistants.v1.assistant_service_pb2.UpdateAssistantRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant]]: ...
+    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_pb2.Assistant]]:
+        """Update an existing assistant."""
 
     @abc.abstractmethod
     def Delete(
         self,
         request: yandex.cloud.ai.assistants.v1.assistant_service_pb2.DeleteAssistantRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_service_pb2.DeleteAssistantResponse, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_service_pb2.DeleteAssistantResponse]]: ...
+    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_service_pb2.DeleteAssistantResponse, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_service_pb2.DeleteAssistantResponse]]:
+        """Delete an assistant by its ID."""
 
     @abc.abstractmethod
     def List(
         self,
         request: yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantsRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantsResponse, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantsResponse]]: ...
+    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantsResponse, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantsResponse]]:
+        """List assistants in a specific folder."""
 
     @abc.abstractmethod
     def ListVersions(
         self,
         request: yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantVersionsRequest,
         context: _ServicerContext,
-    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantVersionsResponse, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantVersionsResponse]]: ...
+    ) -> typing.Union[yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantVersionsResponse, collections.abc.Awaitable[yandex.cloud.ai.assistants.v1.assistant_service_pb2.ListAssistantVersionsResponse]]:
+        """Lists all versions of a specific assistant."""
 
 def add_AssistantServiceServicer_to_server(servicer: AssistantServiceServicer, server: typing.Union[grpc.Server, grpc.aio.Server]) -> None: ...

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

@@ -15,11 +15,18 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class PromptTruncationOptions(google.protobuf.message.Message):
+    """Defines the options for truncating thread messages within a prompt."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     MAX_PROMPT_TOKENS_FIELD_NUMBER: builtins.int
     @property
-    def max_prompt_tokens(self) -> google.protobuf.wrappers_pb2.Int64Value: ...
+    def max_prompt_tokens(self) -> google.protobuf.wrappers_pb2.Int64Value:
+        """The maximum number of tokens allowed in the prompt.
+        If the prompt exceeds this limit, the thread messages will be truncated.
+        Default max_prompt_tokens: 7000
+        """
+
     def __init__(
         self,
         *,
@@ -32,14 +39,25 @@ global___PromptTruncationOptions = PromptTruncationOptions
 
 @typing.final
 class CompletionOptions(google.protobuf.message.Message):
+    """Defines the options for completion generation."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     MAX_TOKENS_FIELD_NUMBER: builtins.int
     TEMPERATURE_FIELD_NUMBER: builtins.int
     @property
-    def max_tokens(self) -> google.protobuf.wrappers_pb2.Int64Value: ...
+    def max_tokens(self) -> google.protobuf.wrappers_pb2.Int64Value:
+        """The limit on the number of tokens used for single completion generation.
+        Must be greater than zero. This maximum allowed parameter value may depend on the model being used.
+        """
+
     @property
-    def temperature(self) -> google.protobuf.wrappers_pb2.DoubleValue: ...
+    def temperature(self) -> google.protobuf.wrappers_pb2.DoubleValue:
+        """Affects creativity and randomness of responses. Should be a double number between 0 (inclusive) and 1 (inclusive).
+        Lower values produce more straightforward responses while higher values lead to increased creativity and randomness.
+        Default temperature: 0.3
+        """
+
     def __init__(
         self,
         *,
@@ -53,14 +71,23 @@ global___CompletionOptions = CompletionOptions
 
 @typing.final
 class SearchIndexTool(google.protobuf.message.Message):
+    """Configures a tool that enables Retrieval-Augmented Generation (RAG) by allowing the assistant to search across a specified search index."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     SEARCH_INDEX_IDS_FIELD_NUMBER: builtins.int
     MAX_NUM_RESULTS_FIELD_NUMBER: builtins.int
     @property
-    def search_index_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]: ...
+    def search_index_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """A list of search index IDs that this tool will query. Currently, only a single index ID is supported."""
+
     @property
-    def max_num_results(self) -> google.protobuf.wrappers_pb2.Int64Value: ...
+    def max_num_results(self) -> google.protobuf.wrappers_pb2.Int64Value:
+        """The maximum number of results to return from the search.
+        Fewer results may be returned if necessary to fit within the prompt's token limit.
+        This ensures that the combined prompt and search results do not exceed the token constraints.
+        """
+
     def __init__(
         self,
         *,
@@ -74,11 +101,15 @@ global___SearchIndexTool = SearchIndexTool
 
 @typing.final
 class Tool(google.protobuf.message.Message):
+    """Represents a general tool that can be one of several types."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     SEARCH_INDEX_FIELD_NUMBER: builtins.int
     @property
-    def search_index(self) -> global___SearchIndexTool: ...
+    def search_index(self) -> global___SearchIndexTool:
+        """SearchIndexTool tool that performs search across specified indexes."""
+
     def __init__(
         self,
         *,