Partilhar via


Integrar os serviços de IA do Azure com o Service Connector

Esta página mostra os métodos de autenticação e os clientes suportados e mostra o código de exemplo que pode utilizar para ligar os Serviços de IA do Azure a outros serviços na nuvem utilizando o Service Connector. Talvez você ainda consiga 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 quando cria 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 mostra quais combinações de métodos de autenticação e clientes têm suporte para conectar seu serviço de computação aos Serviços de IA do Azure 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 pelo sistema Identidade gerida atribuída pelo utilizador Segredo/cadeia de conexão Service principal (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 gerida atribuída pelo sistema

Nome da variável de ambiente padrão Description 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.

  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 de extremidade dos Serviços Azure AI 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);
    

Identidade gerida atribuída pelo utilizador

Nome da variável de ambiente padrão Description 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.

  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 de extremidade dos Serviços Azure AI 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);
    

Connection string

Nome da variável de ambiente padrão Description 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_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.

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

Service principal (Principal de serviço)

Nome da variável de ambiente padrão Description 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>
AZURE_AISERVICES_CLIENTSECRET O segredo do seu cliente <client-secret>
AZURE_AISERVICES_TENANTID O seu ID de inquilino <tenant-ID>

Código de exemplo

Consulte as etapas 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.

  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 de extremidade dos Serviços Azure AI 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);
    

Próximos passos

Siga o tutorial listado abaixo para saber mais sobre o Service Connector.