Skip to content

Commit 14202e8

Browse files
authored
Merge pull request #2140 from MicrosoftDocs/main
1/1/2025 AM Publish
2 parents f0e83bb + 9248d9d commit 14202e8

File tree

1 file changed

+22
-21
lines changed

1 file changed

+22
-21
lines changed

articles/ai-studio/tutorials/screen-reader.md

Lines changed: 22 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -8,26 +8,26 @@ ms.custom:
88
- ignite-2023
99
- build-2024
1010
ms.topic: quickstart
11-
ms.date: 8/9/2024
11+
ms.date: 12/31/2024
1212
ms.reviewer: ailsaleen
1313
ms.author: sgilley
1414
author: sdgilley
1515
---
1616

1717
# QuickStart: Get started using Azure AI Foundry with a screen reader
1818

19-
This article is for people who use screen readers such as [Microsoft's Narrator](https://support.microsoft.com/windows/complete-guide-to-narrator-e4397a0d-ef4f-b386-d8ae-c172f109bdb1#WindowsVersion=Windows_11), JAWS, NVDA or Apple's Voiceover. In this quickstart, you'll be introduced to the basic structure of Azure AI Foundry and discover how to navigate around efficiently.
19+
This article is for people who use screen readers such as [Microsoft's Narrator](https://support.microsoft.com/windows/complete-guide-to-narrator-e4397a0d-ef4f-b386-d8ae-c172f109bdb1#WindowsVersion=Windows_11), JAWS, NVDA, or Apple's Voiceover. In this quickstart, you're introduced to the basic structure of Azure AI Foundry and discover how to navigate around efficiently.
2020

2121
## Getting oriented in Azure AI Foundry portal
2222

2323
Most Azure AI Foundry pages are composed of the following landmark structure:
2424

2525
- Banner (contains Azure AI Foundry app title, settings, and profile information)
2626
- Might sometimes contain a breadcrumb navigation element
27-
- Navigation
28-
- The contents of the navigation are different depending on whether you have selected a hub or project in the studio
29-
- Main page content
30-
- Usually contains a command toolbar
27+
- Navigation - There are three different states:
28+
- Outside a project - there's no left navigation until you are in a project. The page is divided into sections such as **Work outside of a project** and **Recent projects picker**.
29+
- In a project - the left navigation is the same for all parts of a project, until you move to the **Management center**.
30+
- The left navigation in the Management center has a section for the hub that the project is in, then a section for the project itself.
3131

3232
For efficient navigation, it might be helpful to navigate by landmarks to move between these sections on the page.
3333

@@ -36,9 +36,9 @@ For efficient navigation, it might be helpful to navigate by landmarks to move b
3636

3737
The navigation is list of links divided into different sections.
3838

39-
If you haven't yet created or selected a project, you can still explore content under the **Get started** (model catalog, model benchmarks, and AI Services) and **Management** (hubs and quota) sections.
39+
If you haven't yet created or selected a project, you can still explore content under the **Work outside of a project**.
4040

41-
Once you have created or selected a project, you can access more capabilities such as project playgrounds, tools (such as prompt flow and evaluation), and components (such as data and deployments).
41+
Once you have created or selected a project, you can access more capabilities such as Model catalog, Playgrounds, and AI Services. Then there are collapsible sections for **Build and customize** (includes Code, Fine-tuning, Prompt-flow), **Assess and improve** (includes Tracing, Evaluation, and Safety + security) and **My assets** (includes Models + endpoints, Data + indexes, and Web apps).
4242

4343
Once you have created or selected a project, you can also use the **Recent projects picker** button within the navigation to change project at any time.
4444

@@ -48,29 +48,29 @@ For more information about the navigation, see [What is Azure AI Foundry](../wha
4848

4949
To work within the Azure AI Foundry portal, you must first [create a project](../how-to/create-projects.md):
5050
1. In [Azure AI Foundry](https://ai.azure.com), select **Home** from the navigation.
51-
1. Press the **Tab** key until you hear *New project* and select this button.
52-
1. Enter the information requested in the **Create a project** dialog.
51+
1. Press the **Tab** key until you hear *Create project* and select this button.
52+
1. Enter the information requested in the **Create a project** dialog.
5353

54-
You then get taken to the project details page.
54+
You then get taken to the project overview page.
5555

5656
## Using the playground
5757

58-
The playground is where you can interact with models and experiment with different prompts and parameters. Different playgrounds are available depending on which model you would like to interact with.
58+
The playground is where you can interact with models and experiment with different prompts and parameters. Different playgrounds are available depending on which model you would like to interact with.
5959

60-
Once you have created or selected a project, go to the navigation landmark. Press the down arrow until you hear *Project playground*. Press the down arrow again until you hear a playground you would like to use.
60+
Once you have created or selected a project, go to the navigation landmark. Press the down arrow until you hear *Playgrounds*.
6161

6262
### Chat playground structure
6363

64-
In this mode, the playground is composed of the command toolbar and two main sections: one for configuring your system message and other parameters, and the other for chatting to the model. If you added your own data in the playground, the **Citations** pane also appears when selecting a citation as part of the model response.
64+
In this mode, the playground is composed of the command toolbar and two main sections: one for configuring your system message and other parameters, and the other for chatting to the model. If you added your own data in the playground, the **Add your data** pane also appears.
6565

6666
### Chat session pane
6767

6868
The chat session pane is where you can chat to the model and test out your assistant.
69-
- After you send a message, the model might take some time to respond, especially if the response is long. You hear a screen reader announcement "Message received from the chatbot" when the model finishes composing a response.
69+
- After you send a message, the model might take some time to respond, especially if the response is long. You hear a screen reader announcement "Message received from the chatbot" when the model finishes composing a response.
7070

7171
## Using prompt flow
7272

73-
Prompt flow is a tool to create executable flows, linking LLMs, prompts, and Python tools through a visualized graph. You can use this to prototype, experiment, and iterate on your AI applications before deploying.
73+
Prompt flow is a tool to create executable flows, linking LLMs, prompts, and Python tools through a visualized graph. You can use this to prototype, experiment, and iterate on your AI applications before deploying.
7474

7575
Once you have created or selected a project, go to the navigation landmark. Press the down arrow until you hear *Prompt flow* and select this link.
7676

@@ -80,11 +80,11 @@ The prompt flow UI in Azure AI Foundry portal is composed of the following main
8080

8181
- This is the main working area where you can edit your flow, for example adding a new node, editing the prompt, selecting input data
8282
- You can also choose to work in code instead of the editor by navigating to the **Raw file mode** toggle button to view the flow in code.
83-
- Each node has its own H3 heading, which can be used for navigation.
83+
- Each node has its own H3 heading, which can be used for navigation.
8484

8585
### Files
8686

87-
- This section contains the file structure of the flow. Each flow has a folder that contains a flow.dag.yaml file, source code files, and system folders.
87+
- This section contains the file structure of the flow. Each flow has a folder that contains a flow.dag.yaml file, source code files, and system folders.
8888
- You can export or import a flow easily for testing, deployment, or collaborative purposes by navigating to the **Add** and **Zip and download all files** buttons.
8989

9090
### Graph view
@@ -99,15 +99,15 @@ Evaluation is a tool to help you evaluate the performance of your generative AI
9999

100100
### Creating an evaluation
101101

102-
To review evaluation metrics, you must first create an evaluation.
102+
To review evaluation metrics, you must first create an evaluation.
103103

104104
1. Once you have created or selected a project, go to the navigation landmark. Press the down arrow until you hear *Evaluation* and select this link.
105-
1. Press the Tab key until you hear *new evaluation* and select this button.
105+
1. Press the Tab key until you hear *new evaluation* and select this button.
106106
1. Enter the information requested in the **Create a new evaluation** dialog. Once complete, your focus is returned to the evaluations list.
107107

108108
### Viewing evaluations
109109

110-
Once you create an evaluation, you can access it from the list of evaluations.
110+
Once you create an evaluation, you can access it from the list of evaluations.
111111

112112
Evaluation runs are listed as links within the Evaluations grid. Selecting a link takes you to a dashboard view with information about your specific evaluation run.
113113

@@ -125,4 +125,5 @@ If you're a government, commercial, or enterprise customer, contact the enterpri
125125
## Related content
126126

127127
* Learn how you can build generative AI applications in the [Azure AI Foundry](../what-is-ai-studio.md).
128+
* [Build a custom knowledge retrieval (RAG) app with the Azure AI Foundry SDK](copilot-sdk-create-resources.md)
128129
* Get answers to frequently asked questions in the [Azure AI FAQ article](../faq.yml).

0 commit comments

Comments
 (0)