Asociación de un recurso de varios servicios de Azure AI a un conjunto de aptitudes en Azure AI Search

Artículo
11/19/2024

Al configurar una canalización de enriquecimiento con IA opcional en Azure AI Search, se puede enriquecer un pequeño número de documentos de forma gratuita, limitado a 20 transacciones diarias por índice. Para cargas de trabajo mayores y más frecuentes, debería adjuntar un recurso multiservicio facturable de Azure AI.

Una cuenta de varios servicios proporciona una colección de servicios de Azure AI, en lugar de servicios individuales. Proporcionar una cuenta en un conjunto de aptitudes de Búsqueda de Azure AI permite a Microsoft cobrarle por usar estos servicios:

Visión de Azure AI para el análisis de imágenes, el reconocimiento óptico de caracteres (OCR) e inserción multimodal de texto e imagen.
Lenguaje de Azure AI para la detección de idioma, el reconocimiento de entidades, el análisis de sentimiento y la extracción de frases clave
Voz de Azure AI para conversión de voz en texto y texto a voz
Traductor de Azure AI para la traducción automática de texto

Debe proporcionar información de conexión al recurso múltiple de Azure AI en el conjunto de aptitudes. La Búsqueda de Azure AI no usa la conexión para cargas de trabajo del conjunto de aptitudes, pero sí la usa para acceder a los medidores de facturación del recurso. Por lo tanto, la cuenta de servicios de Azure AI se usa para la facturación, no para el procesamiento de aptitudes. La Búsqueda de Azure AI usa recursos dedicados independientes para el procesamiento de aptitudes.

Puede usar una clave en la conexión o implementar un enfoque sin claves que esté actualmente en versión preliminar.

Sugerencia

Azure proporciona infraestructura para supervisar la facturación y los presupuestos. Para más información sobre la supervisión de los servicios de Azure AI, consulte Planeamiento y administración de los costos de los servicios de Azure AI.

Requisitos previos

Conectividad a través de un punto de conexión público, a menos que el servicio de búsqueda cumpla los requisitos de fecha de creación, nivel y región para las conexiones privadas a una cuenta de varios servicios de Azure AI.

Nota:

Si el recurso de Azure AI está configurado para usar un punto de conexión privado, la Búsqueda de Azure AI puede conectarse mediante un vínculo privado compartido si el servicio de búsqueda se creó después del 3 de abril de 2024 y se encuentra en una región que proporciona mayor capacidad de proceso y está en un nivel compatible. Para más información, consulte los requisitos para usar vínculos privados compartidos.

Facturar a través de una conexión sin claves

Nota:

Esta característica actualmente está en su versión preliminar pública. Esta versión preliminar se ofrece sin contrato de nivel de servicio y no es aconsejable usarla para cargas de trabajo de producción. Es posible que algunas características no sean compatibles o que tengan sus funcionalidades limitadas. Para más información, consulte Términos de uso complementarios de las Versiones Preliminares de Microsoft Azure.

Con Azure Portal o las API de REST en versión preliminar más recientes y los paquetes beta del SDK, puede adjuntar un recurso de varios servicios de Azure AI mediante una identidad administrada y permisos. La ventaja de este enfoque es que la facturación es sin clave y no depende nada de las regiones.

Configure la Búsqueda de Azure AI para usar una identidad administrada.
En el recurso de varios servicios de Azure AI, asigne la identidad al rol Usuario de Cognitive Services.
Con Azure Portal o la API de REST del conjunto de aptitudes 2024-11-01-preview, o bien un paquete beta del SDK de Azure que proporciona la sintaxis, configure un conjunto de aptitudes para usar una identidad:
- La identidad administrada usada en la conexión pertenece al servicio de búsqueda.
- La identidad puede estar administrada por el sistema o asignada por el usuario.
- La identidad administrada debe tener permisos de usuario de Cognitive Services en el recurso de Azure AI.
- @odata.type siempre es #Microsoft.Azure.Search.AIServicesByIdentity.
- subdomainUrl es el punto de conexión del recurso de varios servicios de Azure AI. Puede estar en cualquier región que se admita conjuntamente en la Búsqueda de Azure AI y en los servicios de Azure AI.

Al igual que con las claves, los detalles que proporcione sobre el recurso de los servicios de Azure AI se usan para la facturación, no para las conexiones. Todas las solicitudes de API realizadas por la Búsqueda de Azure AI a los servicios de Azure AI para el procesamiento de aptitudes integradas siguen siendo internas y están administradas por Microsoft.

Ejemplo: identidad administrada asignada por el sistema

La identidad se establece en null.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": null 
    }  
}

Ejemplo: identidad administrada asignada por el usuario

La identidad se establece en el identificador del recursos de la identidad administrada asignada por el usuario. Para encontrar una identidad administrada asignada por el usuario existente, consulte Administración de identidades administradas asignadas por el usuario.

Para una identidad administrada asignada por el usuario, establezca las propiedades @odata.type y userAssignedIdentity.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": {   
            "@odata.type":  "#Microsoft.Azure.Search.DataUserAssignedIdentity",   
            "userAssignedIdentity": ""/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-assigned-managed-identity-name}"" 
        }
    } 
}

Facturar a través de una clave de recurso

La Búsqueda de Azure AI también puede cobrar por la transacción mediante la clave de recursos de varios servicios de Azure AI. Este enfoque es el predeterminado y está disponible con carácter general. Puede usar Azure Portal, la API de REST o un SDK de Azure para agregar la clave a un conjunto de aptitudes.

Solo tiene que agregar la clave, no el subdominio ni el punto de conexión. Si deja la propiedad cognitiveServices sin especificar, el servicio de búsqueda intenta usar los enriquecimientos gratuitos disponibles para el indexador diariamente. La ejecución de aptitudes facturables se detiene en 20 transacciones por invocación del indizador y aparece un mensaje de tiempo de espera agotado en el historial de ejecución del indizador.

Inicie sesión en Azure Portal.
Cree un recurso multiservicio de Azure AI en la misma región que su servicio de búsqueda.
Obtenga la clave de recurso de la página Recursos>Claves y puntos de conexión.
Agregue la clave a la definición de un conjunto de aptitudes:
- Si usa un asistente para importación de datos, cree o seleccione la cuenta de Azure AI. El asistente agrega la clave de recurso a la definición del conjunto de aptitudes.
- Para un conjunto de aptitudes nuevo o existente, proporcione la clave en la definición del conjunto de aptitudes.

Use la API Crear o actualizar conjunto de aptitudes y especifique la sección cognitiveServices en el cuerpo de la solicitud:

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-07-01
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
        "categories": [ "Organization" ],
        "defaultLanguageCode": "en",
        "inputs": [
          {
            "name": "text", "source": "/document/content"
          }
        ],
        "outputs": [
          {
            "name": "organizations", "targetName": "organizations"
          }
        ]
      }
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
        "description": "mycogsvcs",
        "key": "<your key goes here>"
    }
}

El fragmento de código siguiente proviene de azure-search-dotnet-samples y se recortó para mayor brevedad.

IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json");
IConfigurationRoot configuration = builder.Build();

string searchServiceUri = configuration["SearchServiceUri"];
string adminApiKey = configuration["SearchServiceAdminApiKey"];
string cognitiveServicesKey = configuration["CognitiveServicesKey"];

SearchIndexerClient indexerClient = new SearchIndexerClient(new Uri(searchServiceUri), new AzureKeyCredential(adminApiKey));

// Create the skills
Console.WriteLine("Creating the skills...");
OcrSkill ocrSkill = CreateOcrSkill();
MergeSkill mergeSkill = CreateMergeSkill();

// Create the skillset
Console.WriteLine("Creating or updating the skillset...");
List<SearchIndexerSkill> skills = new List<SearchIndexerSkill>();
skills.Add(ocrSkill);
skills.Add(mergeSkill);

SearchIndexerSkillset skillset = CreateOrUpdateDemoSkillSet(indexerClient, skills, cognitiveServicesKey);

Quitar la clave

Los enriquecimientos son operaciones que se pueden facturar. Si ya no necesita llamar a los servicios de Azure AI, siga estas instrucciones para quitar la clave de varios servicios y evitar el uso del recurso externo. Sin la clave, el conjunto de aptitudes vuelve a la asignación predeterminada de 20 transacciones gratuitas por indizador, por día. La ejecución de aptitudes facturables se detiene en 20 transacciones y aparece un mensaje de tiempo de espera en el historial de ejecución del indizador cuando se usa la asignación.

Azure Portal
REST

Inicie sesión en Azure Portal.
En Administración de búsqueda > conjuntos de aptitudes, seleccione un conjunto de aptitudes de la lista.
Desplácese hasta la sección del archivo que contiene "cognitiveServices".
Elimine el valor de clave del JSON y guarde el conjunto de aptitudes.

Get Skillset para tener la definición completa.
Formule una solicitud Actualizar conjunto de aptitudes, proporcionando la definición JSON del conjunto de aptitudes.

Quite la clave en el cuerpo de la definición y envíe la solicitud:

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-07-01
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
        "categories": [ "Organization" ],
        "defaultLanguageCode": "en",
        "inputs": [
          {
            "name": "text", "source": "/document/content"
          }
        ],
        "outputs": [
          {
            "name": "organizations", "targetName": "organizations"
          }
        ]
      }
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
        "description": "mycogsvcs",
        "key": ""
    }
}

Como alternativa, puede establecer "cognitiveServices" en null:

"cognitiveServices": null,

Uso de la clave

La facturación se aplica cuando las llamadas de API a los recursos de los servicios de Azure AI superan las 20 llamadas de API por indexador, al día. Puede restablecer el indizador para restablecer el recuento de API.

Las conexiones sin claves y con claves se usan para la facturación, pero no para las conexiones de las operaciones de enriquecimiento. En las conexiones, un servicio de búsqueda se conecta a través de la red interna a un recurso de servicios de Azure AI que está colocado en la misma región física. La mayoría de las regiones que ofrecen Azure AI Search también ofrecen otros servicios de Azure AI, como Lenguaje. Si intenta usar el enriquecimiento con IA en una región que no tenga ambos servicios, verá este mensaje: "La clave proporcionada no es una clave de tipo CognitiveServices válida para la región del servicio de búsqueda".

Los indexadores se pueden configurar para que se ejecuten en un entorno de ejecución privado para el procesamiento dedicado solo mediante los nodos de búsqueda de su propio servicio de búsqueda. Incluso si usa un entorno de ejecución privado, la Búsqueda de Azure AI sigue usando su recurso de varios servicios de Azure AI aprovisionado internamente para realizar todos los enriquecimientos de aptitudes.

Nota:

Algunas aptitudes integradas se basan en servicios de Azure AI no regionales (por ejemplo, la aptitud de traducción de texto). El uso de una habilidad no regional implica que la solicitud podría ser atendida en una región distinta de la región de Azure AI Search. Para más información sobre los servicios no regionales, consulte la página de Servicios de Azure AI por región.

Requisitos de la conexión pública

En función de cuándo se creó el servicio de búsqueda y su nivel y región, la facturación de aptitudes integradas puede requerir una conexión pública desde la Búsqueda de Azure AI al recurso de varios servicios de Azure AI. Deshabilitar el acceso a la red pública interrumpe la facturación en algunos escenarios. Revise los requisitos de conexiones a través de un vínculo privado compartido para determinar si el servicio de búsqueda requiere una conexión pública.

Si no puede usar la red pública, puede configurar una aptitud de API web personalizada implementada con una función de Azure compatible con puntos de conexión privados y agregar el recurso de servicios de Azure AI a la misma red virtual. De este modo, puede llamar al recurso de servicios de Azure AI directamente desde la aptitud personalizada mediante puntos de conexión privados.

Casos especiales con requisitos clave

La búsqueda de entidades personalizada está medida por Azure AI Search, no por los servicios de Azure AI, pero requiere una clave de recurso multiservicio de Azure AI para desbloquear transacciones más allá de 20 por indizador, por día. Solo para esta aptitud, la clave de recurso desbloquea el número de transacciones, pero no está relacionada con la facturación.

Enriquecimientos gratuitos

El enriquecimiento con IA ofrece una pequeña cantidad de procesamiento gratuito de enriquecimientos facturables para que pueda completar ejercicios cortos sin tener que adjuntar un recurso multiservicio de Azure AI. Los enriquecimientos gratuitos son 20 documentos al día por cada indizador. Puede restablecer el indizador para restablecer el contador si desea repetir un ejercicio.

Algunos enriquecimientos siempre son gratuitos:

Las aptitudes de utilidad que no llaman a servicios de Azure AI (concretamente, las aptitudes Condicional, Extracción de documentos, Conformador, Combinación de texto y División de texto) no son facturables.
La extracción de texto de documentos PDF y otros archivos de aplicación no es facturable. La extracción de texto, que se produce durante el descifrado de documentos, no es un enriquecimiento con la IA, pero se produce durante el enriquecimiento con IA y, por consiguiente, se indica aquí.

Enriquecimientos facturables

Durante el enriquecimiento con IA, Azure AI Search llama a las API de servicios de Azure AI para aptitudes integradas que se basan en Visión de Azure AI, Translator y Lenguaje de Azure AI.

Las aptitudes integradas facturables que hacen llamadas de back-end a servicios de Azure AI incluyen Vinculación de entidad, Reconocimiento de entidades, Análisis de imágenes, Extracción de frases clave, Detección de idioma, OCR, Detección de información de identificación personal (PII), Opinión y Traducción de texto.

La extracción de imágenes es una operación de Azure AI Search que se produce al descifrar documentos antes del enriquecimiento. La extracción de imágenes se factura en todos los niveles, a excepción de 20 extracciones diarias gratuitas en el nivel gratuito. Los costes de extracción de imágenes se aplican a los archivos de imagen dentro de blobs, a las imágenes insertadas en otros archivos (archivos PDF y otros archivos de aplicación) y a las imágenes extraídas mediante Extracción de documentos. Para ver los precios de la extracción de imágenes, consulte la página de precios de Azure AI Search.

Sugerencia

Para reducir el coste del procesamiento del conjunto de habilidades, habilite el enriquecimiento incremental para almacenar en caché y reutilizar cualquier enriquecimiento que no se vea afectado por los cambios realizados en un conjunto de habilidades. El almacenamiento en caché requiere Azure Storage (consulte los precios), pero el costo acumulado de la ejecución del conjunto de aptitudes es menor si se pueden reutilizar los enriquecimientos existentes, especialmente en los que usan extracción de imágenes y análisis.

Ejemplo: estimación de costos

Para calcular los costos asociados con la indexación de Azure AI Search, empiece con una idea de cómo debe verse un documento promedio para que pueda ejecutar algunos números. Un cálculo aproximado, por ejemplo, sería:

1000 archivos PDF.
Seis páginas cada uno.
Una imagen por página (6000 imágenes).
3000 caracteres por página.

Supongamos que hay una canalización que consta del descifrado de cada documento PDF con extracción de imágenes y texto, reconocimiento óptico de caracteres (OCR) de las imágenes y reconocimiento de entidad de las organizaciones.

Los precios mostrados en este artículo son hipotéticos. Se usan para ilustrar el proceso de estimación. Sus costos podrían ser más bajos. Para conocer el precio real de las transacciones, consulte Precios de los servicios de Azure AI.

Para el descifrado de documentos con contenido de texto e imagen, la extracción de texto actualmente es gratis. Para 6000 imágenes, suponga 1 USD por cada 1000 imágenes extraídas. Eso es un costo de 6 USD para este paso.
Para realizar el reconocimiento óptico de caracteres (OCR) de 6000 imágenes en inglés, la aptitud de reconocimiento de OCR usa el mejor algoritmo (DescribeText). Suponiendo un precio de 2,50 USD por cada 1000 imágenes que se analizan, tendríamos que pagar 15,00 USD en este paso.
Para la extracción de entidades, tendríamos un total de tres registros de texto por página. Cada registro tiene 1000 caracteres. Tres registros de texto por página multiplicados por 6000 páginas equivalen a 18 000 registros de texto. Suponiendo un costo de 2,00 USD por cada 1,000 registros de texto, en este paso tendríamos un costo de 36,00 USD.

En resumen, pagaría unos 57 USD por la ingesta de 1000 documentos PDF de este tipo con el conjunto de aptitudes descrito.

Compartir a través de

Asociación de un recurso de varios servicios de Azure AI a un conjunto de aptitudes en Azure AI Search

Requisitos previos

Facturar a través de una conexión sin claves

Ejemplo: identidad administrada asignada por el sistema

Ejemplo: identidad administrada asignada por el usuario

Facturar a través de una clave de recurso

Quitar la clave

Uso de la clave

Requisitos de la conexión pública

Casos especiales con requisitos clave

Enriquecimientos gratuitos

Enriquecimientos facturables

Ejemplo: estimación de costos

Pasos siguientes

Comentarios

Recursos adicionales