Skip to content

Commit 0fa92ce

Browse files
authored
Merge pull request #275499 from Blackmist/connection-ux-fast-follow
Connection ux fast follow
2 parents e73b747 + b913bbd commit 0fa92ce

File tree

7 files changed

+255
-115
lines changed

7 files changed

+255
-115
lines changed

articles/ai-studio/how-to/connections-add.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -23,19 +23,19 @@ Connections are a way to authenticate and consume both Microsoft and other resou
2323

2424
## Connection types
2525

26-
Here's a table of some of the available connection types in Azure AI Studio:
27-
28-
| Service connection type | Description |
29-
| --- | --- |
30-
| Azure AI Search | Azure AI Search is an Azure resource that supports information retrieval over your vector and textual data stored in search indexes. |
31-
| Azure Blob Storage | Azure Blob Storage is a cloud storage solution for storing unstructured data like documents, images, videos, and application installers. |
32-
| Azure Data Lake Storage Gen 2 | Azure Data Lake Storage Gen2 is a set of capabilities dedicated to big data analytics, built on Azure Blob storage. |
33-
| Azure Content Safety | Azure AI Content Safety is a service that detects potentially unsafe content in text, images, and videos. |
34-
| Azure OpenAI | Azure OpenAI is a service that provides access to the OpenAI GPT-3 model. |
35-
| Microsoft OneLake | Microsoft OneLake provides open access to all of your Fabric items through Azure Data Lake Storage (ADLS) Gen2 APIs and SDKs.<br/><br/>In Azure AI Studio you can set up a connection to your OneLake data using a OneLake URI. You can find the information that Azure AI Studio requires to construct a **OneLake Artifact URL** (workspace and item GUIDs) in the URL on the Fabric portal. For information about the URI syntax, see [Connecting to Microsoft OneLake](/fabric/onelake/onelake-access-api). |
36-
| Git | Git is a distributed version control system that allows you to track changes to files.<br/><br/>Personal access tokens are an alternative to using passwords for authentication to GitHub when using the GitHub API or the command line. In Azure AI Studio you can set up a connection to your GitHub account using a personal access token. For more information, see [Managing your personal access tokens](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens). |
37-
| API key | API Key connections handle authentication to your specified target on an individual basis. For example, you can use this connection with the SerpApi tool in prompt flow. |
38-
| Custom | Custom connections allow you to securely store and access keys while storing related properties, such as targets and versions. Custom connections are useful when you have many targets that or cases where you wouldn't need a credential to access. LangChain scenarios are a good example where you would use custom service connections. Custom connections don't manage authentication, so you have to manage authentication on your own. |
26+
Here's a table of some of the available connection types in Azure AI Studio. The __Preview__ column indicates connection types that are currently in preview.
27+
28+
| Service connection type | Preview | Description |
29+
| --- |:---:| --- |
30+
| Azure AI Search | | Azure AI Search is an Azure resource that supports information retrieval over your vector and textual data stored in search indexes. |
31+
| Azure Blob Storage | | Azure Blob Storage is a cloud storage solution for storing unstructured data like documents, images, videos, and application installers. |
32+
| Azure Data Lake Storage Gen 2 | | Azure Data Lake Storage Gen2 is a set of capabilities dedicated to big data analytics, built on Azure Blob storage. |
33+
| Azure Content Safety | | Azure AI Content Safety is a service that detects potentially unsafe content in text, images, and videos. |
34+
| Azure OpenAI || Azure OpenAI is a service that provides access to the OpenAI GPT-3 model. |
35+
| Serverless Model | | Serverless Model connections allow you to [serverless API deployment](deploy-models-serverless.md). |
36+
| Microsoft OneLake || Microsoft OneLake provides open access to all of your Fabric items through Azure Data Lake Storage (ADLS) Gen2 APIs and SDKs.<br/><br/>In Azure AI Studio you can set up a connection to your OneLake data using a OneLake URI. You can find the information that Azure AI Studio requires to construct a **OneLake Artifact URL** (workspace and item GUIDs) in the URL on the Fabric portal. For information about the URI syntax, see [Connecting to Microsoft OneLake](/fabric/onelake/onelake-access-api). |
37+
| API key || API Key connections handle authentication to your specified target on an individual basis. For example, you can use this connection with the SerpApi tool in prompt flow. |
38+
| Custom || Custom connections allow you to securely store and access keys while storing related properties, such as targets and versions. Custom connections are useful when you have many targets that or cases where you wouldn't need a credential to access. LangChain scenarios are a good example where you would use custom service connections. Custom connections don't manage authentication, so you have to manage authentication on your own. |
3939

4040
## Create a new connection
4141

articles/ai-studio/how-to/develop/connections-add-sdk.md

Lines changed: 6 additions & 97 deletions
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ wps_connection = AzureAIServicesConnection(
7979
ml_client.connections.create_or_update(wps_connection)
8080
```
8181

82-
## Azure AI Search
82+
## Azure AI Search (preview)
8383

8484
The following example creates an Azure AI Search connection:
8585

@@ -99,7 +99,7 @@ wps_connection = AzureAISearchConnection(
9999
ml_client.connections.create_or_update(wps_connection)
100100
```
101101

102-
## Azure AI Content Safety
102+
## Azure AI Content Safety (preview)
103103

104104
The following example creates an Azure AI Content Safety connection:
105105

@@ -121,7 +121,7 @@ wps_connection = AzureContentSafetyConnection(
121121
ml_client.connections.create_or_update(wps_connection)
122122
```
123123

124-
## Serverless
124+
## Serverless model (preview)
125125

126126
The following example creates a serverless endpoint connection:
127127

@@ -141,7 +141,7 @@ wps_connection = ServerlessConnection(
141141
ml_client.connections.create_or_update(wps_connection)
142142
```
143143

144-
## Azure Blob Storage
144+
## Azure Blob Storage (preview)
145145

146146
The following example creates an Azure Blob Storage connection. This connection is authenticated with an account key or a SAS token:
147147

@@ -165,7 +165,7 @@ wps_connection = AzureBlobStoreConnection(
165165
ml_client.connections.create_or_update(wps_connection)
166166
```
167167

168-
## Azure Data Lake Storage Gen 2
168+
## Azure Data Lake Storage Gen 2 (preview)
169169

170170
The following example creates Azure Data Lake Storage Gen 2 connection. This connection is authenticated with a Service Principal:
171171

@@ -193,7 +193,7 @@ wps_connection = WorkspaceConnection(
193193
ml_client.connections.create_or_update(workspace_connection=wps_connection)
194194
```
195195

196-
## Microsoft OneLake
196+
## Microsoft OneLake (preview)
197197

198198
The following example creates a Microsoft OneLake connection. This connection is authenticated with a Service Principal:
199199

@@ -225,28 +225,6 @@ wps_connection = MicrosoftOneLakeWorkspaceConnection(
225225
ml_client.connections.create_or_update(workspace_connection=wps_connection)
226226
```
227227

228-
## Git
229-
230-
The following example creates a Git connection to a GitHub repo. This connection is authenticated with a Personal Access Token (PAT):
231-
232-
```python
233-
from azure.ai.ml.entities import WorkspaceConnection
234-
from azure.ai.ml.entities import UsernamePasswordConfiguration, PatTokenConfiguration
235-
236-
237-
name = "my_git_conn"
238-
239-
target = "https://github.com/myaccount/myrepo"
240-
241-
wps_connection = WorkspaceConnection(
242-
name=name,
243-
type="git",
244-
target=target,
245-
credentials=PatTokenConfiguration(pat="XXXXXXXXX"),
246-
)
247-
ml_client.connections.create_or_update(workspace_connection=wps_connection)
248-
```
249-
250228
## Serp
251229

252230
The following example creates a Serp connection:
@@ -281,75 +259,6 @@ wps_connection = OpenAIConnection(
281259
ml_client.connections.create_or_update(wps_connection)
282260
```
283261

284-
## Python feed
285-
286-
The following example creates a Python feed connection. This connection is authenticated with a personal access token (PAT) or a username and password:
287-
288-
```python
289-
from azure.ai.ml.entities import WorkspaceConnection
290-
from azure.ai.ml.entities import UsernamePasswordConfiguration, ManagedIdentityConfiguration
291-
292-
293-
name = "my_pfeed_conn"
294-
295-
target = "https://XXXXXXXXX.core.windows.net/mycontainer"
296-
297-
wps_connection = WorkspaceConnection(
298-
name=name,
299-
type="python_feed",
300-
target=target,
301-
#credentials=UsernamePasswordConfiguration(username="xxxxx", password="xxxxx"),
302-
credentials=PatTokenConfiguration(pat="XXXXXXXXX"),
303-
304-
#credentials=None
305-
)
306-
ml_client.connections.create_or_update(workspace_connection=wps_connection)
307-
```
308-
309-
## Azure Container Registry
310-
311-
The following example creates an Azure Container Registry connection. This connection is authenticated using a managed identity:
312-
313-
```python
314-
from azure.ai.ml.entities import WorkspaceConnection
315-
from azure.ai.ml.entities import UsernamePasswordConfiguration, PatTokenConfiguration
316-
317-
318-
name = "my_acr_conn"
319-
320-
target = "https://XXXXXXXXX.core.windows.net/mycontainer"
321-
322-
wps_connection = WorkspaceConnection(
323-
name=name,
324-
type="container_registry",
325-
target=target,
326-
credentials=ManagedIdentityConfiguration (client_id="xxxxx", resource_id="xxxxx"),
327-
)
328-
ml_client.connections.create_or_update(workspace_connection=wps_connection)
329-
```
330-
331-
## API key
332-
333-
The following example creates an API key connection:
334-
335-
```python
336-
from azure.ai.ml.entities import WorkspaceConnection
337-
from azure.ai.ml.entities import UsernamePasswordConfiguration, ApiKeyConfiguration
338-
339-
340-
name = "my_api_key"
341-
342-
target = "https://XXXXXXXXX.core.windows.net/mycontainer"
343-
344-
wps_connection = WorkspaceConnection(
345-
name=name,
346-
type="apikey",
347-
target=target,
348-
credentials=ApiKeyConfiguration(key="XXXXXXXXX"),
349-
)
350-
ml_client.connections.create_or_update(workspace_connection=wps_connection)
351-
```
352-
353262
## Custom
354263

355264
The following example creates custom connection:
-37.7 KB
Loading

0 commit comments

Comments
 (0)