Compartilhar via


Integrar os Serviços de IA do Azure com o Conector de Serviço

Esta página mostra os métodos de autenticação e clientes com suporte e mostra um código de exemplo que você pode usar para conectar os Serviços de IA do Azure a outros serviços de nuvem usando o Conector de Serviço. Você ainda pode se conectar aos Serviços de IA do Azure usando outros métodos. Esta página também mostra nomes e valores de variáveis de ambiente padrão que você obtém ao criar a conexão de serviço.

Serviço de computação com suporte

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

  • Serviço de Aplicativo do Azure
  • Aplicativos de Contêiner do Azure
  • Azure Functions
  • AKS (Serviço de Kubernetes do Azure)
  • Azure Spring Apps

Tipos de autenticação e tipos de cliente com suporte

A tabela abaixo mostra quais combinações de clientes e métodos de autenticação têm suporte para conectar o serviço de computação aos Serviços de IA do Azure usando o Conector de Serviço. “Sim” indica que a combinação tem suporte e “Não” indica que ela não tem.

Tipo de cliente Identidade gerenciada atribuída pelo sistema Identidade gerenciada atribuída pelo usuário Cadeia de conexão/segredo Entidade de serviço
.NET Sim Sim Sim Sim
Java Sim Sim Sim Sim
Node.js Sim Sim Sim Sim
Python Sim Sim Sim Yes
Nenhum Sim Sim Sim Yes

Essa tabela indica que todas as combinações de tipos de clientes e métodos de autenticação na tabela têm suporte. Todos os tipos de clientes podem usar qualquer um dos métodos de autenticação para se conectar aos Serviços de IA do Azure usando o Conector de Serviço.

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 saber mais sobre as convenções de nomenclatura, confira o artigo Detalhes internos no conector de serviço.

Identidade gerenciada atribuída pelo sistema

Nome da variável de ambiente padrão Descrição Valor de exemplo
AZURE_AISERVICES_OPENAI_BASE Ponto de extremidade do OpenAI do Azure 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 em Texto (Standard) https://<location>.stt.speech.microsoft.com

Código de exemplo

Veja 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 clientes do Azure para acessar várias APIs cognitivas compatíveis com os Serviços de IA do Azure. Para este exemplo, usamos a Análise de Texto de IA do Azure. Consulte Solicitações de autenticação para os serviços de IA do Azure para chamar as APIs cognitivas diretamente.

  1. Instale as dependências a seguir. 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 de extremidade dos Serviços de IA do Azure das variáveis de ambiente adicionadas pelo Conector de Serviço. Ao usar o código abaixo, descompacte a parte do snippet 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);
    

Identidade gerenciada atribuída pelo usuário

Nome da variável de ambiente padrão Descrição Valor de exemplo
AZURE_AISERVICES_OPENAI_BASE Ponto de extremidade do OpenAI do Azure 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 em Texto (Standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID Sua ID de cliente <client-ID>

Código de exemplo

Veja 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 clientes do Azure para acessar várias APIs cognitivas compatíveis com os Serviços de IA do Azure. Para este exemplo, usamos a Análise de Texto de IA do Azure. Consulte Solicitações de autenticação para os serviços de IA do Azure para chamar as APIs cognitivas diretamente.

  1. Instale as dependências a seguir. 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 de extremidade dos Serviços de IA do Azure das variáveis de ambiente adicionadas pelo Conector de Serviço. Ao usar o código abaixo, descompacte a parte do snippet 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);
    

Cadeia de conexão

Nome da variável de ambiente padrão Descrição Valor de exemplo
AZURE_AISERVICES_OPENAI_BASE Ponto de extremidade do OpenAI do Azure 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 em Texto (Standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_KEY Chave de API dos Serviços de IA do Azure <api-key>

Exemplo de código

Veja 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 clientes do Azure para acessar várias APIs cognitivas compatíveis com os Serviços de IA do Azure. Para este exemplo, usamos a Análise de Texto de IA do Azure. Consulte Solicitações de autenticação para os serviços de IA do Azure para chamar as APIs cognitivas diretamente.

  1. Instale as dependências a seguir. 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 Conector de Serviço.

    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));
    

Entidade de serviço

Nome da variável de ambiente padrão Descrição Valor de exemplo
AZURE_AISERVICES_OPENAI_BASE Ponto de extremidade do OpenAI do Azure 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 em Texto (Standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID Sua ID de cliente <client-ID>
AZURE_AISERVICES_CLIENTSECRET Seu segredo do cliente <client-secret>
AZURE_AISERVICES_TENANTID Sua ID de locatário <tenant-ID>

Código de exemplo

Veja as etapas e o código abaixo para se conectar aos Serviços de IA do Azure usando uma entidade de serviço.

Você pode usar a biblioteca de clientes do Azure para acessar várias APIs cognitivas compatíveis com os Serviços de IA do Azure. Para este exemplo, usamos a Análise de Texto de IA do Azure. Consulte Solicitações de autenticação para os serviços de IA do Azure para chamar as APIs cognitivas diretamente.

  1. Instale as dependências a seguir. 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 de extremidade dos Serviços de IA do Azure das variáveis de ambiente adicionadas pelo Conector de Serviço. Ao usar o código abaixo, descompacte a parte do snippet 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);
    

Próximas etapas

Siga os tutoriais listados abaixo para saber mais sobre o Conector de Serviço.