Conectar-se aos serviços de IA do Azure usando o Service Connector

Esta página fornece informações sobre clientes e métodos de autenticação suportados, juntamente com código de exemplo para conectar seus aplicativos aos serviços de IA do Azure usando o Service Connector. Esta página também lista nomes de variáveis de ambiente padrão e valores obtidos ao criar a conexão de serviço.

Serviços de computação suportados

O Service Connector pode ser usado para conectar os seguintes serviços de computação aos Serviços de IA do Azure:

• Serviço de Aplicações do Azure
• Azure Container Apps
• Funções do Azure
• Azure Kubernetes Service (AKS)
• Azure Spring Apps

Tipos de autenticação e tipos de cliente suportados

A tabela abaixo indica quais combinações de métodos de autenticação e clientes têm suporte para conectar seu serviço de computação a Serviços de IA do Azure individuais usando o Service Connector. Um "Sim" indica que a combinação é suportada, enquanto um "Não" indica que ela não é suportada.

Tipo de cliente	Identidade gerida atribuída automaticamente pelo sistema	Identidade gerida atribuída pelo utilizador	Segredo/cadeia de conexão	Principal de serviço
.NET	Sim	Sim	Sim	Sim
Java	Sim	Sim	Sim	Sim
Node.js	Sim	Sim	Sim	Sim
Python	Sim	Sim	Sim	Sim
Nenhuma	Sim	Sim	Sim	Sim

Esta tabela indica que todas as combinações de tipos de cliente e métodos de autenticação na tabela são suportadas. Todos os tipos de cliente podem usar qualquer um dos métodos de autenticação para se conectar aos Serviços do Azure AI usando o Service Connector.

Nomes de variáveis de ambiente padrão ou propriedades de aplicativo e código de exemplo

Use os detalhes de conexão abaixo para conectar serviços de computação aos Serviços de IA do Azure. Para obter mais informações sobre convenções de nomenclatura, consulte o artigo interno do Service Connector.

Identidade gerenciada atribuída ao sistema (recomendado)

Nome da variável de ambiente padrão	Descrição	Valores de exemplo
AZURE_AISERVICES_OPENAI_BASE	Ponto de extremidade do Azure OpenAI	https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT	Serviço de provedor de token dos Serviços Cognitivos do Azure	https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT	Ponto de extremidade da API de fala para texto (padrão)	https://<location>.stt.speech.microsoft.com

Código de exemplo

Consulte as etapas e o código abaixo para se conectar aos Serviços de IA do Azure usando uma identidade gerenciada atribuída pelo sistema.

Você pode usar a biblioteca de cliente do Azure para acessar várias APIs cognitivas suportadas pelos Serviços de IA do Azure. Usamos o Azure AI Text Analytics como um exemplo neste exemplo. Consulte Autenticar solicitações para serviços de IA do Azure para chamar as APIs cognitivas diretamente.

.NET

1. Instale as seguintes dependências. Usamos Azure.AI.TextAnalytics como exemplo.

   dotnet add package Azure.AI.TextAnalytics
   dotnet add package Azure.Identity
   

2. Autentique-se utilizando a biblioteca Azure Identity e obtenha o endpoint dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Conector de Serviço. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   using Azure.AI.TextAnalytics;
   using Azure.Identity;
   
   string endpoint = Environment.GetEnvironmentVariable("AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT");
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // system-assigned managed identity
   // var credential = new DefaultAzureCredential();
   
   // user-assigned managed identity
   // var credential = new DefaultAzureCredential(
   //     new DefaultAzureCredentialOptions
   //     {
   //         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
   //     });
   
   // service principal 
   // var tenantId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_TENANTID");
   // var clientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
   // var clientSecret = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTSECRET");
   // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
   
   TextAnalyticsClient languageServiceClient = new(
     new Uri(endpoint),
     credential);
   

Java

1. Adicione as seguintes dependências no arquivo pom.xml . Usamos azure-ai-textanalytics como exemplo.

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-ai-textanalytics</artifactId>
       <version>5.1.12</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
       <version>1.11.4</version>
   </dependency>
   

2. Autentique-se usando azure-identity e obtenha o ponto de extremidade dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   // Uncomment the following lines corresponding to the authentication type you want to use.
   // for system-managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
   
   // for user-assigned managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
   //     .managedIdentityClientId(System.getenv("AZURE_AISERVICES_CLIENTID"))
   //     .build();
   
   // for service principal
   // ClientSecretCredential credential = new ClientSecretCredentialBuilder()
   //   .clientId(System.getenv("AZURE_AISERVICES_CLIENTID"))
   //   .clientSecret(System.getenv("AZURE_AISERVICES_CLIENTSECRET"))
   //   .tenantId(System.getenv("AZURE_AISERVICES_TENANTID"))
   //   .build();
   
   String endpoint = System.getenv("AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT");
   
   TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
       .credential(credential)
       .endpoint(endpoint)
       .buildClient();
   

Python

1. Instale as seguintes dependências. Usamos azure-ai-textanalytics como exemplo.

   pip install azure-ai-textanalytics==5.1.0
   pip install azure-identity
   

2. Autentique-se usando azure-identity e obtenha o ponto de extremidade dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   import os
   from azure.ai.textanalytics import TextAnalyticsClient
   from azure.identity import ManagedIdentityCredential, ClientSecretCredential
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # system-assigned managed identity
   # cred = ManagedIdentityCredential()
   
   # user-assigned managed identity
   # managed_identity_client_id = os.getenv('AZURE_AISERVICES_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
   
   # service principal
   # tenant_id = os.getenv('AZURE_AISERVICES_TENANTID')
   # client_id = os.getenv('AZURE_AISERVICES_CLIENTID')
   # client_secret = os.getenv('AZURE_AISERVICES_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   endpoint = os.getenv('AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT')
   
   language_service_client = TextAnalyticsClient(
     endpoint=endpoint, 
     credential=cred)
   

NodeJS

1. Instale as seguintes dependências. Usamos ai-text-analytics como exemplo.

   npm install @azure/ai-text-analytics@5.1.0
   npm install @azure/identity
   

2. Autentique-se usando @azure/identity e obtenha o ponto de extremidade dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
   const { TextAnalyticsClient } = require("@azure/ai-text-analytics");
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // for system-assigned managed identity
   // const credential = new DefaultAzureCredential();
   
   // for user-assigned managed identity
   // const clientId = process.env.AZURE_AISERVICES_CLIENTID;
   // const credential = new DefaultAzureCredential({
   //     managedIdentityClientId: clientId
   // });
   
   // for service principal
   // const tenantId = process.env.AZURE_AISERVICES_TENANTID;
   // const clientId = process.env.AZURE_AISERVICES_CLIENTID;
   // const clientSecret = process.env.AZURE_AISERVICES_CLIENTSECRET;
   // const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
   
   const endpoint = process.env.AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT;
   const languageClient = new TextAnalyticsClient(endpoint, credential);
   

Outro

Para outros idiomas, você pode usar as informações de conexão que o Service Connector define para as variáveis de ambiente para se conectar aos Serviços de IA do Azure. Para obter detalhes sobre variáveis de ambiente, consulte Integrar serviços de IA do Azure com o Service Connector.

Identidade gerida atribuída pelo utilizador

Nome da variável de ambiente padrão	Descrição	Valores de exemplo
AZURE_AISERVICES_OPENAI_BASE	Ponto de extremidade do Azure OpenAI	https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT	Serviço de provedor de token dos Serviços Cognitivos do Azure	https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT	Ponto de extremidade da API de fala para texto (padrão)	https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID	O seu ID de cliente	<client-ID>

Código de exemplo

Consulte as etapas e o código abaixo para se conectar aos Serviços de IA do Azure usando uma identidade gerenciada atribuída pelo usuário.

Você pode usar a biblioteca de cliente do Azure para acessar várias APIs cognitivas suportadas pelos Serviços de IA do Azure. Usamos o Azure AI Text Analytics como um exemplo neste exemplo. Consulte Autenticar solicitações para serviços de IA do Azure para chamar as APIs cognitivas diretamente.

.NET

1. Instale as seguintes dependências. Usamos Azure.AI.TextAnalytics como exemplo.

   dotnet add package Azure.AI.TextAnalytics
   dotnet add package Azure.Identity
   

2. Autentique-se usando a biblioteca de Identidade do Azure e obtenha o ponto final dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   using Azure.AI.TextAnalytics;
   using Azure.Identity;
   
   string endpoint = Environment.GetEnvironmentVariable("AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT");
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // system-assigned managed identity
   // var credential = new DefaultAzureCredential();
   
   // user-assigned managed identity
   // var credential = new DefaultAzureCredential(
   //     new DefaultAzureCredentialOptions
   //     {
   //         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
   //     });
   
   // service principal 
   // var tenantId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_TENANTID");
   // var clientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
   // var clientSecret = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTSECRET");
   // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
   
   TextAnalyticsClient languageServiceClient = new(
     new Uri(endpoint),
     credential);
   

Java

1. Adicione as seguintes dependências no arquivo pom.xml . Usamos azure-ai-textanalytics como exemplo.

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-ai-textanalytics</artifactId>
       <version>5.1.12</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
       <version>1.11.4</version>
   </dependency>
   

2. Autentique-se usando azure-identity e obtenha o ponto de extremidade dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   // Uncomment the following lines corresponding to the authentication type you want to use.
   // for system-managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
   
   // for user-assigned managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
   //     .managedIdentityClientId(System.getenv("AZURE_AISERVICES_CLIENTID"))
   //     .build();
   
   // for service principal
   // ClientSecretCredential credential = new ClientSecretCredentialBuilder()
   //   .clientId(System.getenv("AZURE_AISERVICES_CLIENTID"))
   //   .clientSecret(System.getenv("AZURE_AISERVICES_CLIENTSECRET"))
   //   .tenantId(System.getenv("AZURE_AISERVICES_TENANTID"))
   //   .build();
   
   String endpoint = System.getenv("AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT");
   
   TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
       .credential(credential)
       .endpoint(endpoint)
       .buildClient();
   

Python

1. Instale as seguintes dependências. Usamos azure-ai-textanalytics como exemplo.

   pip install azure-ai-textanalytics==5.1.0
   pip install azure-identity
   

2. Autentique-se usando azure-identity e obtenha o ponto de extremidade dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   import os
   from azure.ai.textanalytics import TextAnalyticsClient
   from azure.identity import ManagedIdentityCredential, ClientSecretCredential
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # system-assigned managed identity
   # cred = ManagedIdentityCredential()
   
   # user-assigned managed identity
   # managed_identity_client_id = os.getenv('AZURE_AISERVICES_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
   
   # service principal
   # tenant_id = os.getenv('AZURE_AISERVICES_TENANTID')
   # client_id = os.getenv('AZURE_AISERVICES_CLIENTID')
   # client_secret = os.getenv('AZURE_AISERVICES_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   endpoint = os.getenv('AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT')
   
   language_service_client = TextAnalyticsClient(
     endpoint=endpoint, 
     credential=cred)
   

NodeJS

1. Instale as seguintes dependências. Usamos ai-text-analytics como exemplo.

   npm install @azure/ai-text-analytics@5.1.0
   npm install @azure/identity
   

2. Autentique-se usando @azure/identity e obtenha o ponto de extremidade dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
   const { TextAnalyticsClient } = require("@azure/ai-text-analytics");
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // for system-assigned managed identity
   // const credential = new DefaultAzureCredential();
   
   // for user-assigned managed identity
   // const clientId = process.env.AZURE_AISERVICES_CLIENTID;
   // const credential = new DefaultAzureCredential({
   //     managedIdentityClientId: clientId
   // });
   
   // for service principal
   // const tenantId = process.env.AZURE_AISERVICES_TENANTID;
   // const clientId = process.env.AZURE_AISERVICES_CLIENTID;
   // const clientSecret = process.env.AZURE_AISERVICES_CLIENTSECRET;
   // const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
   
   const endpoint = process.env.AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT;
   const languageClient = new TextAnalyticsClient(endpoint, credential);
   

Outro

Para outros idiomas, você pode usar as informações de conexão que o Service Connector define para as variáveis de ambiente para se conectar aos Serviços de IA do Azure. Para obter detalhes sobre variáveis de ambiente, consulte Integrar serviços de IA do Azure com o Service Connector.

Cadeia de ligação

Nome da variável de ambiente padrão	Descrição	Valores de exemplo
AZURE_AISERVICES_OPENAI_BASE	Ponto de extremidade do Azure OpenAI	https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT	Serviço de provedor de token dos Serviços Cognitivos do Azure	https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT	Ponto de extremidade da API de Conversão de Fala para Texto Padrão	https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_KEY	Chave da API dos Serviços de IA do Azure	<api-key>

Código de exemplo

Consulte as etapas e o código abaixo para se conectar aos Serviços de IA do Azure usando uma cadeia de conexão.

Você pode usar a biblioteca de cliente do Azure para acessar várias APIs cognitivas suportadas pelos Serviços de IA do Azure. Usamos o Azure AI Text Analytics como um exemplo neste exemplo. Consulte Autenticar solicitações para serviços de IA do Azure para chamar as APIs cognitivas diretamente.

.NET

1. Instale as seguintes dependências. Usamos Azure.AI.TextAnalytics como exemplo.

   dotnet add package Azure.AI.TextAnalytics
   dotnet add package Azure.Core --version 1.40.0
   

2. Obtenha o ponto de extremidade e a chave dos Serviços de IA do Azure das variáveis de ambiente adicionadas pelo Service Connector.

   using Azure.AI.TextAnalytics;
   
   string endpoint = Environment.GetEnvironmentVariable("AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT")
   string key = Environment.GetEnvironmentVariable("AZURE_AISERVICES_KEY");
   
   TextAnalyticsClient languageServiceClient = new(
     new Uri(endpoint),
     new AzureKeyCredential(key));
   

Java

1. Adicione as seguintes dependências no arquivo pom.xml . Usamos azure-ai-textanalytics como exemplo.

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-core</artifactId>
       <version>1.49.1</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-ai-textanalytics</artifactId>
       <version>5.1.12</version>
   </dependency>
   

2. Obtenha o ponto de extremidade e a chave a partir das variáveis de ambiente dos Serviços de IA do Azure adicionadas pelo Service Connector.

   String endpoint = System.getenv("AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT");
   String key = System.getenv("AZURE_AISERVICES_KEY");
   TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
       .credential(new AzureKeyCredential(key))
       .endpoint(endpoint)
       .buildClient();
   

Python

1. Instale as seguintes dependências. Usamos azure-ai-textanalytics como exemplo.

   pip install azure-ai-textanalytics==5.1.0
   pip install azure-core
   

2. Obtenha o endpoint e a chave dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Conector de Serviços.

   import os
   from azure.ai.textanalytics import TextAnalyticsClient
   from azure.core.credentials import AzureKeyCredential
   
   key = os.environ['AZURE_AISERVICES_KEY']
   endpoint = os.environ['AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT']
   language_service_client = TextAnalyticsClient(
     endpoint=retrieved_endpoint, 
     credential=AzureKeyCredential(key))
   

NodeJS

1. Instale a seguinte dependência. Usamos ai-text-analytics como exemplo.

   npm install @azure/ai-text-analytics@5.1.0
   

2. Obtenha o ponto final e a chave dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector.

   const { TextAnalyticsClient, AzureKeyCredential } = require("@azure/ai-text-analytics");
   
   const endpoint = process.env.AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT;
   const credential = new AzureKeyCredential(process.env.AZURE_AISERVICES_KEY);
   
   const languageClient = new TextAnalyticsClient(endpoint, credential);
   

Outro

Para outros idiomas, você pode usar as informações de conexão que o Service Connector define para as variáveis de ambiente para se conectar aos Serviços de IA do Azure. Para obter detalhes sobre variáveis de ambiente, consulte Integrar serviços de IA do Azure com o Service Connector.

Principal de serviço

Nome da variável de ambiente padrão	Descrição	Valores de exemplo
AZURE_AISERVICES_OPENAI_BASE	Ponto de extremidade do Azure OpenAI	https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT	Serviço de provedor de token dos Serviços Cognitivos do Azure	https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
PONTO_DE_ACESSO_DE_FALA_DOS_SERVIÇOS_AIS_DO_AZURE	Ponto de extremidade da API de fala para texto (padrão)	https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID	O seu ID de cliente	<client-ID>
AZURE_AISERVICES_CLIENTSECRET	O segredo do seu cliente	<client-secret>
AZURE_AISERVICES_TENANTID	O seu ID de inquilino	<tenant-ID>

Código de exemplo

Veja os passos e o código abaixo para se conectar aos Serviços de IA do Azure usando um principal de serviço.

Você pode usar a biblioteca de cliente do Azure para acessar várias APIs cognitivas suportadas pelos Serviços de IA do Azure. Usamos o Azure AI Text Analytics como um exemplo neste exemplo. Consulte Autenticar solicitações para serviços de IA do Azure para chamar as APIs cognitivas diretamente.

.NET

1. Instale as seguintes dependências. Usamos Azure.AI.TextAnalytics como exemplo.

   dotnet add package Azure.AI.TextAnalytics
   dotnet add package Azure.Identity
   

2. Autentique-se usando a biblioteca de identidade do Azure e obtenha o endpoint dos Serviços de Azure AI a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   using Azure.AI.TextAnalytics;
   using Azure.Identity;
   
   string endpoint = Environment.GetEnvironmentVariable("AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT");
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // system-assigned managed identity
   // var credential = new DefaultAzureCredential();
   
   // user-assigned managed identity
   // var credential = new DefaultAzureCredential(
   //     new DefaultAzureCredentialOptions
   //     {
   //         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
   //     });
   
   // service principal 
   // var tenantId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_TENANTID");
   // var clientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
   // var clientSecret = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTSECRET");
   // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
   
   TextAnalyticsClient languageServiceClient = new(
     new Uri(endpoint),
     credential);
   

Java

1. Adicione as seguintes dependências no arquivo pom.xml . Usamos azure-ai-textanalytics como exemplo.

   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-ai-textanalytics</artifactId>
       <version>5.1.12</version>
   </dependency>
   <dependency>
       <groupId>com.azure</groupId>
       <artifactId>azure-identity</artifactId>
       <version>1.11.4</version>
   </dependency>
   

2. Autentique-se usando azure-identity e obtenha o ponto de extremidade dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   // Uncomment the following lines corresponding to the authentication type you want to use.
   // for system-managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
   
   // for user-assigned managed identity
   // DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
   //     .managedIdentityClientId(System.getenv("AZURE_AISERVICES_CLIENTID"))
   //     .build();
   
   // for service principal
   // ClientSecretCredential credential = new ClientSecretCredentialBuilder()
   //   .clientId(System.getenv("AZURE_AISERVICES_CLIENTID"))
   //   .clientSecret(System.getenv("AZURE_AISERVICES_CLIENTSECRET"))
   //   .tenantId(System.getenv("AZURE_AISERVICES_TENANTID"))
   //   .build();
   
   String endpoint = System.getenv("AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT");
   
   TextAnalyticsClient languageClient = new TextAnalyticsClientBuilder()
       .credential(credential)
       .endpoint(endpoint)
       .buildClient();
   

Python

1. Instale as seguintes dependências. Usamos azure-ai-textanalytics como exemplo.

   pip install azure-ai-textanalytics==5.1.0
   pip install azure-identity
   

2. Autentique-se usando azure-identity e obtenha o ponto de extremidade dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   import os
   from azure.ai.textanalytics import TextAnalyticsClient
   from azure.identity import ManagedIdentityCredential, ClientSecretCredential
   
   # Uncomment the following lines corresponding to the authentication type you want to use.
   # system-assigned managed identity
   # cred = ManagedIdentityCredential()
   
   # user-assigned managed identity
   # managed_identity_client_id = os.getenv('AZURE_AISERVICES_CLIENTID')
   # cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
   
   # service principal
   # tenant_id = os.getenv('AZURE_AISERVICES_TENANTID')
   # client_id = os.getenv('AZURE_AISERVICES_CLIENTID')
   # client_secret = os.getenv('AZURE_AISERVICES_CLIENTSECRET')
   # cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
   endpoint = os.getenv('AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT')
   
   language_service_client = TextAnalyticsClient(
     endpoint=endpoint, 
     credential=cred)
   

NodeJS

1. Instale as seguintes dependências. Usamos ai-text-analytics como exemplo.

   npm install @azure/ai-text-analytics@5.1.0
   npm install @azure/identity
   

2. Autentique-se usando @azure/identity e obtenha o ponto de extremidade dos Serviços de IA do Azure a partir das variáveis de ambiente adicionadas pelo Service Connector. Ao usar o código abaixo, descomente a parte do trecho de código para o tipo de autenticação que você deseja usar.

   import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
   const { TextAnalyticsClient } = require("@azure/ai-text-analytics");
   
   // Uncomment the following lines corresponding to the authentication type you want to use.
   // for system-assigned managed identity
   // const credential = new DefaultAzureCredential();
   
   // for user-assigned managed identity
   // const clientId = process.env.AZURE_AISERVICES_CLIENTID;
   // const credential = new DefaultAzureCredential({
   //     managedIdentityClientId: clientId
   // });
   
   // for service principal
   // const tenantId = process.env.AZURE_AISERVICES_TENANTID;
   // const clientId = process.env.AZURE_AISERVICES_CLIENTID;
   // const clientSecret = process.env.AZURE_AISERVICES_CLIENTSECRET;
   // const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
   
   const endpoint = process.env.AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT;
   const languageClient = new TextAnalyticsClient(endpoint, credential);
   

Outro

Para outros idiomas, você pode usar as informações de conexão que o Service Connector define para as variáveis de ambiente para se conectar aos Serviços de IA do Azure. Para obter detalhes sobre variáveis de ambiente, consulte Integrar serviços de IA do Azure com o Service Connector.

Conteúdos relacionados

• Conectar-se a um recurso multisserviço do Azure AI
• Integração do Serviço OpenAI do Azure
• Conectar-se ao Serviço OpenAI do Azure no AKS usando uma identidade de carga de trabalho