v3.6 changelog¶
Reference the changes introduced to v3.6 of DataRobot's Python API client.
Python client v3.6¶
New features¶
- Added a new class,
OCRJobResource, for running OCR jobs. - Added new Jina V2 embedding model in
VectorDatabaseEmbeddingModel. - Added new small multi-lingual embedding model in
VectorDatabaseEmbeddingModel. - Added the method
Deployment.get_segment_attributesto retrieve segment attributes. - Added the method
Deployment.get_segment_valuesto retrieve segment values. - Added the method
AutomatedDocument.list_all_available_document_typesto return a list of document types. - Added the method
Model.request_per_class_fairness_insightsto return per-class bias and fairness insights. - Added the class
MLOpsEvent <datarobot.mlops.events.MLOpsEvent>to report MLOps events. This class only supportsmoderationMLOps events. - Added the method
Deployment.get_moderation_eventsto retrieve moderation events for that deployment. - Extended the advanced options available when setting a target to include new parameters:
number_of_incremental_learning_iterations_before_best_model_selection(part of the AdvancedOptions object). This parameter allows you to specify how long the top five models will run prior to the selection of the best model. - Added support for
connector_typein the methodConnector.create. - Added the class
DataQualityExportand the methodDeployment.list_data_quality_exports, used to to retrieve a list of data quality records. - Added secure config support for Azure Service Principal credentials.
- Added support for categorical custom metrics in
CustomMetric. - Added the class
NemoConfiguration <datarobot.models.genai.nemo_configuration.NemoConfiguration>to manage Nemo configurations. - Added the method
NemoConfiguration.create <datarobot.models.genai.nemo_configuration.NemoConfiguration.upsert>to create or update a Nemo configuration. - Added the method
NemoConfiguration.get <datarobot.models.genai.nemo_configuration.NemoConfiguration.get>to retrieve a Nemo configuration. - Added a new class
ShapDistributions <datarobot.insights.ShapDistributions>to interact with SHAP distribution insights. - Added the
MODEL_COMPLIANCE_GEN_AIvalue to the attributedocument_typefrom the classDocumentOption <datarobot.models.automated_documentation.DocumentOption>to generate compliance documentation for LLMs in the Registry. - Added new attribute
prompts_countto the classChat. - Added the class
Recipemodules for Data Wrangling. - Added the class
RecipeOperationand a set of subclasses to represent a singleRecipe.operationsoperation. - Added a new attribute
similarity_scoreto the classCitation. - Added a new attributes
retrieverandadd_neighbor_chunksto the classVectorDatabaseSettings. - Added a new attribute
metadatato the classCitation. - Added a new attribute
metadata_filterto the classChatPrompt. - Added a new attribute
metadata_filterto the classComparisonPrompt. - Added a new attribute
custom_chunkingto the classChunkingParameters. - Added a new attribute
custom_chunkingto the classVectorDatabase. - Added a new class
LLMTestConfigurationfor LLM test configurations. - Use the method
LLMTestConfiguration.get <datarobot.models.genai.llm_test_configuration.LLMTestConfiguration.get>to retrieve a hosted LLM test configuration. - Use the method
LLMTestConfiguration.list <datarobot.models.genai.llm_test_configuration.LLMTestConfiguration.list>to list hosted LLM test configurations. - Use the method
LLMTestConfiguration.create <datarobot.models.genai.llm_test_configuration.LLMTestConfiguration.create>to create an LLM test configuration. - Use the method
LLMTestConfiguration.update <datarobot.models.genai.llm_test_configuration.LLMTestConfiguration.update>to update an LLM test configuration. - Use the method
LLMTestConfiguration.delete <datarobot.models.genai.llm_test_configuration.LLMTestConfiguration.delete>to delete an LLM test configuration. - Added a new class
LLMTestConfigurationSupportedInsightsfor LLM test configuration supported insights. - Use the method
LLMTestConfigurationSupportedInsights.listto list hosted LLM test configuration supported insights. - Added a new class
LLMTestResultfor LLM test results. - Use the method
LLMTestResult.getto retrieve a hosted LLM test result. - Use the method
LLMTestResult.listto list hosted LLM test results. - Use the method
LLMTestResult.createto create an LLM test result. - Use the method
LLMTestResult.deleteto delete an LLM test result. - Added a new attribute
dataset_nameto the classOOTBDatasetDict. - Added a new attribute
rows_countto the classOOTBDatasetDict. - Added a new attribute
max_num_promptsto the classDatasetEvaluationDict. - Added a new attribute
prompt_sampling_strategyto the classDatasetEvaluationDict. - Added a new class
DatasetEvaluationRequestDictfor dataset evaluations in create and edit requests. - Added a new attribute
evaluation_dataset_nameto the classInsightEvaluationResult <datarobot.models.genai.llm_test_result.InsightEvaluationResult>. - Added a new attribute
chat_nameto the classInsightEvaluationResult. - Added a new attribute
llm_test_configuration_nameto the classLLMTestResult. - Added a new attribute
creation_user_nameto the classLLMTestResult. - Added a new attribute
pass_percentageto the classLLMTestResult. - Added a new attribute
evaluation_dataset_nameto the classDatasetEvaluation. - Added a new attribute
datasets_compatibilityto the classLLMTestConfigurationSupportedInsights. - Added a new class
NonOOTBDatasetfor non out-of-the-box (OOTB) dataset entities. - Use the method
NonOOTBDataset.listto retrieve non OOTB datasets for compliance testing. - Added a new class {class}
OOTBDatasetfor out-of-the-box dataset entities. - Use the method
OOTBDataset.listto retrieve out-of-the-box datasets for compliance testing. - Added a new class
TraceMetadatato retrieve trace metadata. - Add new attributes to the class
VectorDatabase:parent_id,family_id,metadata_columns,added_dataset_ids,added_dataset_names, andversion. - Use the method
VectorDatabase.get_supported_retrieval_settingsto retrieve supported retrieval settings. - Use the method
VectorDatabase.submit_export_dataset_jobto submit the vector database as a dataset to the AI catalog. - Updated the method
VectorDatabase.createto create a new vector database version. - Added a new class
SupportedRetrievalSettingsfor supported vector database retrieval settings. - Added a new class
SupportedRetrievalSettingfor supported vector database retrieval setting. - Added a new class
VectorDatabaseDatasetExportJobfor vector database dataset export jobs. - Added new attribute
playground_idto the classCostMetricConfiguration. - Added new attribute
nameto the classCostMetricConfiguration. - Added a new class
SupportedInsightsto support lists. - Use the method
SupportedInsights.listto list supported insights. - Added a new class
MetricInsightsfor the new metric insights routes. - Use the method
MetricInsights.listto list metric insights. - Use the method
MetricInsights.copy_to_playgroundto copy metrics to another playground. - Added a new class
PlaygroundOOTBMetricConfigurationfor OOTB metric configurations. - Updated the schema for the class
EvaluationDatasetMetricAggregationto include the new attributesootb_dataset_name,dataset_id, anddataset_name. - Updated the method
EvaluationDatasetMetricAggregation.listwith additional optional filter parameters. - Added new attribute
warningto the classOOTBDataset. - Added new attribute
warningto the classOOTBDatasetDict. - Added new attribute
warningsto the classLLMTestConfiguration. - Added a new parameter
playground_idto the methodSidecarModelMetricValidation.createto support sidecar model metrics transition to playground. - Updated the schema for the class
NemoConfigurationto include the new attributesprompt_pipeline_template_idandresponse_pipeline_template_id. - Added new attributes to the class
EvaluationDatasetConfiguration:rows_countandplayground_id.
API changes¶
- Updated the
exc_messageforServerErrorto be constructed with a request ID to help with debugging. - Added the method
Deployment.get_capabilitiesto retrieve a list ofCapabilityobjects containing capability details. - Advanced options parameters:
modelGroupId,modelRegimeId, andmodelBaselineswere renamed intoseriesId,forecastDistance, andforecastOffsets. - Added the parameter
use_sample_from_datasetfrom the methodProject.create_from_dataset. This parameter, when set, uses the EDA sample of the dataset to start the project. - Added the parameter
quick_computeto functions in the classesShapMatrix,ShapImpact, andShapPreview. - Added the parameter
copy_insightsto the methodPlayground.createto copy the insights from an existing playground to a new one. - Added the parameter
llm_test_configuration_idsto the methodLLMBlueprint.register_custom_model, used to run LLM compliance tests when a blueprint is sent to the custom model workshop.
Enhancements¶
- Added standard pagination parameters (e.g.
limit,offset) to the methodDeployment.list <datarobot.models.Deployment.list>, allowing you to get deployment data in smaller chunks.
Bugfixes¶
- Fixed a field in the class
CustomTaskVersionfor controlling network policies. This is changed fromoutgoing_network_policytooutbound_network_policy. When performing aGETaction, this field was incorrect and always resolved toNone. When attempting aPOSTorPATCHaction, the incorrect field would result in a 422 error. A - Changed the name of
datarobot.enums.CustomTaskOutgoingNetworkPolicytodatarobot.enums.CustomTaskOutboundNetworkPolicyto reflect the proper field name. - Fixed a schema for the class
DataSliceSizeInfoso that it allows an empty list for themessagesfield.
Deprecation summary¶
- Removed the parameter
in_usefrom the methodImageAugmentationList.create. This parameter was deprecated in v3.1.0. - Deprecated the method
AutomatedDocument.list_available_document_types. Please use the methodAutomatedDocument.list_all_available_document_typesinstead. - Deprecated the method
Model.request_fairness_insights. Please use the methodModel.request_per_class_fairness_insightsinstead, to returnStatusCheckJobinstead ofstatus_id. - Deprecated the method
Model.get_prime_eligibility. Prime models are no longer supported. - The
eligibleForPrimefield will no longer be returned from the methodModel.get_supported_capabilitiesand will be removed after version 3.8 is released. - Deprecated the property
ShapImpact.row_countand it will be removed after version 3.7 is released. - Advanced options parameters:
modelGroupId,modelRegimeId, andmodelBaselineswere renamed intoseriesId,forecastDistance, andforecastOffsets. The former names are deprecated and they will be removed after version 3.6 is released. - Renamed
datarobot.enums.CustomTaskOutgoingNetworkPolicytodatarobot.enums.CustomTaskOutboundNetworkPolicyto reflect bugfix changes. The original enum was unusable. - Removed the parameter
user_agent_suffixindatarobot.Client. Please usetrace_contextinstead. - Removed the deprecated method
DataStore.get_access_list. Please use the methodDataStore.get_shared_rolesinstead. - Removed support for
SharingAccessinstances in the methodDataStore.update_access_list. UseSharingRoleinstances instead. - Deprecated
file_pathfor the methodsConnector.createandConnector.update.
Configuration changes¶
- Removed the upper bound pin on the
urllib3package to allow versions 2.0.2 and above. - Upgraded the
Pillowlibrary to version 10.3.0. Users installing DataRobot with the "images" extra (pip install datarobot[images]) should note that this is a required library.
Documentation changes¶
- The
API Reference pagehas been split into multiple sections for better usability. - Fixed documentation for the method
Project.refreshto clarify that it does not return a value. - Fixed code examples for the class
ExternalScores. - Added a copy button to code examples in ReadTheDocs documentation, for convenience.
- Removed the outdated "Examples" section from the documentation. Please refer to DataRobot's API Documentation Home for more examples.
- Removed the duplicate "Getting started" section from the documentation.
- Updated to Sphinx RTD Theme v3.
Experimental changes¶
- Added the
force_updateparameter to theupdatemethod in the classChunkDefinition. - Removed attribute
select_columnsfrom the classChunkDefinition - Added initial experimental support for Chunking Service V2
DatasetDefinitionDatasetPropsDatasetInfoDynamicDatasetPropsRowsChunkDefinitionFeaturesChunkDefinitionChunkDefinitionStats-
ChunkDefinition -
Added a new method,
update, to the classChunkDefinition. -
Added experimental support for time-aware wrangling, including a usage template:
-
datarobot._experimental.models.time_series_wrangling_template.user_flow_template: Experimental changes offer automated time series feature engineering for the data in Snowflake or Postgres. -
Added the ability to use the Spark dialect when creating a recipe, allowing data wrangling support for files.
-
Added new attribute
warningto the classChat. -
Moved all modules from
datarobot._experimental.models.genaitodatarobot.models.genai. -
Added a new method
Model.train_first_incremental_from_samplethat trains the first incremental learning iteration from an existing sample model. Requires the "Project Creation from a Dataset Sample" feature flag.