Integrar los Servicios de Azure AI con el Conector de servicio
Artículo
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
Sí
Sí
Sí
Sí
Java
Sí
Sí
Sí
Sí
Node.js
Sí
Sí
Sí
Sí
Python
Sí
Sí
Sí
Sí
None
Sí
Sí
Sí
Sí
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.
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.
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);
Agregue las siguientes dependencias en el archivo pom.xml. Se usa azure-ai-textanalytics como ejemplo.
Autentíquese mediante azure-identity y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por 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.
// 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();
Instale las siguientes dependencias. Se usa azure-ai-textanalytics como ejemplo.
Autentíquese mediante azure-identity y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por 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.
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)
Instale las siguientes dependencias. Se usa ai-text-analytics como ejemplo.
Autentíquese mediante @azure/identity y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por 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.
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);
Para otros lenguajes, puede usar la información de conexión que el Conector de servicio establece en las variables de entorno para conectarse a los Servicios de Azure AI. Para más información sobre las variables de entorno, consulte la Integración de Servicios de Azure AI con el Conector de servicio.
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.
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);
Agregue las siguientes dependencias en el archivo pom.xml. Se usa azure-ai-textanalytics como ejemplo.
Autentíquese mediante azure-identity y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por 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.
// 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();
Instale las siguientes dependencias. Se usa azure-ai-textanalytics como ejemplo.
Autentíquese mediante azure-identity y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por 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.
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)
Instale las siguientes dependencias. Se usa ai-text-analytics como ejemplo.
Autentíquese mediante @azure/identity y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por 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.
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);
Para otros lenguajes, puede usar la información de conexión que el Conector de servicio establece en las variables de entorno para conectarse a los Servicios de Azure AI. Para más información sobre las variables de entorno, consulte la Integración de Servicios de Azure AI con el Conector de servicio.
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.
Para otros lenguajes, puede usar la información de conexión que el Conector de servicio establece en las variables de entorno para conectarse a los Servicios de Azure AI. Para más información sobre las variables de entorno, consulte la Integración de Servicios de Azure AI con el Conector de servicio.
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.
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);
Agregue las siguientes dependencias en el archivo pom.xml. Se usa azure-ai-textanalytics como ejemplo.
Autentíquese mediante azure-identity y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por 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.
// 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();
Instale las siguientes dependencias. Se usa azure-ai-textanalytics como ejemplo.
Autentíquese mediante azure-identity y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por 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.
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)
Instale las siguientes dependencias. Se usa ai-text-analytics como ejemplo.
Autentíquese mediante @azure/identity y obtenga el punto de conexión de los Servicios de Azure AI de las variables de entorno agregadas por 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.
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);
Para otros lenguajes, puede usar la información de conexión que el Conector de servicio establece en las variables de entorno para conectarse a los Servicios de Azure AI. Para más información sobre las variables de entorno, consulte la Integración de Servicios de Azure AI con el Conector de servicio.
Pasos siguientes
Para más información sobre el conector de servicio, siga el tutorial que se muestra a continuación.