yandexcloud 0.349.0__tar.gz → 0.351.0__tar.gz

yandexcloud-0.351.0/PKG-INFO

@@ -0,0 +1,247 @@
+Metadata-Version: 2.2
+Name: yandexcloud
+Version: 0.351.0
+Summary: The Yandex Cloud official SDK
+Author-email: Yandex LLC <cloud@support.yandex.ru>
+License: MIT
+Project-URL: Homepage, https://github.com/yandex-cloud/python-sdk
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS
+Requires-Dist: cryptography>=44.0.0
+Requires-Dist: grpcio<2,>=1.68.1
+Requires-Dist: protobuf<6,>=5.29.1
+Requires-Dist: googleapis-common-protos<2,>=1.66.0
+Requires-Dist: pyjwt<3,>=2.10.1
+Requires-Dist: requests<3,>=2.32.3
+Requires-Dist: six<2,>=1.17.0
+Requires-Dist: grpcio-tools>=1.68.1
+Requires-Dist: deprecated>=1.2.18
+
+[![PyPI Version][pypi-image]][pypi-url]
+[![Build Status][build-image]][build-url]
+[![License][license-image]][license-url]
+
+<!-- Badges -->
+
+[pypi-image]: https://img.shields.io/pypi/v/yandexcloud
+[pypi-url]: https://pypi.org/project/yandexcloud/
+[build-image]: https://github.com/yandex-cloud/python-sdk/actions/workflows/run-tests.yml/badge.svg
+[build-url]: https://github.com/yandex-cloud/python-sdk/actions/workflows/run-tests.yml
+[license-image]: https://img.shields.io/github/license/yandex-cloud/python-sdk.svg
+[license-url]: https://github.com/yandex-cloud/python-sdk/blob/master/LICENSE
+
+# Yandex.Cloud SDK (Python)
+
+Need to automate your infrastructure or use services provided by Yandex.Cloud? We've got you covered.
+
+Installation:
+
+    pip install yandexcloud
+
+## Getting started
+
+There are several options for authorization your requests - OAuth Token,
+Metadata Service (if you're executing your code inside VMs or Cloud Functions
+running in Yandex.Cloud), Service Account Keys, and externally created IAM tokens.
+
+### OAuth Token
+
+```python
+sdk = yandexcloud.SDK(token='AQAD-.....')
+```
+
+### Metadata Service
+
+Don't forget to assign Service Account for your Instance or Function and grant required roles.
+
+```python
+sdk = yandexcloud.SDK()
+```
+
+### Service Account Keys
+
+```python
+# you can store and read it from JSON file
+sa_key = {
+    "id": "...",
+    "service_account_id": "...",
+    "private_key": "..."
+}
+
+sdk = yandexcloud.SDK(service_account_key=sa_key)
+```
+
+### IAM tokens
+
+```python
+sdk = yandexcloud.SDK(iam_token="t1.9eu...")
+```
+
+Check `examples` directory for more examples.
+
+### Override service endpoint
+
+#### Supported services
+
+| Service Name                                                           | Alias                    |
+|------------------------------------------------------------------------|--------------------------|
+| yandex.cloud.ai.foundation_models                                      | ai-foundation-models     |
+| yandex.cloud.ai.llm                                                    | ai-llm                   |
+| yandex.cloud.ai.ocr                                                    | ai-vision-ocr            |
+| yandex.cloud.ai.stt                                                    | ai-stt                   |
+| yandex.cloud.ai.translate                                              | ai-translate             |
+| yandex.cloud.ai.tts                                                    | ai-speechkit             |
+| yandex.cloud.ai.vision                                                 | ai-vision                |
+| yandex.cloud.apploadbalancer                                           | alb                      |
+| yandex.cloud.billing                                                   | billing                  |
+| yandex.cloud.cdn                                                       | cdn                      |
+| yandex.cloud.certificatemanager.v1.certificate_content_service         | certificate-manager-data |
+| yandex.cloud.certificatemanager                                        | certificate-manager      |
+| yandex.cloud.compute                                                   | compute                  |
+| yandex.cloud.containerregistry                                         | container-registry       |
+| yandex.cloud.dataproc.manager                                          | dataproc-manager         |
+| yandex.cloud.dataproc                                                  | dataproc                 |
+| yandex.cloud.datasphere                                                | datasphere               |
+| yandex.cloud.datatransfer                                              | datatransfer             |
+| yandex.cloud.dns                                                       | dns                      |
+| yandex.cloud.endpoint                                                  | endpoint                 |
+| yandex.cloud.iam                                                       | iam                      |
+| yandex.cloud.iot.devices                                               | iot-devices              |
+| yandex.cloud.k8s                                                       | managed-kubernetes       |
+| yandex.cloud.kms.v1.symmetric_crypto_service                           | kms-crypto               |
+| yandex.cloud.kms                                                       | kms                      |
+| yandex.cloud.loadbalancer                                              | load-balancer            |
+| yandex.cloud.loadtesting                                               | loadtesting              |
+| yandex.cloud.lockbox.v1.payload_service                                | lockbox-payload          |
+| yandex.cloud.lockbox                                                   | lockbox                  |
+| yandex.cloud.logging.v1.log_ingestion_service                          | log-ingestion            |
+| yandex.cloud.logging.v1.log_reading_service                            | log-reading              |
+| yandex.cloud.logging                                                   | logging                  |
+| yandex.cloud.marketplace                                               | marketplace              |
+| yandex.cloud.mdb.clickhouse                                            | managed-clickhouse       |
+| yandex.cloud.mdb.elasticsearch                                         | managed-elasticsearch    |
+| yandex.cloud.mdb.greenplum                                             | managed-greenplum        |
+| yandex.cloud.mdb.kafka                                                 | managed-kafka            |
+| yandex.cloud.mdb.mongodb                                               | managed-mongodb          |
+| yandex.cloud.mdb.mysql                                                 | managed-mysql            |
+| yandex.cloud.mdb.opensearch                                            | managed-opensearch       |
+| yandex.cloud.mdb.postgresql                                            | managed-postgresql       |
+| yandex.cloud.mdb.redis                                                 | managed-redis            |
+| yandex.cloud.mdb.sqlserver                                             | managed-sqlserver        |
+| yandex.cloud.operation                                                 | operation                |
+| yandex.cloud.organizationmanager                                       | organization-manager     |
+| yandex.cloud.resourcemanager                                           | resource-manager         |
+| yandex.cloud.serverless.apigateway.websocket                           | apigateway-connections   |
+| yandex.cloud.serverless.apigateway                                     | serverless-apigateway    |
+| yandex.cloud.serverless.containers                                     | serverless-containers    |
+| yandex.cloud.serverless.functions                                      | serverless-functions     |
+| yandex.cloud.serverless.triggers                                       | serverless-triggers      |
+| yandex.cloud.spark                                                     | managed-spark            |
+| yandex.cloud.storage                                                   | storage-api              |
+| yandex.cloud.trino                                                     | trino                    |
+| yandex.cloud.vpc                                                       | vpc                      |
+| yandex.cloud.ydb                                                       | ydb                      |
+
+
+#### Override in client
+```python
+from yandex.cloud.vpc.v1.network_service_pb2_grpc import NetworkServiceStub
+from yandexcloud import SDK
+
+sdk = SDK(iam_token="t1.9eu...")
+new_network_client_endpoint = "example.new.vpc.very.new.yandex:50051"
+insecure = False # by default is False, but if server does not support verification can be set to True
+network_client = sdk.client(NetworkServiceStub, endpoint=new_network_client_endpoint, insecure=False)
+```
+
+#### Override in sdk config
+To override endpoints provide dict in format {alias : new-endpoint}
+```python
+from yandex.cloud.vpc.v1.network_service_pb2_grpc import NetworkServiceStub
+from yandexcloud import SDK
+new_network_client_endpoint = "example.new.vpc.very.new.yandex:50051"
+sdk = SDK(iam_token="t1.9eu...", endpoints={"vpc": new_network_client_endpoint})
+insecure = False # by default is False, but if server does not support verification can be set to True
+network_client = sdk.client(NetworkServiceStub, insecure=False)
+```
+
+Notice: if both overrides are used for same endpoint, override by client has priority
+
+#### Switch SDK region
+```python
+from yandexcloud import SDK, set_up_yc_api_endpoint
+kz_region_endpoint = "api.yandexcloud.kz"
+# this will make SDK list endpoints from KZ yc installation
+sdk = SDK(iam_token="t1.9eu...", endpoint="api.yandexcloud.kz")
+# or you can use global function
+set_up_yc_api_endpoint(kz_region_endpoint)
+```
+
+### Retries
+SDK provide built-in retry policy, that supports [exponential backoff and jitter](https://aws.amazon.com/ru/blogs/architecture/exponential-backoff-and-jitter/), and also [retry budget](https://github.com/grpc/proposal/blob/master/A6-client-retries.md#throttling-retry-attempts-and-hedged-rpcs). It's necessary to avoid retry amplification.
+
+```python
+import grpc
+from yandexcloud import SDK, RetryPolicy
+
+sdk = SDK(retry_policy=RetryPolicy())
+```
+
+SDK provide different modes for retry throttling policy:
+
+* `persistent` is suitable when you use SDK in any long-lived application, when SDK instance will live long enough for manage budget;
+* `temporary` is suitable when you use SDK in any short-lived application, e.g. scripts or CI/CD.
+
+By default, SDK will use temporary mode, but you can change it through `throttling_mode` argument.
+
+
+## Contributing
+### Dependencies
+We use [uv](https://docs.astral.sh/uv) to manage dependencies and run commands in Makefile.
+Install it with official standalone installer:
+`curl -LsSf https://astral.sh/uv/install.sh | sh`
+
+#### Installing dependencies
+Use `make deps` command to install library, its production and development dependencies.
+
+#### Adding new project dependency with uv
+`uv add cryptography`
+
+#### Adding new optional dependency with uv
+add to `dev` extras section
+`uv add pre-commit --group dev`
+
+add to `genproto` extras section
+`uv add grpcio-tools --group genproto`
+
+### Git hooks
+Setup pre-commit and commit-msg hooks with `make git-hooks` command.
+
+### Formatting
+Use `make format` to autoformat code with black tool.
+
+### Tests
+- `make test` to run tests for current python version
+- `make lint` to run only linters for current python version
+- `make tox-current` to run all checks (tests + code style checks + linters + format check) for current python version
+- `make tox` to run all checks for all supported (installed in your system) python versions
+- `make test-all-versions` to run all checks for all supported python versions in docker container
+
+### Run Github Actions locally
+Use https://github.com/nektos/act
+
+### Maintaining
+If pull request consists of several meaningful commits, that should be preserved,
+then use "Rebase and merge" option. Otherwise use "Squash and merge".
+
+New release (changelog, tag and pypi upload) will be automatically created
+on each push to master via Github Actions workflow.

yandexcloud-0.351.0/pyproject.toml

@@ -0,0 +1,202 @@
+[build-system]
+requires = ["setuptools>=61.2,<76.1.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "yandexcloud"
+version = "0.351.0"
+authors = [{name = "Yandex LLC", email = "cloud@support.yandex.ru"}]
+license = {text = "MIT"}
+description = "The Yandex Cloud official SDK"
+requires-python = ">=3.9"
+classifiers = [
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "cryptography>=44.0.0",
+    "grpcio>=1.68.1,<2",
+    "protobuf>=5.29.1,<6",
+    "googleapis-common-protos>=1.66.0,<2",
+    "pyjwt>=2.10.1,<3",
+    "requests>=2.32.3,<3",
+    "six>=1.17.0,<2",
+    "grpcio-tools>=1.68.1",
+    "deprecated>=1.2.18",
+]
+
+[project.readme]
+file = "README.md"
+content-type = "text/markdown"
+
+[project.urls]
+Homepage = "https://github.com/yandex-cloud/python-sdk"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.0.1",
+    "python-semantic-release>=9.15.2",
+    "tox-gh>=1.4.4",
+    "tox>=4.23.2",
+    "yandexcloud",
+]
+format = [
+    "black>=24.10.0",
+    "isort>=5.13.2",
+]
+genproto = [
+    "grpcio-tools>=1.68.1",
+    "mypy-protobuf>=3.6.0",
+]
+type = [
+    "mypy>=1.13.0",
+    "grpc-stubs>=1.53.0.5",
+    "types-requests>=2.32.0.20241016",
+    "types-six>=1.17.0.20241205",
+    "types-deprecated>=1.2.15.20241117",
+]
+style = [
+    "flake8>=7.1.1",
+    "flake8-pyproject>=1.2.3",
+    "pylint>=3.3.2",
+]
+test = [
+    "pytest>=8.3.4",
+]
+
+[tool.setuptools]
+zip-safe = false
+include-package-data = true
+
+[tool.setuptools.packages.find]
+# include = ["yandexcloud*"] # yandex*
+include = ["yandexcloud*", "yandex*"]
+namespaces = false
+
+[tool.semantic_release]
+version_variables = ["yandexcloud/__init__.py:__version__"]
+version_toml = ["pyproject.toml:project.version"]
+# https://python-semantic-release.readthedocs.io/en/latest/configuration.html#major-on-zero
+major_on_zero = false
+commit_parser = "angular"
+
+[tool.black]
+line-length = 120
+
+[tool.isort]
+profile = "black"
+
+[tool.pylint.FORMAT]
+max-line-length=120
+
+[tool.pylint.MASTER]
+disable= [
+    "C0114", # Missing module docstring (missing-module-docstring)
+    "C0115", # Missing class docstring (missing-class-docstring)
+    "C0116", # Missing function or method docstring (missing-function-docstring)
+    "E0611", # No name 'Empty' in module 'google.protobuf.empty_pb2' (no-name-in-module) — proto code creates attributes in runtime and linter goes crazy
+    "R0903", # Too few public methods (1/2) (too-few-public-methods)
+    "R0913", # Too many arguments (6/5) (too-many-arguments)
+    "R0917", # Too many positional arguments (6/5) (too-many-positional-arguments)
+]
+
+[tool.flake8]
+max-line-length = 120
+max-complexity = 15
+# https://black.readthedocs.io/en/stable/the_black_code_style/current_style.html#slices
+ignore = ['E203',]
+
+[tool.mypy]
+disallow_untyped_defs = true
+disallow_any_unimported = true
+check_untyped_defs = true
+no_implicit_reexport = true
+warn_unreachable = true
+warn_unused_configs = true
+warn_redundant_casts = true
+
+# mypy per-module options:
+[[tool.mypy.overrides]]
+module = [
+    "yandex.cloud.*",
+]
+disallow_untyped_defs = false
+check_untyped_defs = false
+disallow_any_unimported = false
+
+
+[[tool.mypy.overrides]]
+module = [
+    "google.rpc.status_pb2.*",
+    "google.rpc.*",
+]
+ignore_missing_imports = true
+
+[tool.tox]
+env_list = [
+    "3.9",
+    "3.10",
+    "3.11",
+    "3.12",
+    "3.13",
+    "type",
+    "format",
+    "style",
+]
+skip_missing_interpreters = true
+
+[tool.tox.env_run_base]
+description = "Run tests under {base_python}"
+dependency_groups = [
+    "test",
+]
+commands = [["pytest"]]
+
+[tool.tox.env.type]
+description = "Check types with mypy"
+skip_install = true
+dependency_groups = [
+    "type",
+    "genproto",
+    "dev"  # without it cannot import jwt and cryptography dependencies and E0401 is raised
+]
+commands = [["mypy", "yandexcloud"]]  # TODO: add `tests` directory
+
+[tool.tox.env.format]
+description = "Format code with black and isort"
+skip_install = true
+dependency_groups = [
+  "format",
+]
+commands = [
+    ["black", "--check", "--diff", "yandexcloud"],
+    ["isort", "--check", "--diff", "yandexcloud"],
+]
+
+[tool.tox.env.style]
+description = "Check style with flake8 and pylint"
+skip_install = true
+dependency_groups = [
+    "style",
+    "dev"  # without it cannot import yandexcloud dependencies and E0401 is raised
+]
+commands = [
+    ["flake8", "yandexcloud"],
+    ["pylint", "yandexcloud"],
+]
+
+[tool.tox.gh.python]
+# uncomment when upgrade grpcio-tools, current version does not work with 3.13
+"3.13" = ["3.13"]
+"3.12" = ["3.12"]
+"3.11" = ["3.11"]
+"3.10" = ["3.10"]
+"3.9" = ["3.9"]
+"type" = ["type"]
+"format" = ["format"]
+"style" = ["style"]

yandexcloud-0.351.0/yandex/cloud/ai/assistants/v1/assistant_pb2.py

@@ -0,0 +1,44 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# NO CHECKED-IN PROTOBUF GENCODE
+# source: yandex/cloud/ai/assistants/v1/assistant.proto
+# Protobuf Python Version: 5.29.0
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import runtime_version as _runtime_version
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+_runtime_version.ValidateProtobufRuntimeVersion(
+    _runtime_version.Domain.PUBLIC,
+    5,
+    29,
+    0,
+    '',
+    'yandex/cloud/ai/assistants/v1/assistant.proto'
+)
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+from yandex.cloud.ai.common import common_pb2 as yandex_dot_cloud_dot_ai_dot_common_dot_common__pb2
+from yandex.cloud.ai.assistants.v1 import common_pb2 as yandex_dot_cloud_dot_ai_dot_assistants_dot_v1_dot_common__pb2
+from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__pb2
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n-yandex/cloud/ai/assistants/v1/assistant.proto\x12\x1dyandex.cloud.ai.assistants.v1\x1a#yandex/cloud/ai/common/common.proto\x1a*yandex/cloud/ai/assistants/v1/common.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x8c\x06\n\tAssistant\x12\n\n\x02id\x18\x01 \x01(\t\x12\x11\n\tfolder_id\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x12\n\ncreated_by\x18\x05 \x01(\t\x12.\n\ncreated_at\x18\x06 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x12\n\nupdated_by\x18\x07 \x01(\t\x12.\n\nupdated_at\x18\x08 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x43\n\x11\x65xpiration_config\x18\t \x01(\x0b\x32(.yandex.cloud.ai.common.ExpirationConfig\x12.\n\nexpires_at\x18\n \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x44\n\x06labels\x18\x0b \x03(\x0b\x32\x34.yandex.cloud.ai.assistants.v1.Assistant.LabelsEntry\x12\x11\n\tmodel_uri\x18\x0c \x01(\t\x12\x13\n\x0binstruction\x18\r \x01(\t\x12Y\n\x19prompt_truncation_options\x18\x0e \x01(\x0b\x32\x36.yandex.cloud.ai.assistants.v1.PromptTruncationOptions\x12L\n\x12\x63ompletion_options\x18\x0f \x01(\x0b\x32\x30.yandex.cloud.ai.assistants.v1.CompletionOptions\x12\x32\n\x05tools\x18\x10 \x03(\x0b\x32#.yandex.cloud.ai.assistants.v1.Tool\x12\x46\n\x0fresponse_format\x18\x11 \x01(\x0b\x32-.yandex.cloud.ai.assistants.v1.ResponseFormat\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\x42q\n!yandex.cloud.api.ai.assistants.v1ZLgithub.com/yandex-cloud/go-genproto/yandex/cloud/ai/assistants/v1;assistantsb\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'yandex.cloud.ai.assistants.v1.assistant_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n!yandex.cloud.api.ai.assistants.v1ZLgithub.com/yandex-cloud/go-genproto/yandex/cloud/ai/assistants/v1;assistants'
+  _globals['_ASSISTANT_LABELSENTRY']._loaded_options = None
+  _globals['_ASSISTANT_LABELSENTRY']._serialized_options = b'8\001'
+  _globals['_ASSISTANT']._serialized_start=195
+  _globals['_ASSISTANT']._serialized_end=975
+  _globals['_ASSISTANT_LABELSENTRY']._serialized_start=930
+  _globals['_ASSISTANT_LABELSENTRY']._serialized_end=975
+# @@protoc_insertion_point(module_scope)

yandexcloud-0.351.0/yandex/cloud/ai/assistants/v1/assistant_pb2.pyi

@@ -0,0 +1,137 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+
+import builtins
+import collections.abc
+import google.protobuf.descriptor
+import google.protobuf.internal.containers
+import google.protobuf.message
+import google.protobuf.timestamp_pb2
+import typing
+import yandex.cloud.ai.assistants.v1.common_pb2
+import yandex.cloud.ai.common.common_pb2
+
+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
+    class LabelsEntry(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+        KEY_FIELD_NUMBER: builtins.int
+        VALUE_FIELD_NUMBER: builtins.int
+        key: builtins.str
+        value: builtins.str
+        def __init__(
+            self,
+            *,
+            key: builtins.str = ...,
+            value: builtins.str = ...,
+        ) -> None: ...
+        def ClearField(self, field_name: typing.Literal["key", b"key", "value", b"value"]) -> None: ...
+
+    ID_FIELD_NUMBER: builtins.int
+    FOLDER_ID_FIELD_NUMBER: builtins.int
+    NAME_FIELD_NUMBER: builtins.int
+    DESCRIPTION_FIELD_NUMBER: builtins.int
+    CREATED_BY_FIELD_NUMBER: builtins.int
+    CREATED_AT_FIELD_NUMBER: builtins.int
+    UPDATED_BY_FIELD_NUMBER: builtins.int
+    UPDATED_AT_FIELD_NUMBER: builtins.int
+    EXPIRATION_CONFIG_FIELD_NUMBER: builtins.int
+    EXPIRES_AT_FIELD_NUMBER: builtins.int
+    LABELS_FIELD_NUMBER: builtins.int
+    MODEL_URI_FIELD_NUMBER: builtins.int
+    INSTRUCTION_FIELD_NUMBER: builtins.int
+    PROMPT_TRUNCATION_OPTIONS_FIELD_NUMBER: builtins.int
+    COMPLETION_OPTIONS_FIELD_NUMBER: builtins.int
+    TOOLS_FIELD_NUMBER: builtins.int
+    RESPONSE_FORMAT_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:
+        """Timestamp representing when the assistant was created."""
+
+    @property
+    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:
+        """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:
+        """Timestamp representing when the assistant will expire."""
+
+    @property
+    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:
+        """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:
+        """Configuration options for completion generation."""
+
+    @property
+    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).
+        """
+
+    @property
+    def response_format(self) -> yandex.cloud.ai.assistants.v1.common_pb2.ResponseFormat:
+        """Specifies the format of the model's response."""
+
+    def __init__(
+        self,
+        *,
+        id: builtins.str = ...,
+        folder_id: builtins.str = ...,
+        name: builtins.str = ...,
+        description: builtins.str = ...,
+        created_by: builtins.str = ...,
+        created_at: google.protobuf.timestamp_pb2.Timestamp | None = ...,
+        updated_by: builtins.str = ...,
+        updated_at: google.protobuf.timestamp_pb2.Timestamp | None = ...,
+        expiration_config: yandex.cloud.ai.common.common_pb2.ExpirationConfig | None = ...,
+        expires_at: google.protobuf.timestamp_pb2.Timestamp | None = ...,
+        labels: collections.abc.Mapping[builtins.str, builtins.str] | None = ...,
+        model_uri: builtins.str = ...,
+        instruction: builtins.str = ...,
+        prompt_truncation_options: yandex.cloud.ai.assistants.v1.common_pb2.PromptTruncationOptions | None = ...,
+        completion_options: yandex.cloud.ai.assistants.v1.common_pb2.CompletionOptions | None = ...,
+        tools: collections.abc.Iterable[yandex.cloud.ai.assistants.v1.common_pb2.Tool] | None = ...,
+        response_format: yandex.cloud.ai.assistants.v1.common_pb2.ResponseFormat | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["completion_options", b"completion_options", "created_at", b"created_at", "expiration_config", b"expiration_config", "expires_at", b"expires_at", "prompt_truncation_options", b"prompt_truncation_options", "response_format", b"response_format", "updated_at", b"updated_at"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["completion_options", b"completion_options", "created_at", b"created_at", "created_by", b"created_by", "description", b"description", "expiration_config", b"expiration_config", "expires_at", b"expires_at", "folder_id", b"folder_id", "id", b"id", "instruction", b"instruction", "labels", b"labels", "model_uri", b"model_uri", "name", b"name", "prompt_truncation_options", b"prompt_truncation_options", "response_format", b"response_format", "tools", b"tools", "updated_at", b"updated_at", "updated_by", b"updated_by"]) -> None: ...
+
+global___Assistant = Assistant