Skip to content

Commit e1d9858

Browse files
committed
improve links and images
1 parent 3c5a466 commit e1d9858

17 files changed

+44
-43
lines changed

articles/ai-studio/concepts/ai-resources.md

Lines changed: 16 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ author: Blackmist
1919

2020
The 'Azure AI' resource is the top-level Azure resource for AI Studio and provides the working environment for a team to build and manage AI applications. In Azure, resources enable access to Azure services for individuals and teams. Resources also provide a container for billing, security configuration and monitoring.
2121

22-
The Azure AI hub resource is used to access multiple Azure AI services with a single setup. Previously, different Azure AI services including [Azure OpenAI](../../ai-services/openai/overview.md), [Azure Machine Learning](../../machine-learning/overview-what-is-azure-machine-learning.md), [Azure Speech](../../ai-services/speech-service/overview.md), required their individual setup.
22+
The Azure AI hub resource is used to access multiple Azure AI services with a single setup. Previously, different Azure AI services including [Azure OpenAI](../../ai-services/openai/overview.md), [Azure Machine Learning](../../machine-learning/overview-what-is-azure-machine-learning.md), [Azure AI Speech](../../ai-services/speech-service/overview.md), required their individual setup.
2323

2424
In this article, you learn more about Azure AI hub resource's capabilities, and how to set up Azure AI for your organization. You can see the resources created in the [Azure portal](https://portal.azure.com/) and in [Azure AI Studio](https://ai.azure.com).
2525

@@ -32,7 +32,7 @@ The Azure AI hub resource provides the collaboration environment for a team to b
3232

3333
## Central setup and management concepts
3434

35-
Various management concepts are available on Azure AI hub resources to support team leads and admins to centrally manage a team's environment. In [Azure AI Studio](https://ai.azure.com/), you find these on the **Manage** page.
35+
Various management concepts are available on Azure AI hub resources to support team leads and admins to centrally manage a team's environment.
3636

3737
* **Security configuration** including public network access, [virtual networking](#virtual-networking), customer-managed key encryption, and privileged access to whom can create projects for customization. Security settings configured on the Azure AI hub resource automatically pass down to each project. A managed virtual network is shared between all projects that share the same Azure AI hub resource.
3838
* **Connections** are named and authenticated references to Azure and non-Azure resources like data storage providers. Use a connection as a means for making an external resource available to a group of developers without having to expose its stored credential to an individual.
@@ -43,7 +43,7 @@ Various management concepts are available on Azure AI hub resources to support t
4343

4444
## Organize work in projects for customization
4545

46-
An Azure AI hub resource provides the hosting environment for **projects** in AI Studio. A project is an organizational container that has tools for AI customization and orchestration, lets you organize your work, save state across different tools like prompt flow, and collaborate with others. For example, you can share uploaded files and connections to data sources.
46+
An Azure AI hub resource provides the hosting environment for [Azure AI projects](../how-to/create-projects.md) in AI Studio. A project is an organizational container that has tools for AI customization and orchestration, lets you organize your work, save state across different tools like prompt flow, and collaborate with others. For example, you can share uploaded files and connections to data sources.
4747

4848
Multiple projects can use an Azure AI hub resource, and a project can be used by multiple users. A project also helps you keep track of billing, and manage access and provides data isolation. Every project has dedicated storage containers to let you upload files and share it with only other project members when using the 'data' experiences.
4949

@@ -68,16 +68,13 @@ Projects also have specific settings that only hold for that project:
6868
6969
## Azure AI services API access keys
7070

71-
The Azure AI hub resource exposes API endpoints and keys for prebuilt AI services that are created by Microsoft such as Speech services and Language service. Which precise services are available to you is subject to your Azure region and your chosen Azure AI services provider at the time of setup ('advanced' option):
71+
The Azure AI hub resource exposes API endpoints and keys for prebuilt AI services that are created by Microsoft such as Azure OpenAI Service. Which precise services are available to you is subject to your Azure region and your chosen Azure AI services provider at the time of setup ('advanced' option):
7272

73-
* If you create an Azure AI hub resource using the default configuration, you'll have by default capabilities enabled for Azure OpenAI service, Speech, Vision, Content Safety.
74-
* If you create an Azure AI hub resource and choose an existing Azure OpenAI resource as service provider, you'll only have capabilities for Azure OpenAI service. Use this option if you'd like to reuse existing Azure OpenAI quota and models deployments. Currently, there's no upgrade path to get Speech and Vision capabilities after deployment.
73+
* If you create an Azure AI hub resource together with an existing Azure OpenAI Service resource, you only have capabilities for Azure OpenAI Service. Use this option if you'd like to reuse existing Azure OpenAI quota and models deployments. Currently, there's no upgrade path to get Speech and Vision capabilities after the AI hub is created.
74+
* If you create an Azure AI hub resource together with an Azure AI services provider, you can use Azure OpenAI Service and other AI services such as Speech and Vision. Currently, this option is only available via the Azure AI CLI and SDK.
7575

7676
To understand the full layering of Azure AI hub resources and its Azure dependencies including the Azure AI services provider, and how these is represented in Azure AI Studio and in the Azure portal, see [Find Azure AI Studio resources in the Azure portal](#find-azure-ai-studio-resources-in-the-azure-portal).
7777

78-
> [!NOTE]
79-
> This Azure AI services resource is similar but not to be confused with the standalone "Azure AI services multi-service account" resource. Their capabilities vary, and the standalone resource is not supported in Azure AI Studio. Going forward, we recommend using the Azure AI services resource that's provided with your Azure AI hub resource.
80-
8178
With the same API key, you can access all of the following Azure AI services:
8279

8380
| Service | Description |
@@ -121,7 +118,7 @@ When you create a new Azure AI hub resource, a set of dependent Azure resources
121118

122119
|Dependent Azure resource|Note|
123120
|---|---|
124-
|Azure AI services|Either Azure AI services multi-service provider, or Azure OpenAI service. Provides API endpoints and keys for prebuilt AI services.|
121+
|Azure AI services|Either Azure AI services multi-service provider, or Azure OpenAI Service. Provides API endpoints and keys for prebuilt AI services.|
125122
|Azure Storage account|Stores artifacts for your projects like flows and evaluations. For data isolation, storage containers are prefixed using the project GUID, and conditionally secured using Azure ABAC for the project identity.|
126123
|Azure Key Vault| Stores secrets like connection strings for your resource connections. For data isolation, secrets can't be retrieved across projects via APIs.|
127124
|Azure Container Registry| Stores docker images created when using custom runtime for prompt flow. For data isolation, docker images are prefixed using the project GUID.|
@@ -144,36 +141,24 @@ In the Azure portal, you can find resources that correspond to your Azure AI pro
144141
> [!NOTE]
145142
> This section assumes that the Azure AI hub resource and Azure AI project are in the same resource group.
146143
147-
In Azure AI Studio, go to **Build** > **Settings** to view your Azure AI project resources such as connections and API keys. There's a link to view the corresponding resources in the Azure portal and a link to your Azure AI hub resource in Azure AI Studio.
148-
149-
:::image type="content" source="../media/concepts/azureai-project-view-ai-studio.png" alt-text="Screenshot of the Azure AI project and related resources in the Azure AI Studio." lightbox="../media/concepts/azureai-project-view-ai-studio.png":::
150-
151-
In Azure AI Studio, go to **Manage** (or select the Azure AI hub resource link from the project settings page) to view your Azure AI hub resource, including projects and shared connections. There's also a link to view the corresponding resources in the Azure portal.
152-
153-
:::image type="content" source="../media/concepts/azureai-resource-view-ai-studio.png" alt-text="Screenshot of the Azure AI hub resource and related resources in the Azure AI Studio." lightbox="../media/concepts/azureai-resource-view-ai-studio.png":::
154-
155-
After you select **View in the Azure Portal**, you see your Azure AI hub resource in the Azure portal.
156-
157-
:::image type="content" source="../media/concepts/docs-azure-ai-resource.png" alt-text="Screenshot of the Azure AI hub resource in the Azure portal." lightbox="../media/concepts/docs-azure-ai-resource.png":::
158-
159-
Select the resource group name to see all associated resources, including the Azure AI project, storage account, and key vault.
144+
1. In [Azure AI Studio](https://ai.azure.com), go to **Build** > **Settings** to view your Azure AI project resources such as connections and API keys. There's a link to your Azure AI hub resource in Azure AI Studio and links to view the corresponding project resources in the [Azure portal](https://portal.azure.com).
160145

161-
:::image type="content" source="../media/concepts/rg-docs-azure-ai-resource.png" alt-text="Screenshot of the Azure AI hub resource group in the Azure portal." lightbox="../media/concepts/rg-docs-azure-ai-resource.png":::
146+
:::image type="content" source="../media/concepts/azureai-project-view-ai-studio.png" alt-text="Screenshot of the Azure AI project and related resources in the Azure AI Studio." lightbox="../media/concepts/azureai-project-view-ai-studio.png":::
162147

163-
From the resource group, you can select the Azure AI project for more details.
148+
1. Select the AI hub name to view your Azure AI hub's projects and shared connections. There's also a link to view the corresponding resources in the [Azure portal](https://portal.azure.com).
164149

165-
:::image type="content" source="../media/concepts/docs-project.png" alt-text="Screenshot of the Azure AI project in the Azure portal." lightbox="../media/concepts/docs-project.png":::
150+
:::image type="content" source="../media/concepts/azureai-resource-view-ai-studio.png" alt-text="Screenshot of the Azure AI hub resource and related resources in the Azure AI Studio." lightbox="../media/concepts/azureai-resource-view-ai-studio.png":::
166151

167-
Also from the resource group, you can select the **Azure AI service** resource to see the keys and endpoints needed to authenticate your requests to Azure AI services.
152+
1. Select **View in the Azure Portal** to see your Azure AI hub resource in the Azure portal.
168153

169-
:::image type="content" source="../media/concepts/docs-azure-ai-resource-aiservices-keys.png" alt-text="Screenshot of the Azure AI service resource in the Azure portal." lightbox="../media/concepts/docs-azure-ai-resource-aiservices-keys.png":::
154+
:::image type="content" source="../media/concepts/ai-hub-azure-portal.png" alt-text="Screenshot of the Azure AI hub resource in the Azure portal." lightbox="../media/concepts/ai-hub-azure-portal.png":::
170155

171-
You can use the same API key to access all of the supported service endpoints that are listed.
156+
- Select the **AI Services provider** to see the keys and endpoints needed to authenticate your requests to Azure AI services such as Azure OpenAI. For more information, see [Azure AI services API access keys](#azure-ai-services-api-access-keys).
157+
- Also from the Azure AI hub page, you can select the **Project resource group** to find your Azure AI project.
172158

173-
:::image type="content" source="../media/concepts/docs-azure-ai-resource-aiservices-keys-endpoints.png" alt-text="Screenshot of the Azure AI service resource endpoints in the Azure portal." lightbox="../media/concepts/docs-azure-ai-resource-aiservices-keys-endpoints.png":::
174159

175160
## Next steps
176161

177-
- [Quickstart: Generate product name ideas in the Azure AI Studio playground](../quickstarts/playground-completions.md)
162+
- [Quickstart: Analyze images and video with GPT-4 for Vision in the playground](../quickstarts/multimodal-vision.md)
178163
- [Learn more about Azure AI Studio](../what-is-ai-studio.md)
179164
- [Learn more about Azure AI Studio projects](../how-to/create-projects.md)

articles/ai-studio/concepts/connections.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Connections in Azure AI Studio are a way to authenticate and consume both Micros
2121

2222
## Connections to Azure AI services
2323

24-
You can create connections to Azure AI services such as Azure AI Content Safety and Azure OpenAI. You can then use the connection in a prompt flow tool such as the LLM tool.
24+
You can create connections to Azure AI services such as Azure OpenAI and Azure AI Content Safety. You can then use the connection in a prompt flow tool such as the LLM tool.
2525

2626
:::image type="content" source="../media/prompt-flow/llm-tool-connection.png" alt-text="Screenshot of a connection used by the LLM tool in prompt flow." lightbox="../media/prompt-flow/llm-tool-connection.png":::
2727

articles/ai-studio/how-to/create-projects.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,8 @@ This article describes how to create an Azure AI project in Azure AI Studio. A p
2121

2222
Projects are hosted by an Azure AI hub resource that provides enterprise-grade security and a collaborative environment. For more information about the Azure AI projects and resources model, see [Azure AI hub resources](../concepts/ai-resources.md).
2323

24+
## Create a project
25+
2426
You can create a project in Azure AI Studio in more than one way. The most direct way is from the **Build** tab.
2527
1. Select the **Build** tab at the top of the page.
2628
1. Select **+ New project**.

articles/ai-studio/how-to/data-image-add.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ This guide is scoped to the Azure AI Studio playground, but you can also add ima
5252
From the Azure AI Studio playground, you can choose how to add your image data for GPT-4 Turbo with Vision:
5353

5454
* [Upload image files and metadata](?tabs=upload-image-files-and-metadata): You can upload image files and metadata in the playground. This option is useful if you have a small number of image files.
55-
* [Azure AI Search](?tabs=azure-ai-search): If you have an existing [Azure AI search](/azure/search/search-what-is-azure-search) index, you can use it as a data source.
55+
* [Azure AI Search](?tabs=azure-ai-search): If you have an existing [Azure AI Search](/azure/search/search-what-is-azure-search) index, you can use it as a data source.
5656
* [Azure Blob Storage](?tabs=azure-blob-storage): The Azure Blob storage option is especially useful if you have a large number of image files and don't want to manually upload each one.
5757

5858
Each option uses an Azure AI Search index to do image-to-image search and retrieve the top search results for your input prompt image.
@@ -115,7 +115,7 @@ Each option uses an Azure AI Search index to do image-to-image search and retrie
115115

116116
# [Azure AI Search](#tab/azure-ai-search)
117117

118-
If you have an existing [Azure AI search](/azure/search/search-what-is-azure-search) index, you can use it as a data source.
118+
If you have an existing [Azure AI Search](/azure/search/search-what-is-azure-search) index, you can use it as a data source.
119119

120120
If you don't already have a search index created for your images:
121121
- You can create one using the [AI Search vector search repository on GitHub](https://github.com/Azure/cognitive-search-vector-pr), which provides you with scripts to create an index with your image files.
@@ -126,7 +126,7 @@ If you don't already have a search index created for your images:
126126

127127
1. Enter your data source details:
128128

129-
:::image type="content" source="../media/data-add/use-your-image-data/add-image-data-ai-search.png" alt-text="A screenshot showing the Azure AI search index selection." lightbox="../media/data-add/use-your-image-data/add-image-data-ai-search.png":::
129+
:::image type="content" source="../media/data-add/use-your-image-data/add-image-data-ai-search.png" alt-text="A screenshot showing the Azure AI Search index selection." lightbox="../media/data-add/use-your-image-data/add-image-data-ai-search.png":::
130130

131131
- **Subscription**: Select the Azure subscription that contains the Azure OpenAI resource you want to use.
132132
- **Azure AI Search service**: Select your Azure AI Search service resource that has an image search index.
@@ -136,7 +136,7 @@ If you don't already have a search index created for your images:
136136

137137
1. Review the details you entered.
138138

139-
:::image type="content" source="../media/data-add/use-your-image-data/add-your-data-ai-search-review-finish.png" alt-text="Screenshot of the review and finish page for adding data via Azure AI search." lightbox="../media/data-add/use-your-image-data/add-your-data-ai-search-review-finish.png":::
139+
:::image type="content" source="../media/data-add/use-your-image-data/add-your-data-ai-search-review-finish.png" alt-text="Screenshot of the review and finish page for adding data via Azure AI Search." lightbox="../media/data-add/use-your-image-data/add-your-data-ai-search-review-finish.png":::
140140

141141
1. Select **Save and close**.
142142

@@ -182,7 +182,7 @@ After you have a blob storage populated with image files and at least one metada
182182
>
183183
> When adding data to the selected storage account for the first time in Azure AI Studio, you might be prompted to turn on [cross-origin resource sharing (CORS)](/rest/api/storageservices/cross-origin-resource-sharing--cors--support-for-the-azure-storage-services). Azure AI Studio and Azure OpenAI need access your Azure Blob storage account.
184184
185-
:::image type="content" source="../media/data-add/use-your-image-data/add-image-data-blob.png" alt-text="A screenshot showing the Azure storage account and Azure AI search index selection." lightbox="../media/data-add/use-your-image-data/add-image-data-blob.png":::
185+
:::image type="content" source="../media/data-add/use-your-image-data/add-image-data-blob.png" alt-text="A screenshot showing the Azure storage account and Azure AI Search index selection." lightbox="../media/data-add/use-your-image-data/add-image-data-blob.png":::
186186

187187
- **Subscription**: Select the Azure subscription that contains the Azure OpenAI resource you want to use.
188188
- **Storage resource** and **Storage container**: Select the Azure Blob storage resource where the image files and metadata are already stored.

articles/ai-studio/how-to/develop-in-vscode.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,4 +107,4 @@ For cross-language compatibility and seamless integration of Azure AI capabiliti
107107
## Next steps
108108
109109
- [Get started with the Azure AI CLI](cli-install.md)
110-
- [Quickstart: Generate product name ideas in the Azure AI Studio playground](../quickstarts/playground-completions.md)
110+
- [Quickstart: Analyze images and video with GPT-4 for Vision in the playground](../quickstarts/multimodal-vision.md)

articles/ai-studio/how-to/troubleshoot-deploy-and-monitor.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ This article provides instructions on how to troubleshoot your deployments and m
2424
For the general deployment error code reference, you can go to the [Azure Machine Learning documentation](/azure/machine-learning/how-to-troubleshoot-online-endpoints). Much of the information there also applies to Azure AI Studio deployments.
2525

2626
**Question:** I got the following error message. What should I do?
27-
"Use of Azure OpenAI models in Azure Machine Learning requires Azure OpenAI services resources. This subscription or region doesn't have access to this model."
27+
"Use of Azure OpenAI models in Azure Machine Learning requires Azure OpenAI Services resources. This subscription or region doesn't have access to this model."
2828

2929
**Answer:** You might not have access to this particular Azure OpenAI model. For example, your subscription might not have access to the latest GPT model yet or this model isn't offered in the region you want to deploy to. You can learn more about it on [Azure OpenAI Service models](../../ai-services/openai/concepts/models.md).
3030

0 commit comments

Comments
 (0)