|
1 | 1 | ---
|
2 |
| -title: Azure AI Studio model lifecycle and retirement |
3 |
| -titleSuffix: Azure AI Studio |
4 |
| -description: Learn about the lifecycle stages and retirement for models in Azure AI Studio. |
| 2 | +title: Deprecation and retirement for models in Azure AI model catalog |
| 3 | +titleSuffix: Azure AI Foundry |
| 4 | +description: Learn about the lifecycle stages, deprecation, and retirement for models in the Azure AI model catalog. |
5 | 5 | manager: scottpolly
|
6 | 6 | ms.service: azure-ai-studio
|
7 | 7 | ms.topic: concept-article
|
8 |
| -ms.date: 10/08/2024 |
9 |
| -ms.custom: ignite-2024 |
| 8 | +ms.date: 11/21/2024 |
10 | 9 | ms.author: mopeakande
|
11 | 10 | author: msakande
|
12 | 11 | ms.reviewer: mabables
|
13 | 12 | reviewer: ManojBableshwar
|
14 | 13 |
|
15 | 14 | ---
|
16 | 15 |
|
17 |
| -# Azure AI Studio model lifecycle and retirement |
| 16 | +# Model deprecation and retirement in Azure AI model catalog |
18 | 17 |
|
19 |
| -Models that are available in Azure AI Studio through the model catalog are continually refreshed with newer and more capable models. As part of this process, models can move through stages as we deprecate and retire older models. This document provides information about the models, their stages, and what the models stages mean for you as a customer. |
| 18 | +Models in the model catalog are continually refreshed with newer and more capable models. As part of this process, model providers might deprecate and retire their older models, and you might need to update your applications to use a newer model. This document communicates information about the model lifecycle and deprecation timelines and explains how you're informed of model lifecycle stages. |
20 | 19 |
|
21 |
| -Every models in the model catalog belongs to one of these stages: |
| 20 | +Models in the model catalog belong to one of these stages: |
22 | 21 |
|
23 | 22 | - Preview
|
24 |
| -- General availability |
| 23 | +- Generally available |
25 | 24 | - Legacy
|
26 | 25 | - Deprecated
|
27 | 26 | - Retired
|
28 | 27 |
|
29 |
| -## Preview |
| 28 | +> [!NOTE] |
| 29 | +> This article describes deprecation and retirement only for models that can be deployed to serverless APIs, not managed compute. To learn more about the differences between deployment to serverless APIs and managed computes, see [Model catalog and collections in Azure AI Foundry portal](../how-to/model-catalog-overview.md). |
| 30 | +> |
| 31 | +> Azure OpenAI models in the model catalog are provided through Azure OpenAI Service. For information about Azure Open AI model deprecation and retirement, see the [Azure OpenAI service product documentation](/azure/ai-services/openai/concepts/model-retirements). |
30 | 32 |
|
31 |
| -New models are launched in preview stage if model weights, such as quantized or optimized weights, or APIs such as tool support will change in the future. This stage is optional, as new models can be launched in the general availability stage. For a model in the preview stage: |
32 | 33 |
|
33 |
| -- The model page in AI Studio includes a _Preview_ tag. |
34 |
| -- The model info API returns _Preview_. |
| 34 | +## Preview |
35 | 35 |
|
36 |
| -## General availability |
| 36 | +Models labeled _Preview_ are experimental in nature. A model's weights, runtime, and API schema can change while the model is in preview. Models in preview aren't guaranteed to become generally available. Models in preview have a _Preview_ label next to their name in the model catalog. |
37 | 37 |
|
38 |
| -General availability (GA) is the default model stage. A model can be launched in the GA stage without going through preview if there are no plans to upgrade its weights or APIs. Once the model is GA, no breaking changes, such as API changes or weight updates are allowed. However, container updates that address security or vulnerability issues are allowed, provided that they don't change model quality or outputs. The only way to improve this model is by providing a new model and deprecating the existing model. For a model in the GA stage: |
| 38 | +## Generally available |
39 | 39 |
|
40 |
| -- The model page in AI Studio doesn't have a preview tag. |
41 |
| -- The model info API returns _GA_. |
| 40 | +This stage is the default model stage. Models that don't include a lifecycle label next to their name are generally available and suitable for use in production environments. In this stage, model weights and APIs are fixed. However, model containers or runtimes with vulnerabilities might get patched, but patches won't affect model outputs. |
42 | 41 |
|
43 | 42 | ## Legacy
|
44 | 43 |
|
45 |
| -A model in the legacy stage (or soft deprecation stage) is on the path for deprecation because a new is available that provides better quality, performance, or price. We encourage you to start trying the new model, but you can still create new deployments and fine-tuned versions of the legacy model. For a model in the legacy stage: |
46 |
| - |
47 |
| -- The model page in AI Studio includes a _Legacy_ tag. |
48 |
| -- The model info API returns _Legacy_. |
49 |
| -- Documentation pages for the model and email notifications provide information about suggested new model to use, legacy date, planned deprecation date, and planned retirement date. |
| 44 | +Models labeled _Legacy_ are intended for deprecation. You should plan to move to a different model, such as a new, improved model that might be available in the same model family. While a model is in the legacy stage, existing deployments of the model continue to work, and you can create new deployments of the model until the deprecation date. |
50 | 45 |
|
51 | 46 | ## Deprecated
|
52 | 47 |
|
53 |
| -Once a model is deprecated, you can't create new deployments for the model, you can't submit finetuning jobs, and you can't deploy a finetuned version of the model. However, existing deployments and fine-tuned endpoints will continue to work until the model is retired. For a deprecated model: |
54 |
| - |
55 |
| -- The model page in AI Studio includes a _Deprecated_ tag. |
56 |
| -- The model info API returns _Deprecated_. |
57 |
| -- Documentation pages for the model and email notifications provide information about suggested new model to use, legacy date, deprecation date, and planned retirement date. |
| 48 | +Models labeled _Deprecated_ are no longer available for new deployments. You can't create any new deployments for the model; however, existing deployments continue to work until the retirement date. |
58 | 49 |
|
59 | 50 | ## Retired
|
60 | 51 |
|
61 |
| -Once a model is retired, existing deployments — both the base model and inference — stop working. For a retired model: |
62 |
| - |
63 |
| -- The model page in AI Studio includes a _Retired_ tag. |
64 |
| -- The model info API returns no longer works. |
65 |
| -- Documentation pages for the model and email notifications provide information about suggested new model to use, legacy date, deprecation date, and retirement date. |
66 |
| - |
67 |
| - |
68 |
| ------------------------------------ |
| 52 | +Models labeled _Retired_ are no longer available for use. You can't create new deployments, and attempts to use existing deployments return `<return code>` errors. |
69 | 53 |
|
70 | 54 |
|
71 | 55 | ## Notifications
|
72 | 56 |
|
| 57 | +- Models are labeled as _Legacy_ and remain in the legacy state for at least 30 days before being moved to the deprecated state. During this notification period, you may create new deployments as you prepare for deprecation and retirement. |
73 | 58 |
|
74 |
| -## Model availability |
75 |
| - |
76 |
| - |
77 |
| -### Considerations for the Azure public cloud |
78 |
| - |
79 |
| - |
80 |
| -### Special considerations for Azure Government clouds |
81 |
| - |
82 |
| - |
83 |
| -### Who is notified of upcoming retirements |
84 |
| - |
85 |
| - |
86 |
| -## How to get ready for model retirements and version upgrades |
87 |
| - |
88 |
| - |
89 |
| -## Current models |
90 |
| - |
91 |
| -for a list of models that are currently available for use in Azure AI Studio, see [Model deployment: Managed compute and serverless API (pay-as-you-go)](../how-to/model-catalog-overview.md#model-deployment-managed-compute-and-serverless-api-pay-as-you-go). |
92 |
| - |
93 |
| -| Model | Version | Retirement date | Suggested replacements | |
94 |
| -| ---- | ---- | ---- | --- | |
95 |
| -| `<model>`| 2 | January 27, 2025 | `<replacement>` | |
96 |
| - |
97 |
| - |
98 |
| - |
99 |
| -## Default model versions |
100 |
| - |
101 |
| - |
102 |
| - |
103 |
| -## Deprecated models |
104 |
| - |
| 59 | +- Models are labeled _Deprecated_ and remain in the deprecated state for at least 90 days before being moved to the retired state. During this notification period, you can migrate any existing deployments to newer or replacement models. |
105 | 60 |
|
| 61 | +- Members of <x, y, and z> roles for each Azure subscription with a serverless API model deployment receive a notification when a model deprecation is announced. The notification contains the dates when the model enters legacy, deprecated, and retired states. The notification might provide information about possible replacement model options, if applicable. |
106 | 62 |
|
107 |
| -## Retirement and deprecation history |
108 | 63 |
|
109 | 64 |
|
| 65 | +| Model provider | Model | Legacy date | Deprecation date | Retirement date | Suggested replacement model | |
| 66 | +| ---- | ---- | ---- | --- | ---- | --- | |
| 67 | +| Provider | `<model>` | January 27, 2025 | January 27, 2025 | January 27, 2025 | `<replacement>` | |
110 | 68 |
|
| 69 | +## Related content |
111 | 70 |
|
| 71 | +- [Model catalog and collections in Azure AI Foundry portal](../how-to/model-catalog-overview.md) |
| 72 | +- [Data, privacy, and security for use of models through the model catalog in AI Foundry portal](../how-to/concept-data-privacy.md) |
0 commit comments