Compartir a través de


Integrar los Servicios de Azure AI con el Conector de servicio

En esta página se muestran los métodos de autenticación y los clientes admitidos y se muestra el código de ejemplo que puede usar para conectar los Servicios de Azure AI a otros servicios en la nube mediante Service Connector. Es posible que todavía pueda conectarse a los Servicios de Azure AI mediante otros métodos. Esta página también muestra los nombres y valores predeterminados de las variables de entorno que se obtiene al crear la conexión de servicio.

Servicios de proceso admitidos

Service Connector se puede usar para conectar los siguientes servicios de proceso a los Servicios de Azure AI:

  • Azure App Service
  • Azure Container Apps
  • Funciones de Azure
  • Azure Kubernetes Service (AKS)
  • Azure Spring Apps

Tipos de autenticación y tipos de cliente admitidos

La siguiente tabla muestra qué combinaciones de métodos de autenticación y clientes se admiten para conectar su servicio de cómputo a los Servicios de Azure AI Services mediante el Conector de servicio. Un valor "Sí" indica que se admite la combinación, mientras que "No" indica que no se admite.

Tipo de cliente Identidad administrada asignada por el sistema Identidad administrada asignada por el usuario Secreto/cadena de conexión Entidad de servicio
.NET
Java
Node.js
Python
None

Esta tabla indica que todas las combinaciones de tipos de cliente y métodos de autenticación de la tabla son compatibles. Todos los tipos de cliente pueden usar cualquiera de los métodos de autenticación para conectarse a los Servicios de Azure AI mediante el Conector de servicio.

Nombres de variables de entorno predeterminados o propiedades de aplicación y código de ejemplo

Use los detalles de conexión siguientes para conectar los servicios de proceso a los Servicios de Azure AI. Para más información sobre las convenciones de nomenclatura, consulte el artículo sobre los elementos internos del conector de servicio.

Identidad administrada asignada por el sistema

Nombre de la variable de entorno predeterminado Descripción Valor de ejemplo
AZURE_AISERVICES_OPENAI_BASE Punto de conexión de Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Servicio de proveedor de tokens de Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Extremo de API de conversión de voz en texto (estándar) https://<location>.stt.speech.microsoft.com

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a los Servicios de Azure AI mediante una identidad administrada asignada por el sistema.

Puede usar la biblioteca cliente de Azure para acceder a varias API cognitivas compatibles con los Servicios de Azure AI. En esta muestra se usa Text Analytics de Azure AI como ejemplo. Consulte Autenticación de solicitudes a los servicios de Azure AI para llamar directamente a las API cognitivas.

  1. Instale las siguientes dependencias. Se usa Azure.AI.TextAnalytics como ejemplo.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Autentíquese mediante la biblioteca de identidades de Azure y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por el Conector de servicio. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea 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);
    

Identidad administrada asignada por el usuario

Nombre de la variable de entorno predeterminado Descripción Valor de ejemplo
AZURE_AISERVICES_OPENAI_BASE Punto de conexión de Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Servicio de proveedor de tokens de Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Extremo de API de conversión de voz en texto (estándar) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID Id. de cliente <client-ID>

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a los Servicios de Azure AI mediante una identidad administrada asignada por el usuario.

Puede usar la biblioteca cliente de Azure para acceder a varias API cognitivas compatibles con los Servicios de Azure AI. En esta muestra se usa Text Analytics de Azure AI como ejemplo. Consulte Autenticación de solicitudes a los servicios de Azure AI para llamar directamente a las API cognitivas.

  1. Instale las siguientes dependencias. Se usa Azure.AI.TextAnalytics como ejemplo.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Autentíquese mediante la biblioteca de identidades de Azure y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por el Conector de servicio. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea 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);
    

Cadena de conexión

Nombre de la variable de entorno predeterminado Descripción Valor de ejemplo
AZURE_AISERVICES_OPENAI_BASE Punto de conexión de Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Servicio de proveedor de tokens de Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Extremo de API de conversión de voz en texto (estándar) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_KEY Clave de API de los Servicios de Azure AI <api-key>

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a los Servicios de Azure AI mediante una cadena de conexión.

Puede usar la biblioteca cliente de Azure para acceder a varias API cognitivas compatibles con los Servicios de Azure AI. En esta muestra se usa Text Analytics de Azure AI como ejemplo. Consulte Autenticación de solicitudes a los servicios de Azure AI para llamar directamente a las API cognitivas.

  1. Instale las siguientes dependencias. Se usa Azure.AI.TextAnalytics como ejemplo.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Core --version 1.40.0
    
  2. Obtenga el punto de conexión y la clave de los Servicios de Azure AI de las variables de entorno agregadas por el Conector de servicio.

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

Entidad de servicio

Nombre de la variable de entorno predeterminado Descripción Valor de ejemplo
AZURE_AISERVICES_OPENAI_BASE Punto de conexión de Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Servicio de proveedor de tokens de Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Extremo de API de conversión de voz en texto (estándar) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID Id. de cliente <client-ID>
AZURE_AISERVICES_CLIENTSECRET Secreto de cliente <client-secret>
AZURE_AISERVICES_TENANTID El identificador de inquilino <tenant-ID>

Código de ejemplo

Consulte los pasos y el código siguientes para conectarse a los Servicios de Azure AI mediante una entidad de servicio.

Puede usar la biblioteca cliente de Azure para acceder a varias API cognitivas compatibles con los Servicios de Azure AI. En esta muestra se usa Text Analytics de Azure AI como ejemplo. Consulte Autenticación de solicitudes a los servicios de Azure AI para llamar directamente a las API cognitivas.

  1. Instale las siguientes dependencias. Se usa Azure.AI.TextAnalytics como ejemplo.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Autentíquese mediante la biblioteca de identidades de Azure y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por el Conector de servicio. Al usar el código siguiente, quite la marca de comentario de la parte del fragmento de código para el tipo de autenticación que desea 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);
    

Pasos siguientes

Para más información sobre el conector de servicio, siga el tutorial que se muestra a continuación.