Skip to content

Commit 83467b0

Browse files
Merge pull request #4850 from sdgilley/sdg-release-dan-qs
rearrange sections and remove SDK
2 parents d6e725d + e56c9ab commit 83467b0

File tree

5 files changed

+33
-31
lines changed

5 files changed

+33
-31
lines changed

articles/ai-foundry/includes/get-started-fdp.md

Lines changed: 30 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -30,13 +30,34 @@ The Azure AI Foundry SDK is available in multiple languages, including Python, J
3030
- An [Azure subscription](https://azure.microsoft.com/free/). If you don't have an Azure subscription, create a free account before you begin.
3131
- You must be **Owner** of the subscription to receive the appropriate access control needed to use your project.
3232

33+
34+
35+
## Create a [!INCLUDE [fdp-project-name](fdp-project-name.md)]
36+
37+
1. Sign in to the [Azure AI Foundry portal](https://ai.azure.com).
38+
1. On the home page, select **Create the future**. This creates a project and also include steps to start working with a basic Agent.
39+
40+
:::image type="content" source="../media/quickstarts/start-building.png" alt-text="Screenshot shows how to start building an Agent in Azure AI Foundry portal.":::
41+
42+
1. Fill in a name for your project and select **Create**.
43+
44+
## Deploy a model
45+
46+
[!INCLUDE [tip-left-pane](../includes/tip-left-pane.md)]
47+
48+
1. If you just used the Azure AI Foundry portal to create the project with the **Create the future** link, you're next prompted to deploy a model.
49+
1. Or else, sign in to the [Azure AI Foundry portal](https://ai.azure.com), select your project, and select **Model catalog**.
50+
1. Search for the model you want to deploy. For this quickstart, select **gpt-4o**.
51+
1. Select **Confirm**.
52+
1. Don't change the default settings. Select **Deploy**.
53+
3354
### Set up your environment
3455

3556
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
3657

3758
No installation is necessary to use the Azure AI Foundry portal.
3859

39-
# [Python SDK](#tab/python)
60+
# [Python](#tab/python)
4061

4162
1. [Install Python and Azure CLI](../how-to/develop/install-cli-sdk.md?pivots=programming-language-python)
4263
1. Install these packages:
@@ -95,29 +116,10 @@ No installation is necessary to use the Azure AI Foundry portal.
95116
96117
---
97118
98-
## Create a [!INCLUDE [fdp-project-name](fdp-project-name.md)]
99-
100-
Use either the Azure AI Foundry portal or Azure CLI to create a project.
101-
102-
1. Sign in to the [Azure AI Foundry portal](https://ai.azure.com).
103-
1. On the home page, select **Create the future**. This creates a project and also include steps to start working with a basic Agent.
104-
105-
:::image type="content" source="../media/quickstarts/start-building.png" alt-text="Screenshot shows how to start building an Agent in Azure AI Foundry portal.":::
106-
107-
1. Fill in a name for your project and select **Create**.
108-
109-
## Deploy a model
110-
111-
[!INCLUDE [tip-left-pane](../includes/tip-left-pane.md)]
112-
113-
1. If you just used the Azure AI Foundry portal to create the project with the **Create the future** link, you're next prompted to deploy a model.
114-
1. Or else, sign in to the [Azure AI Foundry portal](https://ai.azure.com), select your project, and select **Model catalog**.
115-
1. Search for the model you want to deploy. For this quickstart, select **gpt-4o**.
116-
1. Select **Confirm**.
117-
1. Don't change the default settings. Select **Deploy**.
118-
119119
## Run a chat completion
120120
121+
Chat completions are the basic building block of AI applications. Using chat completions you can send a list of messages and get a response.
122+
121123
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
122124
123125
1. If you used **Create the future** to create the project, you'll now find yourself in the Agents playground, ready to try it out. You'll come back here in a moment, but first let's play with the model.
@@ -126,7 +128,7 @@ Use either the Azure AI Foundry portal or Azure CLI to create a project.
126128
1. Fill in the prompt and select the **Send** button.
127129
1. The model returns a response in the **Response** pane.
128130
129-
# [Python SDK](#tab/python)
131+
# [Python](#tab/python)
130132
131133
Substitute your value for the endpoint in this code:
132134
@@ -150,6 +152,8 @@ Substitute your value for the endpoint in this code:
150152
151153
## Create and run an agent
152154
155+
Agents allow more powerful capabilities through the use of tools. First, let's write the same chat completion code using agents.
156+
153157
# [Azure AI Foundry portal](#tab/azure-ai-foundry)
154158
155159
1. In your project, on the left pane, select **Agents**.
@@ -160,7 +164,7 @@ Substitute your value for the endpoint in this code:
160164
1. At the top of the **Setup** pane, select **Try in playground**.
161165
1. Start chatting with your agent, for example, "Write me a poem about flowers"
162166
163-
# [Python SDK](#tab/python)
167+
# [Python](#tab/python)
164168
165169
:::code language="python" source="~/foundry-samples/samples/microsoft/python/mslearn-resources/quickstart/quickstart.py" id="create_and_run_agent":::
166170
@@ -180,8 +184,7 @@ Substitute your value for the endpoint in this code:
180184
181185
## Add files to the agent
182186
183-
184-
Enable your agent to search and retrieve information from a provided file.
187+
Now let's add a file search tool that enables us to do knowledge retrieval.
185188
186189
* Download [product_info_1.md](https://github.com/azure-ai-foundry/foundry-samples/blob/main/samples/microsoft/data/product_info_1.md) to give to your agent.
187190
@@ -197,7 +200,7 @@ Enable your agent to search and retrieve information from a provided file.
197200
1. Ask a question, such as, "Hello, what Contoso products do you know?"
198201
1. To add more files, select the **...** on the AgentVectorStore, then select **Manage**.
199202
200-
# [Python SDK](#tab/python)
203+
# [Python](#tab/python)
201204
202205
:::code language="python" source="~/foundry-samples/samples/microsoft/python/mslearn-resources/quickstart/quickstart.py" id="create_filesearch_agent":::
203206

articles/ai-foundry/includes/sdk/csharp.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,6 @@ ms.custom: include
1616
| --- | --- | --- |
1717
| ![Speech icon](~/reusable-content/ce-skilling/azure/media/ai-services/speech.svg) [Speech](../../../ai-services/speech-service/index.yml) | Add speech to text, text to speech, translation, and speaker recognition capabilities to applications. | &bullet;&NonBreakingSpace;[Speech SDK for .NET](/dotnet/api/microsoft.cognitiveservices.speech?view=azure-dotnet&branch=main&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Speech NuGet package (Speech CLI)](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech.CLI)|
1818
| ![Content Safety icon](~/reusable-content/ce-skilling/azure/media/ai-services/content-safety.svg) [Content Safety](../../../ai-services/content-safety/index.yml) | Detect harmful content in applications and services.| &bullet;&NonBreakingSpace;[Content Safety SDK for .NET](/dotnet/api/overview/azure/ai.contentsafety-readme?view=azure-dotnet&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Content Safety NuGet package](https://www.nuget.org/packages/Azure.AI.ContentSafety/1.0.0) |
19-
![Custom Vision icon](~/reusable-content/ce-skilling/azure/media/ai-services/custom-vision.svg) [Custom Vision](../../../ai-services/custom-vision-service/index.yml) | Customize image recognition for your applications and models. | &bullet;&NonBreakingSpace;[Custom Vision SDK for .NET](/dotnet/api/overview/azure/custom-vision?view=azure-dotnet&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Custom Vision NuGet package (prediction)](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Vision.CustomVision.Prediction)<br><br>&bullet;&NonBreakingSpace;[Custom Vision NuGet package (training)](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Vision.CustomVision.Training)|
2019
| ![Vision icon](~/reusable-content/ce-skilling/azure/media/ai-services/vision.svg) [Vision](../../../ai-services/computer-vision/index.yml) | Analyze content in digital images and rich media assets.| &bullet;&NonBreakingSpace;[Vision SDK for .NET](/dotnet/api/overview/azure/AI.Vision.ImageAnalysis-readme?view=azure-dotnet-preview&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Vision NuGet package](https://www.nuget.org/packages/Azure.AI.Vision.ImageAnalysis) |
2120
| ![Language icon](~/reusable-content/ce-skilling/azure/media/ai-services/language.svg) [Language](../../../ai-services/language-service/index.yml) | Build applications with natural language understanding capabilities. | &bullet;&NonBreakingSpace;[Language SDK for .NET (text analysis)](/dotnet/api/overview/azure/ai.textanalytics-readme?view=azure-dotnet&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Language NuGet package (text analysis)](https://www.nuget.org/packages/Azure.AI.TextAnalytics)<br><br>&bullet;&NonBreakingSpace;[Language SDK for .NET (Question Answering)](/dotnet/api/overview/azure/ai.language.questionanswering-readme?view=azure-dotnet&preserve-view=true)<br><br>&bullet;&NonBreakingSpace;[Language NuGet package (question answering)](https://www.nuget.org/packages/Azure.AI.Language.QuestionAnswering) |
2221
| ![Translator icon](~/reusable-content/ce-skilling/azure/media/ai-services/translator.svg) [Translator](../../../ai-services/translator/index.yml) | Use AI-powered translation technology to translate more than 100 in-use, at-risk, and endangered languages and dialects. | &bullet;&NonBreakingSpace;[Translator SDK for .NET (text)](/dotnet/api/overview/azure/ai.translation.text-readme?view=azure-dotnet-preview&preserve-view=true)<br><br>&bullet;&NonBreakingSpace;[Translator NuGet package (text)](https://www.nuget.org/packages/Azure.AI.Translation.Text/1.0.0-beta.1)<br><br>&bullet;&NonBreakingSpace;[Translator SDK for .NET (batch)](/dotnet/api/overview/azure/AI.Translation.Document-readme?view=azure-dotnet&preserve-view=true)<br><br>&bullet;&NonBreakingSpace;[Translator NuGet package (batch)](https://www.nuget.org/packages/Azure.AI.Translation.Document) |

articles/ai-foundry/includes/sdk/java.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ ms.custom: include
1616
| --- | --- | --- |
1717
| ![Speech icon](~/reusable-content/ce-skilling/azure/media/ai-services/speech.svg) [Speech](../../../ai-services/speech-service/index.yml) | Add speech to text, text to speech, translation, and speaker recognition capabilities to applications. | &bullet;&NonBreakingSpace;[Speech SDK for Java](/java/api/com.microsoft.cognitiveservices.speech?view=azure-java-stable&branch=main&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Speech Maven package](https://central.sonatype.com/artifact/com.microsoft.cognitiveservices.speech/client-sdk/1.34.0?smo=true)|
1818
| ![Content Safety icon](~/reusable-content/ce-skilling/azure/media/ai-services/content-safety.svg) [Content Safety](../../../ai-services/content-safety/index.yml) | Detect harmful content in applications and services.| &bullet;&NonBreakingSpace;[Content Safety SDK for Java](/java/api/overview/azure/ai-contentsafety-readme?view=azure-java-stable&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Content Safety Maven package](https://central.sonatype.com/artifact/com.azure/azure-ai-contentsafety) |
19-
| ![Custom Vision icon](~/reusable-content/ce-skilling/azure/media/ai-services/custom-vision.svg) [Custom Vision](../../../ai-services/custom-vision-service/index.yml) | Customize image recognition for your applications and models. |&bullet;&NonBreakingSpace;[Custom Vision SDK for Java (prediction)](/java/api/com.microsoft.azure.cognitiveservices.vision.customvision.prediction?view=azure-java-stable&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Custom Vision SDK for Java (training)](/java/api/com.microsoft.azure.cognitiveservices.vision.customvision.training?view=azure-java-stable&preserve-view=true)<br><br>&bullet;&NonBreakingSpace;[Custom Vision Maven package (prediction)](https://central.sonatype.com/artifact/com.azure/azure-cognitiveservices-customvision-prediction)<br><br>&bullet;&NonBreakingSpace;[Custom Vision Maven package (training)](https://central.sonatype.com/artifact/com.azure/azure-cognitiveservices-customvision-training) |
19+
| ![Vision icon](~/reusable-content/ce-skilling/azure/media/ai-services/vision.svg) [Vision]../../../ai-services/computer-vision/index.yml) | Analyze content in digital images and rich media assets.|&bullet;&NonBreakingSpace;[Vision SDK for Java](/java/api/overview/azure/ai-vision-imageanalysis-readme?view=azure-java-preview&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Vision Maven package](https://central.sonatype.com/artifact/com.azure/azure-ai-vision-imageanalysis) |
2020
| ![Language icon](~/reusable-content/ce-skilling/azure/media/ai-services/language.svg) [Language](../../../ai-services/language-service/index.yml) | Build applications with natural language understanding capabilities. | &bullet;&NonBreakingSpace;[Language SDK for Java (text analysis)](/java/api/overview/azure/ai-textanalytics-readme?view=azure-java-stable&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Language Maven package](https://central.sonatype.com/artifact/com.microsoft.azure.cognitiveservices/azure-cognitiveservices-language) |
2121
| ![Translator icon](~/reusable-content/ce-skilling/azure/media/ai-services/translator.svg) [Translator](../../../ai-services/translator/index.yml) | Use AI-powered translation technology to translate more than 100 in-use, at-risk, and endangered languages and dialects. | &bullet;&NonBreakingSpace;[Translator SDK for Java (text)](/java/api/overview/azure/ai-translation-text-readme?view=azure-java-preview&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Translator Maven package (text)](https://central.sonatype.com/artifact/com.azure/azure-ai-translation-text) |
2222
| ![Document Intelligence icon](~/reusable-content/ce-skilling/azure/media/ai-services/document-intelligence.svg) [Document Intelligence](../../../ai-services/document-intelligence/index.yml) | Turn documents into intelligent data-driven solutions. | &bullet;&NonBreakingSpace;[Document Intelligence SDK for Java](/java/api/overview/azure/ai-documentintelligence-readme?view=azure-java-preview&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Document Intelligence Maven package](https://mvnrepository.com/artifact/com.azure/azure-ai-documentintelligence/1.0.0-beta.1) |

articles/ai-foundry/includes/sdk/javascript.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ ms.custom: include
1616
| --- | --- | --- |
1717
| ![Speech icon](~/reusable-content/ce-skilling/azure/media/ai-services/speech.svg) [Speech](../../../ai-services/speech-service/index.yml) | Add speech to text, text to speech, translation, and speaker recognition capabilities to applications. | &bullet;&NonBreakingSpace;[Speech SDK for JavaScript](/javascript/api/microsoft-cognitiveservices-speech-sdk/?view=azure-node-latest&branch=main&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Speech npm package](https://www.npmjs.com/package/microsoft-cognitiveservices-speech-sdk)|
1818
| ![Content Safety icon](~/reusable-content/ce-skilling/azure/media/ai-services/content-safety.svg) [Content Safety](../../../ai-services/content-safety/index.yml) | Detect harmful content in applications and services.| &bullet;&NonBreakingSpace;[Content Safety SDK for JavaScript](/javascript/api/%40azure-rest/ai-content-safety/?view=azure-node-latest&preserve-view=true)<br><br>&bullet;&NonBreakingSpace;[Content Safety npm package](https://www.npmjs.com/package/@azure-rest/ai-content-safety/v/1.0.0-beta.1) |
19-
| ![Custom Vision icon](~/reusable-content/ce-skilling/azure/media/ai-services/custom-vision.svg) [Custom Vision](../../../ai-services/custom-vision-service/index.yml) | Customize image recognition for your applications and models. |&bullet;&NonBreakingSpace;[Custom Vision SDK for JavaScript (prediction)](/javascript/api/%40azure/cognitiveservices-customvision-prediction/?view=azure-node-latest&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Custom Vision npm package (prediction)](https://www.npmjs.com/package/@azure/cognitiveservices-customvision-prediction) <br><br>&bullet;&NonBreakingSpace;[Custom Vision SDK for JavaScript (training)](/javascript/api/%40azure/cognitiveservices-customvision-training/?view=azure-node-latest&preserve-view=true)<br><br>&bullet;&NonBreakingSpace;[Custom Vision npm package (training)](https://www.npmjs.com/package/@azure/cognitiveservices-customvision-training) |
19+
| ![Vision icon](~/reusable-content/ce-skilling/azure/media/ai-services/vision.svg) [Vision](../../../ai-services/computer-vision/index.yml) | Analyze content in digital images and rich media assets.|&bullet;&NonBreakingSpace;[Vision SDK for JavaScript](/javascript/api/overview/azure/ai-vision-image-analysis-rest-readme?view=azure-node-preview&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Vision npm package](https://www.npmjs.com/package/@azure-rest/ai-vision-image-analysis/v/1.0.0-beta.2) |
2020
| ![Language icon](~/reusable-content/ce-skilling/azure/media/ai-services/language.svg) [Language](../../../ai-services/language-service/index.yml) | Build applications with natural language understanding capabilities. | &bullet;&NonBreakingSpace;[Language SDK for JavaScript (text analysis)](/javascript/api/overview/azure/ai-language-text-readme?view=azure-node-latest&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Language npm package](https://www.npmjs.com/package/@azure/ai-language-text) |
2121
| ![Translator icon](~/reusable-content/ce-skilling/azure/media/ai-services/translator.svg) [Translator](../../../ai-services/translator/index.yml) | Use AI-powered translation technology to translate more than 100 in-use, at-risk, and endangered languages and dialects. | &bullet;&NonBreakingSpace;[Translator SDK for JavaScript (text)](/javascript/api/overview/azure/text-translation?view=azure-node-preview&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Translator npm package (text)](https://www.npmjs.com/package/@azure-rest/ai-translation-text/v/1.0.0-beta.1) |
2222
| ![Document Intelligence icon](~/reusable-content/ce-skilling/azure/media/ai-services/document-intelligence.svg) [Document Intelligence](../../../ai-services/document-intelligence/index.yml) | Turn documents into intelligent data-driven solutions. | &bullet;&NonBreakingSpace;[Document Intelligence SDK for JavaScript](/javascript/api/overview/azure/ai-document-intelligence-rest-readme?view=azure-node-preview&preserve-view=true) <br><br>&bullet;&NonBreakingSpace;[Document Intelligence npm package](https://www.npmjs.com/package/@azure-rest/ai-document-intelligence/v/1.0.0-beta.1) |

0 commit comments

Comments
 (0)