Skip to content

Commit 59e8e27

Browse files
Merge pull request #214531 from peytonfraser/patch-2
Update model-lifecycle for version-less changes
2 parents 68c321d + 83f42c8 commit 59e8e27

File tree

1 file changed

+8
-18
lines changed

1 file changed

+8
-18
lines changed

articles/cognitive-services/language-service/concepts/model-lifecycle.md

Lines changed: 8 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -15,41 +15,31 @@ ms.author: aahi
1515

1616
# Model lifecycle
1717

18-
Language service features utilize AI models that are versioned. We update the language service with new model versions to improve accuracy, support, and quality. As models become older, they're retired. Use this article for information on that process, and what you can expect for your applications.
18+
Language service features utilize AI models. We update the language service with new model versions to improve accuracy, support, and quality. As models become older, they are retired. Use this article for information on that process, and what you can expect for your applications.
1919

2020
## Prebuilt features
2121

22-
### Expiration timeline
23-
24-
Our standard (not customized) language service features are built upon AI models that we call pre-trained models. We update the language service with new model versions every few months to improve model accuracy, support, and quality.
2522

26-
As new models and functionalities become available, older less accurate models are deprecated. To ensure you're using the latest model version and avoid interruptions to your applications, we highly recommend using the default model-version parameter (`latest`) in your API calls. After their deprecation date, pre-built model versions will no longer be functional, and your implementation may be broken.
23+
Our standard (not customized) language service features are built on AI models that we call pre-trained models.
2724

28-
Stable (not preview) model versions are deprecated six months after the release of another stable model version. Features in preview don't maintain a minimum retirement period and may be deprecated at any time.
25+
We regularly update the language service with new model versions to improve model accuracy, support, and quality.
2926

27+
By default, all API requests will use the latest Generally Available (GA) model.
3028

3129
#### Choose the model-version used on your data
3230

33-
By default, API requests will use the latest Generally Available model. You can use an optional parameter to select the version of the model to be used (not recommended).
34-
35-
> [!TIP]
36-
> If you’re using the SDK for C#, Java, JavaScript or Python, see the reference documentation for information on the appropriate model-version parameter.
31+
We recommend using the `latest` model version to utilize the latest and highest quality models. As our models improve, it’s possible that some of your model results may change.
3732

38-
For synchronous endpoints, use the `model-version` query parameter. For example:
33+
Preview models used for preview features do not maintain a minimum retirement period and may be deprecated at any time.
3934

40-
`POST <your-language-resource-endpoint>/language/:analyze-text?api-version=2022-05-01&model-version=2022-06-01`.
41-
42-
For asynchronous endpoints, use the `model-version` property in the request body under task properties.
43-
44-
The model-version used in your API request will be included in the response object.
35+
By default, API and SDK requests will use the latest Generally Available model. You can use an optional parameter to select the version of the model to be used (not recommended).
4536

4637
> [!NOTE]
4738
> If you are using an model version that is not listed in the table, then it was subjected to the expiration policy.
4839
4940
Use the table below to find which model versions are supported by each feature:
5041

51-
52-
| Feature | Supported versions | Model versions to be deprecated |
42+
| Feature | Supported versions | Model versions to be deprecated October 30, 2022|
5343
|-----------------------------------------------------|-----------------------------|------------------------|
5444
| Sentiment Analysis and opinion mining | `2021-10-01`, `2022-06-01*` | `2019-10-01`, `2020-04-01` |
5545
| Language Detection | `2021-11-20*` | `2019-10-01`, `2020-07-01`, `2020-09-01`, `2021-01-05` |

0 commit comments

Comments
 (0)