Quickstart: Configure prerequisites for using Foundry Tools in Azure Synapse Analytics

In this quickstart, you'll learn how set up the prerequisites for securely using Foundry Tools in Azure Synapse Analytics. Linking these Foundry Tools allows you to leverage Foundry Tools from various experiences in Synapse.

This quickstart covers:

Create an Azure AI services resource like Text Analytics or Anomaly Detector.
Store an authentication key to Azure AI services resources as secrets in Azure Key Vault, and configure access for an Azure Synapse Analytics workspace.
Create an Azure Key Vault linked service in your Azure Synapse Analytics workspace.
Create a Foundry Tools linked service in your Azure Synapse Analytics workspace.

If you don't have an Azure subscription, create a trial account before you begin.

Prerequisites

Azure Synapse Analytics workspace with an Azure Data Lake Storage Gen2 storage account configured as the default storage. You need to be the Storage Blob Data Contributor of the Azure Data Lake Storage Gen2 file system that you work with.

Create an Azure AI services resource

Foundry Tools includes many types of services. Follow services are examples used in the Azure Synapse tutorials.

You can create a Text Analytics resource in the Azure portal:

Screenshot that shows Text Analytics in the portal, with the Create button.

You can create an Anomaly Detector resource in the Azure portal:

Screenshot that shows Anomaly Detector in the portal, with the Create button.

You can create an Azure Document Intelligence in Foundry Tools resource (for Document Intelligence) in the Azure portal:

Screenshot that shows Document Intelligence in the portal, with the Create button.

You can create a Translator resource in the Azure portal:

Screenshot that shows Translator in the portal, with the Create button.

You can create a Computer Vision resource in the Azure portal:

Screenshot that shows Computer Vision in the portal, with the Create button.

You can create a Face resource in the Azure portal:

Screenshot that shows Face in the portal, with the Create button.

You can create a Speech resource in the Azure portal:

Screenshot that shows Speech in the portal, with the Create button.

Create a key vault and configure secrets and access

Create a key vault in the Azure portal.
Go to Key Vault > Access policies, and grant the Azure Synapse workspace MSI permissions to read secrets from Azure Key Vault.

Note

Make sure that the policy changes are saved. This step is easy to miss.
Go to your Azure AI services resource. For example, go to Anomaly Detector > Keys and Endpoint. Then copy either of the two keys to the clipboard.
Go to Key Vault > Secret to create a new secret. Specify the name of the secret, and then paste the key from the previous step into the Value field. Finally, select Create.

Important

Make sure you remember or note down this secret name. You'll use it later when you create the Foundry Tools linked service.

Create an Azure Key Vault linked service in Azure Synapse

Open your workspace in Synapse Studio.
Go to Manage > Linked Services. Create an Azure Key Vault linked service by pointing to the key vault that you just created.
Verify the connection by selecting the Test connection button. If the connection is green, select Create and then select Publish all to save your change.

Screenshot that shows Azure Key Vault as a new linked service.

Create an Azure AI linked service in Azure Synapse

Open your workspace in Synapse Studio.
Go to Manage > Linked Services. Create an Azure Cognitive Services linked service by pointing to the Foundry Tool that you just created.
Verify the connection by selecting the Test connection button. If the connection is green, select Create and then select Publish all to save your change.

Screenshot that shows Foundry Tools as a new linked service.

You're now ready to continue with one of the tutorials for using the Foundry Tools experience in Synapse Studio.

Next steps

Last updated on 2026-02-28