Skip to content

Commit ab8bdb7

Browse files
committed
update
1 parent f4671ee commit ab8bdb7

13 files changed

+34
-240
lines changed

articles/ai-services/openai/concepts/fine-tuning-considerations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: Learn more about what you should take into consideration before fin
44
manager: nitinme
55
ms.service: azure-ai-openai
66
ms.topic: conceptual
7-
ms.date: 08/29/2024
7+
ms.date: 03/26/2025
88
author: mrbullwinkle
99
ms.author: mbullwin
1010
recommendations: false

articles/ai-services/openai/concepts/prompt-engineering.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ titleSuffix: Azure OpenAI
44
description: Learn how to use prompt engineering to optimize your work with Azure OpenAI Service.
55
ms.service: azure-ai-openai
66
ms.topic: conceptual
7-
ms.date: 08/29/2024
7+
ms.date: 03/26/2025
88
ms.custom: references_regions, build-2023, build-2023-dataai
99
manager: nitinme
1010
author: mrbullwinkle
@@ -14,7 +14,7 @@ recommendations: false
1414

1515
# Prompt engineering techniques
1616

17-
GPT-3, GPT-3.5, GPT-4, and GPT-4o models from OpenAI are prompt-based. With prompt-based models, the user interacts with the model by entering a text prompt, to which the model responds with a text completion. This completion is the model’s continuation of the input text.
17+
GPT-3, GPT-3.5, GPT-4, and GPT-4o models from OpenAI are prompt-based. With prompt-based models, the user interacts with the model by entering a text prompt, to which the model responds with a text completion. This completion is the model’s continuation of the input text. These techniques are note recommended for o-series models.
1818

1919
While these models are extremely powerful, their behavior is also very sensitive to the prompt. This makes prompt construction an important skill to develop.
2020

articles/ai-services/openai/concepts/provisioned-throughput.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Azure OpenAI Service provisioned throughput
33
description: Learn about provisioned throughput and Azure OpenAI.
44
ms.service: azure-ai-openai
55
ms.topic: conceptual
6-
ms.date: 08/07/2024
6+
ms.date: 03/26/2025
77
manager: nitinme
88
author: mrbullwinkle #ChrisHMSFT
99
ms.author: mbullwin #chrhoder

articles/ai-services/openai/how-to/completions.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how to generate or manipulate text, including code by using t
55
manager: nitinme
66
ms.service: azure-ai-openai
77
ms.topic: how-to
8-
ms.date: 08/29/2024
8+
ms.date: 03/26/2025
99
author: mrbullwinkle
1010
ms.author: mbullwin
1111
recommendations: false
@@ -17,7 +17,7 @@ recommendations: false
1717
Azure OpenAI Service provides a **completion endpoint** that can be used for a wide variety of tasks. The endpoint supplies a simple yet powerful text-in, text-out interface to any [Azure OpenAI model](../concepts/models.md). To trigger the completion, you input some text as a prompt. The model generates the completion and attempts to match your context or pattern. Suppose you provide the prompt "As Descartes said, I think, therefore" to the API. For this prompt, Azure OpenAI returns the completion endpoint " I am" with high probability.
1818

1919
> [!IMPORTANT]
20-
> Unless you have a specific use case that requires the completions endpoint, we recommend instead using the [chat completions endpoint](./chatgpt.md) which allows you to take advantage of the latest models like GPT-4o, GPT-4o mini, and GPT-4 Turbo.
20+
> Unless you have a specific use case that requires the completions endpoint, we recommend instead using the [responses API](./responses.md) of [chat completions endpoint](./chatgpt.md) which allows you to take advantage of the latest models like GPT-4o, GPT-4o mini, and GPT-4 Turbo.
2121
2222
The best way to start exploring completions is through the playground in [Azure AI Foundry](https://ai.azure.com). It's a simple text box where you enter a prompt to generate a completion. You can start with a simple prompt like this one:
2323

@@ -36,7 +36,7 @@ The completion results that you see can differ because the Azure OpenAI API prod
3636
The simple text-in, text-out interface means you can "program" the Azure OpenAI model by providing instructions or just a few examples of what you'd like it to do. The output success generally depends on the complexity of the task and quality of your prompt. A general rule is to think about how you would write a word problem for a pre-teenage student to solve. A well-written prompt provides enough information for the model to know what you want and how it should respond.
3737

3838
> [!NOTE]
39-
> The model training data can be different for each model type. The [latest model's training data currently extends through September 2021 only](/azure/ai-services/openai/concepts/models). Depending on your prompt, the model might not have knowledge of related current events.
39+
> The model training data can be different for each model type. Depending on your prompt, the model might not have knowledge of related current events.
4040
4141
## Design prompts
4242

articles/ai-services/openai/how-to/embeddings.md

Lines changed: 3 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ manager: nitinme
66
ms.service: azure-ai-openai
77
ms.custom: devx-track-python
88
ms.topic: how-to
9-
ms.date: 08/29/2024
9+
ms.date: 03/26/2025
1010
author: mrbullwinkle
1111
ms.author: mbullwin
1212
recommendations: false
@@ -21,7 +21,7 @@ To obtain an embedding vector for a piece of text, we make a request to the embe
2121

2222
# [console](#tab/console)
2323
```console
24-
curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings?api-version=2024-02-01\
24+
curl https://YOUR_RESOURCE_NAME.openai.azure.com/openai/deployments/YOUR_DEPLOYMENT_NAME/embeddings?api-version=2024-10-21\
2525
-H 'Content-Type: application/json' \
2626
-H 'api-key: YOUR_API_KEY' \
2727
-d '{"input": "Sample Document goes here"}'
@@ -35,7 +35,7 @@ from openai import AzureOpenAI
3535

3636
client = AzureOpenAI(
3737
api_key = os.getenv("AZURE_OPENAI_API_KEY"),
38-
api_version = "2024-06-01",
38+
api_version = "2024-10-21",
3939
azure_endpoint =os.getenv("AZURE_OPENAI_ENDPOINT")
4040
)
4141

@@ -47,26 +47,6 @@ response = client.embeddings.create(
4747
print(response.model_dump_json(indent=2))
4848
```
4949

50-
# [OpenAI Python 0.28.1](#tab/python)
51-
52-
[!INCLUDE [Deprecation](../includes/deprecation.md)]
53-
54-
```python
55-
import openai
56-
57-
openai.api_type = "azure"
58-
openai.api_key = "YOUR_API_KEY"
59-
openai.api_base = "https://YOUR_RESOURCE_NAME.openai.azure.com"
60-
openai.api_version = "2024-06-01"
61-
62-
response = openai.Embedding.create(
63-
input="Your text string goes here",
64-
engine="YOUR_DEPLOYMENT_NAME"
65-
)
66-
embeddings = response['data'][0]['embedding']
67-
print(embeddings)
68-
```
69-
7050
# [C#](#tab/csharp)
7151
```csharp
7252
using Azure;

articles/ai-services/openai/how-to/json-mode.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ services: cognitive-services
66
manager: nitinme
77
ms.service: azure-ai-openai
88
ms.topic: how-to
9-
ms.date: 08/29/2024
9+
ms.date: 03/26/2025
1010
author: mrbullwinkle
1111
ms.author: mbullwin
1212
recommendations: false
@@ -51,7 +51,7 @@ from openai import AzureOpenAI
5151
client = AzureOpenAI(
5252
azure_endpoint = os.getenv("AZURE_OPENAI_ENDPOINT"),
5353
api_key=os.getenv("AZURE_OPENAI_API_KEY"),
54-
api_version="2024-03-01-preview"
54+
api_version="2025-03-01-preview"
5555
)
5656

5757
response = client.chat.completions.create(

articles/ai-services/openai/how-to/monitor-openai.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Monitor Azure OpenAI Service
33
description: Start here to learn how to use Azure Monitor tools like Log Analytics to capture and analyze metrics and data logs for your Azure OpenAI Service.
4-
ms.date: 08/20/2024
4+
ms.date: 03/26/2025
55
ms.custom: horz-monitor, subject-monitoring
66
ms.topic: conceptual
77
author: mrbullwinkle

articles/ai-services/openai/how-to/working-with-models.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ titleSuffix: Azure OpenAI
44
description: Learn about managing model deployment life cycle, updates, & retirement.
55
ms.service: azure-ai-openai
66
ms.topic: conceptual
7-
ms.date: 08/29/2024
7+
ms.date: 03/26/2025
88
ms.custom: references_regions, build-2023, build-2023-dataai, devx-track-azurepowershell
99
manager: nitinme
1010
author: mrbullwinkle #ChrisHMSFT

0 commit comments

Comments
 (0)