databricks-sdk 0.153.0__tar.gz → 0.155.0__tar.gz
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.
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/CHANGELOG.md +28 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/PKG-INFO +1 -1
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/__init__.py +2 -2
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/config.py +5 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/files.py +175 -14
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/agentkit.py +46 -49
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/billing.py +27 -6
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/bundledeployments.py +7 -6
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/catalog.py +93 -15
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/compute.py +5 -33
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/disasterrecovery.py +45 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/jobs.py +71 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/knowledgeassistants.py +1 -1
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/ml.py +108 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/pipelines.py +4 -2
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/sandbox.py +378 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/sharing.py +1 -48
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/sql.py +126 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/supervisoragents.py +1 -1
- databricks_sdk-0.155.0/databricks/sdk/version.py +1 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks_sdk.egg-info/PKG-INFO +1 -1
- databricks_sdk-0.153.0/databricks/sdk/version.py +0 -1
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/CONTRIBUTING.md +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/DCO +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/LICENSE +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/MANIFEST.in +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/Makefile +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/NOTICE +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/README.md +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/SECURITY.md +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/__init__.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_base_client.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_property.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_sandbox_grpc/__init__.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_sandbox_grpc/sandbox_service_pb2.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_sandbox_grpc/sandbox_service_pb2_grpc.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_widgets/__init__.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_widgets/default_widgets_utils.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/_widgets/ipywidgets_utils.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/azure.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/casing.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/client_types.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/clock.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/common/lro.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/common/types/__init__.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/common/types/fieldmask.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/core.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/credentials_provider.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/data_plane.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/dbutils.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/environments.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/__init__.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/base.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/customizer.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/deserializer.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/details.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/mapper.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/overrides.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/parser.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/platform.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/private_link.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/errors/sdk.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/logger/__init__.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/logger/round_trip_logger.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/__init__.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/_grpc_transport.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/compute.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/files_utils.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/jobs.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/open_ai_client.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/sandbox.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/sharing.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/mixins/workspace.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/oauth.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/oidc.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/oidc_token_supplier.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/py.typed +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/retries.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/runtime/__init__.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/runtime/dbutils_stub.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/__init__.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/_internal.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/agentbricks.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/aifunctions.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/aisearch.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/apps.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/bundle.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/cleanrooms.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/dashboards.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/database.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/dataclassification.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/dataquality.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/domains.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/environments.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/files.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/iam.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/iamv2.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/marketplace.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/networking.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/oauth2.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/postgres.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/provisioning.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/qualitymonitorv2.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/serving.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/settings.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/settingsv2.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/tags.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/vectorsearch.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/service/workspace.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks/sdk/useragent.py +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks_sdk.egg-info/SOURCES.txt +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks_sdk.egg-info/dependency_links.txt +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks_sdk.egg-info/requires.txt +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/databricks_sdk.egg-info/top_level.txt +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/pyproject.toml +0 -0
- {databricks_sdk-0.153.0 → databricks_sdk-0.155.0}/setup.cfg +0 -0
|
@@ -1,5 +1,33 @@
|
|
|
1
1
|
# Version changelog
|
|
2
2
|
|
|
3
|
+
## Release v0.155.0 (2026-10-21)
|
|
4
|
+
|
|
5
|
+
### API Changes
|
|
6
|
+
* Add `sdp_source` field for `databricks.sdk.service.ml.DataSource`.
|
|
7
|
+
* Add `customer_version_label`, `max_dbu` and `reyden_cluster_size_multiplier` fields for `databricks.sdk.service.sql.CreateWarehouseRequest`.
|
|
8
|
+
* Add `customer_version_label`, `max_dbu` and `reyden_cluster_size_multiplier` fields for `databricks.sdk.service.sql.EditWarehouseRequest`.
|
|
9
|
+
* Add `customer_version_label`, `max_dbu` and `reyden_cluster_size_multiplier` fields for `databricks.sdk.service.sql.EndpointInfo`.
|
|
10
|
+
* Add `customer_version_label`, `max_dbu` and `reyden_cluster_size_multiplier` fields for `databricks.sdk.service.sql.GetWarehouseResponse`.
|
|
11
|
+
* [Breaking] Remove `replication_config` field for `databricks.sdk.service.sharing.CreateShare`.
|
|
12
|
+
* [Breaking] Remove `replication_config` field for `databricks.sdk.service.sharing.ShareInfo`.
|
|
13
|
+
|
|
14
|
+
## Release v0.154.0 (2026-10-19)
|
|
15
|
+
|
|
16
|
+
### API Changes
|
|
17
|
+
* Add `create_directory()`, `delete_path()`, `get_metadata()`, `list_directory_contents()` and `rename_path()` methods for [w.sandbox](https://databricks-sdk-py.readthedocs.io/en/latest/workspace/sandbox/sandbox.html) workspace-level service.
|
|
18
|
+
* Add `secrets` field for `databricks.sdk.service.catalog.ConnectionInfo`.
|
|
19
|
+
* Add `secrets` field for `databricks.sdk.service.catalog.CreateConnection`.
|
|
20
|
+
* Add `governed_tags` field for `databricks.sdk.service.catalog.PolicyInfo`.
|
|
21
|
+
* Add `secrets` field for `databricks.sdk.service.catalog.UpdateConnection`.
|
|
22
|
+
* Add `has_replication_point_blocking_errors` and `initial_replication_progress` fields for `databricks.sdk.service.disasterrecovery.FailoverGroup`.
|
|
23
|
+
* Add `duration_target` field for `databricks.sdk.service.jobs.BaseRun`.
|
|
24
|
+
* Add `duration_target` field for `databricks.sdk.service.jobs.CreateJob`.
|
|
25
|
+
* Add `duration_target` field for `databricks.sdk.service.jobs.JobSettings`.
|
|
26
|
+
* Add `duration_target` field for `databricks.sdk.service.jobs.RepairRun`.
|
|
27
|
+
* Add `duration_target` field for `databricks.sdk.service.jobs.Run`.
|
|
28
|
+
* Add `duration_target` field for `databricks.sdk.service.jobs.RunNow`.
|
|
29
|
+
* Add `duration_target` field for `databricks.sdk.service.jobs.SubmitRun`.
|
|
30
|
+
|
|
3
31
|
## Release v0.153.0 (2026-10-15)
|
|
4
32
|
|
|
5
33
|
### API Changes
|
|
@@ -829,7 +829,7 @@ class WorkspaceClient:
|
|
|
829
829
|
|
|
830
830
|
@property
|
|
831
831
|
def knowledge_assistants(self) -> pkg_knowledgeassistants.KnowledgeAssistantsAPI:
|
|
832
|
-
"""Manage Knowledge Assistants and related resources."""
|
|
832
|
+
"""Manage legacy Knowledge Assistants and related resources."""
|
|
833
833
|
return self._knowledge_assistants
|
|
834
834
|
|
|
835
835
|
@property
|
|
@@ -1094,7 +1094,7 @@ class WorkspaceClient:
|
|
|
1094
1094
|
|
|
1095
1095
|
@property
|
|
1096
1096
|
def supervisor_agents(self) -> pkg_supervisoragents.SupervisorAgentsAPI:
|
|
1097
|
-
"""Manage Supervisor Agents and related resources."""
|
|
1097
|
+
"""Manage legacy Supervisor Agents and related resources."""
|
|
1098
1098
|
return self._supervisor_agents
|
|
1099
1099
|
|
|
1100
1100
|
@property
|
|
@@ -267,6 +267,11 @@ class Config:
|
|
|
267
267
|
# When enabled, the SDK will probe the storage proxy and use it if available.
|
|
268
268
|
experimental_files_ext_enable_storage_proxy: bool = False
|
|
269
269
|
|
|
270
|
+
# Whether to ask the workspace which endpoints to use for file transfers (GET /api/2.0/fs/endpoints).
|
|
271
|
+
# When disabled, or when the server cannot answer, the SDK uses a built-in order: Presigned URL, then
|
|
272
|
+
# Files API 2.0 on the workspace host.
|
|
273
|
+
experimental_files_ext_enable_endpoints_api: bool = False
|
|
274
|
+
|
|
270
275
|
def __init__(
|
|
271
276
|
self,
|
|
272
277
|
*,
|
|
@@ -16,6 +16,7 @@ from collections.abc import Iterator
|
|
|
16
16
|
from concurrent.futures import ThreadPoolExecutor, as_completed
|
|
17
17
|
from dataclasses import dataclass
|
|
18
18
|
from datetime import timedelta
|
|
19
|
+
from enum import Enum
|
|
19
20
|
from io import BytesIO
|
|
20
21
|
from queue import Empty, Full, Queue
|
|
21
22
|
from tempfile import mkstemp
|
|
@@ -746,6 +747,35 @@ class _PresignedUrl:
|
|
|
746
747
|
part_number: int | None = None
|
|
747
748
|
|
|
748
749
|
|
|
750
|
+
class _ResolvedEndpoint(Enum):
|
|
751
|
+
"""A file transfer protocol this SDK can speak, identified by the (api, api_version) pair the
|
|
752
|
+
endpoints API returns."""
|
|
753
|
+
|
|
754
|
+
IO_OFFLOAD = "IO_OFFLOAD"
|
|
755
|
+
FILES_API_V2 = "FILES_API_V2"
|
|
756
|
+
|
|
757
|
+
|
|
758
|
+
# Maps the server's (api, api_version) to a protocol compiled into this SDK. Pairs not listed here are
|
|
759
|
+
# skipped, which lets the server advertise newer protocols without breaking older SDKs. IO_OFFLOAD is
|
|
760
|
+
# unversioned during the preview, so a versioned IO_OFFLOAD is newer than this SDK.
|
|
761
|
+
_RECOGNIZED_ENDPOINTS: dict[tuple[str, Optional[str]], _ResolvedEndpoint] = {
|
|
762
|
+
("IO_OFFLOAD", None): _ResolvedEndpoint.IO_OFFLOAD,
|
|
763
|
+
("FILES_API", "2.0"): _ResolvedEndpoint.FILES_API_V2,
|
|
764
|
+
}
|
|
765
|
+
|
|
766
|
+
_ENDPOINT_SCHEMES = ("http", "https")
|
|
767
|
+
|
|
768
|
+
|
|
769
|
+
@dataclass(frozen=True)
|
|
770
|
+
class _Endpoint:
|
|
771
|
+
"""One entry of the ordered endpoint list a file transfer walks, best first."""
|
|
772
|
+
|
|
773
|
+
kind: _ResolvedEndpoint
|
|
774
|
+
base_url: str
|
|
775
|
+
"""Scheme and hostname as returned by the server, e.g. https://example.cloud.databricks.com."""
|
|
776
|
+
multipart_upload_supported: bool
|
|
777
|
+
|
|
778
|
+
|
|
749
779
|
class _PresignedUrlRequestBuilder:
|
|
750
780
|
"""Builds presigned URL requests for file upload operations.
|
|
751
781
|
|
|
@@ -928,6 +958,12 @@ class FilesExt(files.FilesAPI):
|
|
|
928
958
|
# Timeout in seconds for the storage-proxy health check probe.
|
|
929
959
|
_STORAGE_PROXY_PROBE_TIMEOUT: float = 3.0
|
|
930
960
|
|
|
961
|
+
_ENDPOINTS_API_PATH: str = "/api/2.0/fs/endpoints"
|
|
962
|
+
|
|
963
|
+
# Endpoint discovery is a single attempt bounded by this timeout: it precedes a transfer, so it
|
|
964
|
+
# must fail fast to the default order rather than retry and stall the upload or download.
|
|
965
|
+
_ENDPOINTS_RESOLVE_TIMEOUT_SECONDS: float = 10.0
|
|
966
|
+
|
|
931
967
|
@dataclass(frozen=True)
|
|
932
968
|
class _UploadContext:
|
|
933
969
|
target_path: str
|
|
@@ -956,13 +992,129 @@ class FilesExt(files.FilesAPI):
|
|
|
956
992
|
self._dp_hostname_available: Optional[bool] = None
|
|
957
993
|
self._cached_storage_proxy_session: Optional[requests.Session] = None
|
|
958
994
|
self._storage_proxy_session_lock = Lock()
|
|
995
|
+
self._cached_endpoints: Optional[list[_Endpoint]] = None
|
|
996
|
+
self._endpoints_lock = Lock()
|
|
959
997
|
|
|
960
|
-
def
|
|
961
|
-
"""Returns the
|
|
998
|
+
def _resolve_endpoints(self) -> list[_Endpoint]:
|
|
999
|
+
"""Returns the ordered endpoints to try for a file transfer, best first.
|
|
962
1000
|
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
|
|
1001
|
+
The server is asked once per client and its answer, including a failure, is cached. Anything
|
|
1002
|
+
short of a usable list falls back to the built-in order, so endpoint discovery never fails a
|
|
1003
|
+
transfer.
|
|
1004
|
+
"""
|
|
1005
|
+
if not self._config.experimental_files_ext_enable_endpoints_api:
|
|
1006
|
+
return self._default_endpoints()
|
|
1007
|
+
with self._endpoints_lock:
|
|
1008
|
+
if self._cached_endpoints is None:
|
|
1009
|
+
self._cached_endpoints = self._fetch_endpoints() or self._default_endpoints()
|
|
1010
|
+
return list(self._cached_endpoints)
|
|
1011
|
+
|
|
1012
|
+
def _default_endpoints(self) -> list[_Endpoint]:
|
|
1013
|
+
host = self._config.host
|
|
1014
|
+
return [
|
|
1015
|
+
_Endpoint(_ResolvedEndpoint.IO_OFFLOAD, host, multipart_upload_supported=True),
|
|
1016
|
+
_Endpoint(_ResolvedEndpoint.FILES_API_V2, host, multipart_upload_supported=False),
|
|
1017
|
+
]
|
|
1018
|
+
|
|
1019
|
+
def _fetch_endpoints(self) -> list[_Endpoint]:
|
|
1020
|
+
"""Fetches the endpoint list from the server, keeping only entries this SDK can speak.
|
|
1021
|
+
|
|
1022
|
+
Discovery runs before a transfer, so it is a single short-timeout attempt with no retries: a
|
|
1023
|
+
slow or failing endpoint must fall back to the default order quickly rather than hold up the
|
|
1024
|
+
upload or download.
|
|
1025
|
+
"""
|
|
1026
|
+
url = f"{self._config.host}{self._ENDPOINTS_API_PATH}"
|
|
1027
|
+
try:
|
|
1028
|
+
response = self._cloud_provider_session().request(
|
|
1029
|
+
"GET",
|
|
1030
|
+
url,
|
|
1031
|
+
headers={**self._config.authenticate(), "Accept": "application/json"},
|
|
1032
|
+
timeout=self._ENDPOINTS_RESOLVE_TIMEOUT_SECONDS,
|
|
1033
|
+
)
|
|
1034
|
+
except Exception as e:
|
|
1035
|
+
# Broad on purpose: network and auth failures must all fail safe to the default order.
|
|
1036
|
+
_LOG.warning(f"Failed to resolve file endpoints, using the default endpoints: {e}")
|
|
1037
|
+
return []
|
|
1038
|
+
|
|
1039
|
+
# Lets a failure below be traced to the server's request log.
|
|
1040
|
+
request_id = response.headers.get("x-request-id")
|
|
1041
|
+
if response.status_code == 404:
|
|
1042
|
+
# Not a warning: until the server-side rollout completes, some workspaces do not serve the API.
|
|
1043
|
+
_LOG.info(
|
|
1044
|
+
f"Endpoints API is not served for this workspace (request ID {request_id}), using the default endpoints."
|
|
1045
|
+
)
|
|
1046
|
+
return []
|
|
1047
|
+
if response.status_code != 200:
|
|
1048
|
+
_LOG.warning(
|
|
1049
|
+
f"Unexpected status resolving file endpoints ({response.status_code}, request ID {request_id}), "
|
|
1050
|
+
"using the default endpoints."
|
|
1051
|
+
)
|
|
1052
|
+
return []
|
|
1053
|
+
try:
|
|
1054
|
+
body = response.json()
|
|
1055
|
+
except Exception as e:
|
|
1056
|
+
_LOG.warning(
|
|
1057
|
+
f"Failed to parse endpoints response (request ID {request_id}), using the default endpoints: {e}"
|
|
1058
|
+
)
|
|
1059
|
+
return []
|
|
1060
|
+
|
|
1061
|
+
# Proto3 JSON leaves out an empty repeated field.
|
|
1062
|
+
entries = body.get("endpoints", []) if isinstance(body, dict) else None
|
|
1063
|
+
if not isinstance(entries, list):
|
|
1064
|
+
_LOG.warning(
|
|
1065
|
+
f"Unexpected endpoints response (request ID {request_id}), using the default endpoints: {body}"
|
|
1066
|
+
)
|
|
1067
|
+
return []
|
|
1068
|
+
endpoints = []
|
|
1069
|
+
for entry in entries:
|
|
1070
|
+
kind = self._endpoint_kind(entry)
|
|
1071
|
+
if kind is None:
|
|
1072
|
+
# Not a warning: an older SDK is expected to skip entries for APIs added after it shipped.
|
|
1073
|
+
_LOG.info(f"Skipping endpoint this SDK cannot use (request ID {request_id}): {entry}")
|
|
1074
|
+
continue
|
|
1075
|
+
endpoint = self._parse_endpoint(entry, kind)
|
|
1076
|
+
if endpoint is None:
|
|
1077
|
+
_LOG.warning(
|
|
1078
|
+
f"Skipping {kind.value} endpoint with an unusable address (request ID {request_id}): {entry}"
|
|
1079
|
+
)
|
|
1080
|
+
continue
|
|
1081
|
+
endpoints.append(endpoint)
|
|
1082
|
+
if not endpoints:
|
|
1083
|
+
_LOG.warning(f"No usable endpoints in the response (request ID {request_id}), using the default endpoints.")
|
|
1084
|
+
return endpoints
|
|
1085
|
+
|
|
1086
|
+
@staticmethod
|
|
1087
|
+
def _endpoint_kind(entry) -> Optional[_ResolvedEndpoint]:
|
|
1088
|
+
"""Returns the protocol of a listed endpoint, or None if this SDK does not speak it."""
|
|
1089
|
+
if not isinstance(entry, dict):
|
|
1090
|
+
return None
|
|
1091
|
+
api = entry.get("api")
|
|
1092
|
+
api_version = entry.get("api_version")
|
|
1093
|
+
# The entry is unvalidated JSON: an unhashable value such as a list would make the lookup below raise
|
|
1094
|
+
# instead of skipping the entry. IO_OFFLOAD entries have no api_version, so None is allowed.
|
|
1095
|
+
if not isinstance(api, str) or not (api_version is None or isinstance(api_version, str)):
|
|
1096
|
+
return None
|
|
1097
|
+
return _RECOGNIZED_ENDPOINTS.get((api, api_version))
|
|
1098
|
+
|
|
1099
|
+
@staticmethod
|
|
1100
|
+
def _parse_endpoint(entry: dict, kind: _ResolvedEndpoint) -> Optional[_Endpoint]:
|
|
1101
|
+
scheme = entry.get("scheme")
|
|
1102
|
+
hostname = entry.get("hostname")
|
|
1103
|
+
if scheme not in _ENDPOINT_SCHEMES or not isinstance(hostname, str) or not hostname:
|
|
1104
|
+
return None
|
|
1105
|
+
# Mirrors the proto getter: an unset optional bool reads as false.
|
|
1106
|
+
multipart_upload_supported = entry.get("multipart_upload_supported") is True
|
|
1107
|
+
return _Endpoint(kind, f"{scheme}://{hostname}", multipart_upload_supported)
|
|
1108
|
+
|
|
1109
|
+
def _active_endpoint(self) -> _Endpoint:
|
|
1110
|
+
"""The endpoint used for bulk file transfer.
|
|
1111
|
+
|
|
1112
|
+
Selected by the storage-proxy probe: the storage proxy (a direct Files API path) when the probe
|
|
1113
|
+
finds it available, otherwise the offload (presigned) path on the workspace host. The probe runs
|
|
1114
|
+
once and its result is cached.
|
|
1115
|
+
|
|
1116
|
+
This is the single-endpoint selection; PR wiring the endpoints API replaces it with a walk over
|
|
1117
|
+
the server-resolved list.
|
|
966
1118
|
"""
|
|
967
1119
|
if self._config.experimental_files_ext_enable_storage_proxy:
|
|
968
1120
|
if self._dp_hostname_available is None:
|
|
@@ -972,19 +1124,28 @@ class FilesExt(files.FilesAPI):
|
|
|
972
1124
|
else:
|
|
973
1125
|
_LOG.info("Storage proxy is not available, will use presigned URLs.")
|
|
974
1126
|
if self._dp_hostname_available:
|
|
975
|
-
return
|
|
976
|
-
|
|
1127
|
+
return _Endpoint(
|
|
1128
|
+
_ResolvedEndpoint.FILES_API_V2, self._STORAGE_PROXY_HOSTNAME, multipart_upload_supported=True
|
|
1129
|
+
)
|
|
1130
|
+
return _Endpoint(_ResolvedEndpoint.IO_OFFLOAD, self._config.host, multipart_upload_supported=True)
|
|
1131
|
+
|
|
1132
|
+
def _get_hostname(self) -> str:
|
|
1133
|
+
"""Returns the scheme+hostname for file operations, e.g. https://example.cloud.databricks.com."""
|
|
1134
|
+
return self._active_endpoint().base_url
|
|
977
1135
|
|
|
978
1136
|
def _create_request_builder(self):
|
|
979
|
-
"""Creates the
|
|
1137
|
+
"""Creates the request builder for the active endpoint."""
|
|
1138
|
+
return self._request_builder_for(self._active_endpoint())
|
|
1139
|
+
|
|
1140
|
+
def _request_builder_for(self, endpoint: _Endpoint):
|
|
1141
|
+
"""Maps an endpoint to the builder that speaks its protocol.
|
|
980
1142
|
|
|
981
|
-
|
|
982
|
-
|
|
1143
|
+
The offload path coordinates presigned URLs through the workspace API; the direct Files API path
|
|
1144
|
+
builds URLs straight at the endpoint host.
|
|
983
1145
|
"""
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
987
|
-
return _PresignedUrlRequestBuilder(self._api, hostname)
|
|
1146
|
+
if endpoint.kind == _ResolvedEndpoint.IO_OFFLOAD:
|
|
1147
|
+
return _PresignedUrlRequestBuilder(self._api, endpoint.base_url)
|
|
1148
|
+
return _StorageProxyRequestBuilder(endpoint.base_url)
|
|
988
1149
|
|
|
989
1150
|
def _resolve_workspace_id(self) -> Optional[str]:
|
|
990
1151
|
"""Resolves the workspace ID by querying the SCIM Me endpoint."""
|
|
@@ -138,10 +138,10 @@ class ForkSessionResponse:
|
|
|
138
138
|
|
|
139
139
|
@dataclass
|
|
140
140
|
class ListManagedMemoryEntriesResponse:
|
|
141
|
-
"""Response containing
|
|
141
|
+
"""Response containing memory entries."""
|
|
142
142
|
|
|
143
143
|
managed_memory_entries: Optional[List[ManagedMemoryEntry]] = None
|
|
144
|
-
"""
|
|
144
|
+
"""Memory entries matching the request and selected response view."""
|
|
145
145
|
|
|
146
146
|
next_page_token: Optional[str] = None
|
|
147
147
|
"""Opaque pagination token. This field is omitted when there are no more results."""
|
|
@@ -175,10 +175,10 @@ class ListManagedMemoryEntriesResponse:
|
|
|
175
175
|
|
|
176
176
|
@dataclass
|
|
177
177
|
class ListManagedMemoryStoresResponse:
|
|
178
|
-
"""Response containing
|
|
178
|
+
"""Response containing memory stores in the caller's workspace."""
|
|
179
179
|
|
|
180
180
|
managed_memory_stores: Optional[List[ManagedMemoryStore]] = None
|
|
181
|
-
"""
|
|
181
|
+
"""Memory stores in the caller's workspace."""
|
|
182
182
|
|
|
183
183
|
next_page_token: Optional[str] = None
|
|
184
184
|
"""Opaque pagination token. This field is omitted when there are no more results."""
|
|
@@ -320,7 +320,7 @@ class ListSessionsResponse:
|
|
|
320
320
|
|
|
321
321
|
@dataclass
|
|
322
322
|
class ManagedMemoryEntry:
|
|
323
|
-
"""A workspace-scoped entry in a
|
|
323
|
+
"""A workspace-scoped entry in a memory store."""
|
|
324
324
|
|
|
325
325
|
actor_id: str
|
|
326
326
|
"""Customer-provided identifier for the actor whose memory this entry represents."""
|
|
@@ -416,10 +416,10 @@ class ManagedMemoryEntry:
|
|
|
416
416
|
|
|
417
417
|
@dataclass
|
|
418
418
|
class ManagedMemoryEntrySearchResult:
|
|
419
|
-
"""One relevance-ranked
|
|
419
|
+
"""One relevance-ranked memory search result."""
|
|
420
420
|
|
|
421
421
|
managed_memory_entry: Optional[ManagedMemoryEntry] = None
|
|
422
|
-
"""
|
|
422
|
+
"""Memory entry matching the query."""
|
|
423
423
|
|
|
424
424
|
score: Optional[float] = None
|
|
425
425
|
"""Relevance score for the result. Higher scores are more relevant."""
|
|
@@ -451,14 +451,14 @@ class ManagedMemoryEntrySearchResult:
|
|
|
451
451
|
|
|
452
452
|
|
|
453
453
|
class ManagedMemoryEntrySourceType(Enum):
|
|
454
|
-
"""Identifies the source that created a
|
|
454
|
+
"""Identifies the source that created a memory entry."""
|
|
455
455
|
|
|
456
456
|
MANAGED_MEMORY_ENTRY_SOURCE_TYPE_AGENT = "MANAGED_MEMORY_ENTRY_SOURCE_TYPE_AGENT"
|
|
457
457
|
MANAGED_MEMORY_ENTRY_SOURCE_TYPE_DREAMER = "MANAGED_MEMORY_ENTRY_SOURCE_TYPE_DREAMER"
|
|
458
458
|
|
|
459
459
|
|
|
460
460
|
class ManagedMemoryEntryView(Enum):
|
|
461
|
-
"""Controls how much
|
|
461
|
+
"""Controls how much memory entry data is returned."""
|
|
462
462
|
|
|
463
463
|
MANAGED_MEMORY_ENTRY_VIEW_BASIC = "MANAGED_MEMORY_ENTRY_VIEW_BASIC"
|
|
464
464
|
MANAGED_MEMORY_ENTRY_VIEW_FULL = "MANAGED_MEMORY_ENTRY_VIEW_FULL"
|
|
@@ -466,7 +466,7 @@ class ManagedMemoryEntryView(Enum):
|
|
|
466
466
|
|
|
467
467
|
@dataclass
|
|
468
468
|
class ManagedMemoryStore:
|
|
469
|
-
"""A workspace-scoped
|
|
469
|
+
"""A workspace-scoped memory store backed by service-managed storage."""
|
|
470
470
|
|
|
471
471
|
create_time: Optional[Timestamp] = None
|
|
472
472
|
"""Time when the store was created."""
|
|
@@ -480,9 +480,9 @@ class ManagedMemoryStore:
|
|
|
480
480
|
"""Human-readable description of the memory store."""
|
|
481
481
|
|
|
482
482
|
display_name: Optional[str] = None
|
|
483
|
-
"""Deprecated compatibility alias for the caller-provided
|
|
484
|
-
|
|
485
|
-
|
|
483
|
+
"""Deprecated compatibility alias for the caller-provided memory store ID. Canonical clients
|
|
484
|
+
provide the ID through ``CreateMemoryStoreRequest.managed_memory_store_id`` and use ``name`` as
|
|
485
|
+
the resource identifier."""
|
|
486
486
|
|
|
487
487
|
name: Optional[str] = None
|
|
488
488
|
"""Resource name in the form ``memory-stores/{managed_memory_store_id}``."""
|
|
@@ -591,7 +591,7 @@ class PopSessionItemResponse:
|
|
|
591
591
|
|
|
592
592
|
@dataclass
|
|
593
593
|
class SearchManagedMemoryEntriesResponse:
|
|
594
|
-
"""Response containing
|
|
594
|
+
"""Response containing memory entries ranked by relevance."""
|
|
595
595
|
|
|
596
596
|
managed_memory_entries: Optional[List[ManagedMemoryEntry]] = None
|
|
597
597
|
"""Deprecated compatibility alias for clients migrating to ``results``. This contains the same
|
|
@@ -852,7 +852,7 @@ class SessionStore:
|
|
|
852
852
|
|
|
853
853
|
@dataclass
|
|
854
854
|
class StorageBackend:
|
|
855
|
-
"""Service-managed storage backing a
|
|
855
|
+
"""Service-managed storage backing a memory store."""
|
|
856
856
|
|
|
857
857
|
backend_id: Optional[str] = None
|
|
858
858
|
"""Backend-specific identifier. For Lakebase, this is the project ID."""
|
|
@@ -885,7 +885,7 @@ class StorageBackend:
|
|
|
885
885
|
|
|
886
886
|
|
|
887
887
|
class StorageBackendType(Enum):
|
|
888
|
-
"""Type of service-managed storage backing a
|
|
888
|
+
"""Type of service-managed storage backing a memory store."""
|
|
889
889
|
|
|
890
890
|
STORAGE_BACKEND_TYPE_LAKEBASE = "STORAGE_BACKEND_TYPE_LAKEBASE"
|
|
891
891
|
|
|
@@ -951,19 +951,18 @@ class AgentKitAPI:
|
|
|
951
951
|
def create_memory(
|
|
952
952
|
self, parent: str, managed_memory_entry: ManagedMemoryEntry, *, managed_memory_entry_id: Optional[str] = None
|
|
953
953
|
) -> ManagedMemoryEntry:
|
|
954
|
-
"""Creates a
|
|
955
|
-
|
|
956
|
-
|
|
954
|
+
"""Creates a memory entry using exclusive-create semantics. Callers may choose the entry ID; the service
|
|
955
|
+
generates one when it is omitted. Returns ``ALREADY_EXISTS`` when an entry with the same actor,
|
|
956
|
+
session, and path already exists. Omitted ``session_id`` is its own uniqueness key: two
|
|
957
957
|
omitted-session entries with the same actor and path conflict, but an omitted-session entry does not
|
|
958
958
|
conflict with a session-scoped entry at the same actor and path.
|
|
959
959
|
|
|
960
960
|
:param parent: str
|
|
961
|
-
|
|
962
|
-
``memory-stores/{managed_memory_store_id}``.
|
|
961
|
+
Memory store that will contain the entry, in the form ``memory-stores/{managed_memory_store_id}``.
|
|
963
962
|
:param managed_memory_entry: :class:`ManagedMemoryEntry`
|
|
964
|
-
The
|
|
963
|
+
The memory entry to create.
|
|
965
964
|
:param managed_memory_entry_id: str (optional)
|
|
966
|
-
Optional caller-selected
|
|
965
|
+
Optional caller-selected memory entry ID. The service generates an ID when omitted.
|
|
967
966
|
|
|
968
967
|
:returns: :class:`ManagedMemoryEntry`
|
|
969
968
|
"""
|
|
@@ -987,12 +986,12 @@ class AgentKitAPI:
|
|
|
987
986
|
def create_memory_store(
|
|
988
987
|
self, managed_memory_store: ManagedMemoryStore, managed_memory_store_id: str
|
|
989
988
|
) -> ManagedMemoryStore:
|
|
990
|
-
"""Creates a
|
|
989
|
+
"""Creates a memory store in the caller's workspace.
|
|
991
990
|
|
|
992
991
|
:param managed_memory_store: :class:`ManagedMemoryStore`
|
|
993
|
-
The
|
|
992
|
+
The memory store to create.
|
|
994
993
|
:param managed_memory_store_id: str
|
|
995
|
-
Caller-provided, workspace-unique
|
|
994
|
+
Caller-provided, workspace-unique memory store ID. It must be 3-56 characters, begin with a
|
|
996
995
|
lowercase letter, contain only lowercase letters, digits, and hyphens, and end with a letter or
|
|
997
996
|
digit.
|
|
998
997
|
|
|
@@ -1075,8 +1074,8 @@ class AgentKitAPI:
|
|
|
1075
1074
|
return SessionStore.from_dict(res)
|
|
1076
1075
|
|
|
1077
1076
|
def delete_memory(self, name: str):
|
|
1078
|
-
"""Deletes a
|
|
1079
|
-
|
|
1077
|
+
"""Deletes a memory entry by resource name. Returns ``NOT_FOUND`` when the entry does not exist in the
|
|
1078
|
+
caller's workspace.
|
|
1080
1079
|
|
|
1081
1080
|
:param name: str
|
|
1082
1081
|
Resource name in the form
|
|
@@ -1096,8 +1095,8 @@ class AgentKitAPI:
|
|
|
1096
1095
|
self._api.do("DELETE", f"/api/2.0/agents/{name}", headers=headers)
|
|
1097
1096
|
|
|
1098
1097
|
def delete_memory_store(self, name: str):
|
|
1099
|
-
"""Deletes a
|
|
1100
|
-
|
|
1098
|
+
"""Deletes a memory store by resource name. Returns ``NOT_FOUND`` when the store does not exist in the
|
|
1099
|
+
caller's workspace.
|
|
1101
1100
|
|
|
1102
1101
|
:param name: str
|
|
1103
1102
|
Resource name in the form ``memory-stores/{managed_memory_store_id}``.
|
|
@@ -1172,7 +1171,7 @@ class AgentKitAPI:
|
|
|
1172
1171
|
:param session_id: str
|
|
1173
1172
|
Identifier of the session whose transcript is distilled into memories.
|
|
1174
1173
|
:param memory_store: str
|
|
1175
|
-
|
|
1174
|
+
Memory store the extracted entries are written to, in the form
|
|
1176
1175
|
``memory-stores/{managed_memory_store_id}``.
|
|
1177
1176
|
:param dry_run: bool (optional)
|
|
1178
1177
|
When true, extract and return the entries without writing them to the memory store. Defaults to
|
|
@@ -1257,8 +1256,8 @@ class AgentKitAPI:
|
|
|
1257
1256
|
return ForkSessionResponse.from_dict(res)
|
|
1258
1257
|
|
|
1259
1258
|
def get_memory(self, name: str, *, view: Optional[ManagedMemoryEntryView] = None) -> ManagedMemoryEntry:
|
|
1260
|
-
"""Retrieves a
|
|
1261
|
-
|
|
1259
|
+
"""Retrieves a memory entry by resource name. ``view`` controls whether the response includes memory
|
|
1260
|
+
content. Returns ``NOT_FOUND`` when the entry does not exist in the caller's workspace.
|
|
1262
1261
|
|
|
1263
1262
|
:param name: str
|
|
1264
1263
|
Resource name in the form
|
|
@@ -1284,8 +1283,8 @@ class AgentKitAPI:
|
|
|
1284
1283
|
return ManagedMemoryEntry.from_dict(res)
|
|
1285
1284
|
|
|
1286
1285
|
def get_memory_store(self, name: str) -> ManagedMemoryStore:
|
|
1287
|
-
"""Retrieves a
|
|
1288
|
-
|
|
1286
|
+
"""Retrieves a memory store by resource name. Returns ``NOT_FOUND`` when the store does not exist in the
|
|
1287
|
+
caller's workspace.
|
|
1289
1288
|
|
|
1290
1289
|
:param name: str
|
|
1291
1290
|
Resource name in the form ``memory-stores/{managed_memory_store_id}``.
|
|
@@ -1355,13 +1354,12 @@ class AgentKitAPI:
|
|
|
1355
1354
|
session_id: Optional[str] = None,
|
|
1356
1355
|
view: Optional[ManagedMemoryEntryView] = None,
|
|
1357
1356
|
) -> Iterator[ManagedMemoryEntry]:
|
|
1358
|
-
"""Lists
|
|
1359
|
-
|
|
1360
|
-
|
|
1357
|
+
"""Lists memory entries for one actor. An exact ``path`` filters entries across sessions, ignoring
|
|
1358
|
+
session metadata. Otherwise, ``session_id`` and ``path_prefix`` restrict the actor partition. ``view``
|
|
1359
|
+
controls whether each returned entry includes memory content.
|
|
1361
1360
|
|
|
1362
1361
|
:param parent: str
|
|
1363
|
-
|
|
1364
|
-
``memory-stores/{managed_memory_store_id}``.
|
|
1362
|
+
Memory store whose entries are listed, in the form ``memory-stores/{managed_memory_store_id}``.
|
|
1365
1363
|
:param actor_id: str
|
|
1366
1364
|
Customer-provided identifier for the actor whose entries are listed.
|
|
1367
1365
|
:param page_size: int (optional)
|
|
@@ -1413,7 +1411,7 @@ class AgentKitAPI:
|
|
|
1413
1411
|
def list_memory_stores(
|
|
1414
1412
|
self, *, page_size: Optional[int] = None, page_token: Optional[str] = None
|
|
1415
1413
|
) -> Iterator[ManagedMemoryStore]:
|
|
1416
|
-
"""Lists
|
|
1414
|
+
"""Lists memory stores in the caller's workspace.
|
|
1417
1415
|
|
|
1418
1416
|
:param page_size: int (optional)
|
|
1419
1417
|
Maximum number of stores to return. The service may return fewer stores than requested. Defaults to
|
|
@@ -1621,12 +1619,11 @@ class AgentKitAPI:
|
|
|
1621
1619
|
session_id: Optional[str] = None,
|
|
1622
1620
|
view: Optional[ManagedMemoryEntryView] = None,
|
|
1623
1621
|
) -> Iterator[ManagedMemoryEntrySearchResult]:
|
|
1624
|
-
"""Searches
|
|
1625
|
-
|
|
1622
|
+
"""Searches memory entries by text query for one actor. Returns matching entries and scores ranked by
|
|
1623
|
+
relevance; ``view`` controls whether each returned entry includes content.
|
|
1626
1624
|
|
|
1627
1625
|
:param parent: str
|
|
1628
|
-
|
|
1629
|
-
``memory-stores/{managed_memory_store_id}``.
|
|
1626
|
+
Memory store whose entries are searched, in the form ``memory-stores/{managed_memory_store_id}``.
|
|
1630
1627
|
:param actor_id: str
|
|
1631
1628
|
Customer-provided identifier for the actor whose entries are searched.
|
|
1632
1629
|
:param query: str
|
|
@@ -1689,13 +1686,13 @@ class AgentKitAPI:
|
|
|
1689
1686
|
def update_memory(
|
|
1690
1687
|
self, name: str, managed_memory_entry: ManagedMemoryEntry, update_mask: FieldMask
|
|
1691
1688
|
) -> ManagedMemoryEntry:
|
|
1692
|
-
"""Updates selected mutable fields on a
|
|
1689
|
+
"""Updates selected mutable fields on a memory entry. Identity fields are immutable.
|
|
1693
1690
|
|
|
1694
1691
|
:param name: str
|
|
1695
1692
|
Resource name in the form
|
|
1696
1693
|
``memory-stores/{managed_memory_store_id}/entries/{managed_memory_entry_id}``.
|
|
1697
1694
|
:param managed_memory_entry: :class:`ManagedMemoryEntry`
|
|
1698
|
-
The
|
|
1695
|
+
The memory entry to update.
|
|
1699
1696
|
:param update_mask: FieldMask
|
|
1700
1697
|
Fields to update. Only ``content`` and ``description`` may be updated.
|
|
1701
1698
|
|
|
@@ -1721,12 +1718,12 @@ class AgentKitAPI:
|
|
|
1721
1718
|
def update_memory_store(
|
|
1722
1719
|
self, name: str, managed_memory_store: ManagedMemoryStore, update_mask: FieldMask
|
|
1723
1720
|
) -> ManagedMemoryStore:
|
|
1724
|
-
"""Updates a
|
|
1721
|
+
"""Updates a memory store's description and metadata.
|
|
1725
1722
|
|
|
1726
1723
|
:param name: str
|
|
1727
1724
|
Resource name in the form ``memory-stores/{managed_memory_store_id}``.
|
|
1728
1725
|
:param managed_memory_store: :class:`ManagedMemoryStore`
|
|
1729
|
-
The
|
|
1726
|
+
The memory store to update. ``name`` is taken from the URL.
|
|
1730
1727
|
:param update_mask: FieldMask
|
|
1731
1728
|
Only ``description`` and ``metadata`` may be updated. Selecting ``metadata`` replaces the entire
|
|
1732
1729
|
map.
|
|
@@ -193,8 +193,15 @@ class BudgetConfiguration:
|
|
|
193
193
|
"""Databricks account ID."""
|
|
194
194
|
|
|
195
195
|
alert_configurations: Optional[List[AlertConfiguration]] = None
|
|
196
|
-
"""Alerts to configure when this budget is in a triggered state. Budgets must have
|
|
197
|
-
alert configuration.
|
|
196
|
+
"""Alerts to configure when this budget is in a triggered state. Budgets must have at least one
|
|
197
|
+
alert configuration. A budget can have up to four shared alerts per time period, each with a
|
|
198
|
+
unique ``quantity_threshold``. Budgets with ``resource_type`` set to
|
|
199
|
+
``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY`` can also use per-user alerts, with optional
|
|
200
|
+
``principal_overrides``. These budgets can have at most one per-user alert per time period, and
|
|
201
|
+
can use shared alerts, a per-user alert, or both. The ``BLOCK_USAGE`` action is only supported
|
|
202
|
+
on budgets with ``resource_type`` set to ``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY``. At most one
|
|
203
|
+
shared alert per time period can have a ``BLOCK_USAGE`` action, and it must be the shared alert
|
|
204
|
+
with the highest threshold in that period."""
|
|
198
205
|
|
|
199
206
|
budget_configuration_id: Optional[str] = None
|
|
200
207
|
"""Databricks budget configuration ID."""
|
|
@@ -504,8 +511,15 @@ class CreateBudgetConfigurationBudget:
|
|
|
504
511
|
"""Databricks account ID."""
|
|
505
512
|
|
|
506
513
|
alert_configurations: Optional[List[CreateBudgetConfigurationBudgetAlertConfigurations]] = None
|
|
507
|
-
"""Alerts to configure when this budget is in a triggered state. Budgets must have
|
|
508
|
-
alert configuration.
|
|
514
|
+
"""Alerts to configure when this budget is in a triggered state. Budgets must have at least one
|
|
515
|
+
alert configuration. A budget can have up to four shared alerts per time period, each with a
|
|
516
|
+
unique ``quantity_threshold``. Budgets with ``resource_type`` set to
|
|
517
|
+
``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY`` can also use per-user alerts, with optional
|
|
518
|
+
``principal_overrides``. These budgets can have at most one per-user alert per time period, and
|
|
519
|
+
can use shared alerts, a per-user alert, or both. The ``BLOCK_USAGE`` action is only supported
|
|
520
|
+
on budgets with ``resource_type`` set to ``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY``. At most one
|
|
521
|
+
shared alert per time period can have a ``BLOCK_USAGE`` action, and it must be the shared alert
|
|
522
|
+
with the highest threshold in that period."""
|
|
509
523
|
|
|
510
524
|
display_name: Optional[str] = None
|
|
511
525
|
"""Human-readable name of budget configuration. Max Length: 128"""
|
|
@@ -1470,8 +1484,15 @@ class UpdateBudgetConfigurationBudget:
|
|
|
1470
1484
|
"""Databricks account ID."""
|
|
1471
1485
|
|
|
1472
1486
|
alert_configurations: Optional[List[AlertConfiguration]] = None
|
|
1473
|
-
"""Alerts to configure when this budget is in a triggered state. Budgets must have
|
|
1474
|
-
alert configuration.
|
|
1487
|
+
"""Alerts to configure when this budget is in a triggered state. Budgets must have at least one
|
|
1488
|
+
alert configuration. A budget can have up to four shared alerts per time period, each with a
|
|
1489
|
+
unique ``quantity_threshold``. Budgets with ``resource_type`` set to
|
|
1490
|
+
``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY`` can also use per-user alerts, with optional
|
|
1491
|
+
``principal_overrides``. These budgets can have at most one per-user alert per time period, and
|
|
1492
|
+
can use shared alerts, a per-user alert, or both. The ``BLOCK_USAGE`` action is only supported
|
|
1493
|
+
on budgets with ``resource_type`` set to ``BUDGET_RESOURCE_TYPE_UNITY_AI_GATEWAY``. At most one
|
|
1494
|
+
shared alert per time period can have a ``BLOCK_USAGE`` action, and it must be the shared alert
|
|
1495
|
+
with the highest threshold in that period."""
|
|
1475
1496
|
|
|
1476
1497
|
budget_configuration_id: Optional[str] = None
|
|
1477
1498
|
"""Databricks budget configuration ID."""
|