Asociar un recurso facturable a un conjunto de habilidades en Búsqueda de Azure AI

Si usa aptitudes integradas para el enriquecimiento de AI en Búsqueda de Azure AI, puede enriquecer un pequeño número de documentos de forma gratuita, hasta 20 transacciones por índice al día. Para cargas de trabajo mayores o más frecuentes, debe vincular un recurso de Microsoft Foundry facturable a su conjunto de habilidades.

Búsqueda de Azure AI usa recursos dedicados hospedados internamente para ejecutar aptitudes integradas respaldadas por Foundry Tools y requiere un recurso Foundry únicamente con fines de facturación. La excepción es la habilidad Azure Content Understanding, que usa tu recurso tanto para la facturación como para el procesamiento.

Un recurso Foundry proporciona acceso a varios servicios dentro de Las herramientas de Foundry. Al especificarlo en un conjunto de aptitudes, Microsoft puede cobrarle por el uso de los siguientes servicios:

• Azure Vision in Foundry Tools para el análisis de imágenes, el reconocimiento óptico de caracteres (OCR) y las incrustaciones multiplataforma.
• Azure Language in Foundry Tools para la detección de idioma, el reconocimiento de entidades, el análisis de sentimiento y la extracción de frases clave.
• Azure Translator en Foundry Tools para la traducción de texto automático.

El procesamiento del conjunto de aptitudes se factura al servicio subyacente de cada aptitud. Búsqueda de Azure AI consolida cargos para Foundry Tools en un único recurso de Foundry. Por ejemplo, si usa las aptitudes Image Analysis y Language Detection, los cargos por Azure Vision y Azure Language aparecen en la misma factura del recurso Foundry. Todos los demás recursos se facturan de forma independiente.

Para adjuntar un recurso Foundry, proporcione información de conexión en el conjunto de habilidades. Puede usar un enfoque basado en claves o sin claves.

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 un recurso Foundry.

• Un recurso Foundry con el tipo de AIServices API. Puede comprobar el tipo de API en la página Overview del recurso en el portal de Azure:

  

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

Puede usar una identidad administrada y permisos para adjuntar un recurso Foundry. La ventaja de este enfoque es que la facturación no tiene clave y no tiene requisitos de región.

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

Para facturar a través de una conexión sin claves:

1. En el servicio Búsqueda de Azure AI, configurar una identidad administrada. Se admiten identidades asignadas por el sistema y asignadas por el usuario.

2. En tu recurso Foundry, asigne el rol Cognitive Services User a la identidad administrada de tu servicio de búsqueda.

3. Configure un conjunto de aptitudes para usar la identidad administrada. Puede usar el portal de Azure, la versión estable más reciente de Skillsets- Create Or Update (API REST) o un paquete de SDK de Azure que proporcione la sintaxis.

   • @odata.type siempre es #Microsoft.Azure.Search.AIServicesByIdentity.

   • subdomainUrl es el punto final de tu recurso Foundry. Puede usar el formato https://<resource-name>.services.ai.azure.com o https://<resource-name>.cognitiveservices.azure.com, ambos disponibles en la página Keys y Endpoint del portal de Azure.

   • Otras propiedades son específicas del tipo de identidad administrada, como se muestra en los siguientes ejemplos de API REST.

   • Identidad administrada asignada por el sistema
   • Identidad administrada asignada por el usuario

   Esta es una configuración de conjunto de aptitudes de ejemplo para una identidad administrada asignada por el sistema. En este escenario, debe establecer identity en null.

   POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
   api-key: [admin-key]
   Content-Type: application/json
   
   {
     "name": "my-skillset",
     "skills": [
       // Skills definition goes here
     ],
     "cognitiveServices": {
       "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",
       "description": "A sample configuration for a system-assigned managed identity.",
       "subdomainUrl": "https://[resource-name].services.ai.azure.com",
       "identity": null
     }
   }
   

Facturar a través de una clave de recurso

De forma predeterminada, Búsqueda de Azure AI cobra por las transacciones mediante el uso de la clave de un recurso Foundry. Este enfoque está disponible con carácter general. Puede usar el portal de Azure, una versión estable de la API REST o un SDK de Azure equivalente para agregar la clave a un conjunto de aptitudes.

Hay dos tipos de clave admitidos:

• #Microsoft.Azure.Search.CognitiveServicesByKey llama al punto de conexión regional.
• #Microsoft.Azure.Search.AIServicesByKey llama al subdominio. Se recomienda este tipo porque admite vínculos privados compartidos y no tiene requisitos regionales relativos al servicio de búsqueda.

El recurso Foundry debe estar en la misma región que el servicio de búsqueda. Elija una región de Búsqueda de Azure AI que ofrezca integración con Foundry Tools, lo cual se indica en la columna de enriquecimiento de IA. Para obtener más información sobre el requisito de la misma región, consulte Cómo se utiliza la clave.

Si no especifica la cognitiveServices propiedad, el servicio de búsqueda intenta usar los enriquecimientos gratuitos disponibles para su indexador cada día. 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.

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2026-04-01
api-key: [admin-key]
Content-Type: application/json
{
    "name": "my-skillset",
    "skills": 
    [
      // Skills definition goes here
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByKey",
        "description": "A sample configuration for key-based billing.",
        "subdomainUrl": "https://[resource-name].services.ai.azure.com",
        "key": "{your-billable-resource-key}"
    }
}

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 facturables. Si ya no necesita llamar a Foundry Tools, siga estas instrucciones para quitar la clave y evitar el uso del recurso Foundry.

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 agotarse el tiempo de espera en el historial de ejecución del indexador cuando se usa la asignación.

Cómo se usa la clave

La facturación entra en vigor cuando las llamadas API a un recurso Foundry superan las 20 veces por indexador al día. Puede restablecer el indexador para restablecer el recuento de API.

Las conexiones sin claves y basadas en claves se usan para la facturación, pero no para las conexiones relacionadas con las operaciones de enriquecimiento.

Para las conexiones basadas en claves, un servicio de búsqueda se conecta a través de la red interna a un recurso Foundry ubicado en la misma región física. La mayoría de las regiones que ofrecen Búsqueda de Azure AI también ofrecen otros servicios de Azure. Si intenta el enriquecimiento con IA en una región que no tiene 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".

Para las conexiones sin claves, un servicio de búsqueda se autentica mediante su asignación de identidades y roles y tiene como destino un recurso Foundry. El recurso se especifica como un URI completo y el URI incluye un subdominio único.

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

Requisitos de conexión pública

Dependiendo de cuándo se creó el servicio de búsqueda, su plan de tarifa y su región, la facturación de habilidades integradas puede requerir una conexión pública desde Búsqueda de Azure AI a su recurso Foundry. Deshabilitar el acceso a la red pública interrumpe la facturación en algunos escenarios. Revise los requisitos de las 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 utilizar la red pública, puede configurar una aptitud de la API web personalizada implementada con una Azure Function que admita puntos de conexión privados y agregar el recurso Foundry a la misma red virtual. En este escenario, puede llamar al recurso Foundry directamente desde la aptitud personalizada mediante puntos de conexión privados.

Casos especiales de requisitos clave

Custom Entity Lookup se mide por Búsqueda de Azure AI, pero requiere una clave de recurso Foundry para desbloquear transacciones más allá de 20 por indexador al día. Solo para esta habilidad, la clave de recurso desbloquea el número de transacciones, pero no tiene relación con la facturación.

Enriquecimientos gratuitos

El enriquecimiento con IA ofrece una pequeña cantidad de procesamiento gratuito de enriquecimientos que normalmente serían facturables, de modo que puede completar ejercicios breves sin necesidad de adjuntar un recurso externo. Los enriquecimientos gratuitos son 20 documentos por indexador al día. Puede restablecer el indexador para restablecer el contador si desea repetir un ejercicio.

Algunos enriquecimientos siempre son gratuitos:

• Las aptitudes de utilidad que no llaman a Foundry Tools (es decir, las aptitudes Condicional, Extracción de documentos, Conformador, Combinación de texto y División de texto ) no se pueden facturar.

• La extracción de texto de documentos PDF y otros archivos de aplicación no se pueden facturar. La extracción de texto, que se produce durante el descifrado de documentos, no es un enriquecimiento con IA, pero se produce durante el enriquecimiento con IA y, por tanto, se indica aquí.

Enriquecimientos facturables

Durante el enriquecimiento con IA, Búsqueda de Azure AI llama a las API para aptitudes integradas basadas en Azure Vision, Azure Language y Azure Translator.

Las aptitudes integradas facturables que realizan llamadas de back-end a servicios externos incluyen:

• Vinculación de entidades
• 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
• Traducción de texto
• Incrustaciones multimodales de Azure Vision

Un vectorizador en tiempo de consulta respaldado por el modelo de inserción multimodal de Visión de Azure también es un enriquecimiento facturable.

La extracción de imágenes es una operación de Búsqueda de Azure AI que se produce cuando los documentos se descifran antes del enriquecimiento. La extracción de imágenes se factura en todos los planes de tarifa, excepto en 20 extracciones diarias gratuitas en el nivel gratuito. Los costos de extracción de imágenes se aplican a los archivos de imagen dentro de blobs, a las imágenes incrustadas en otros archivos (PDF y otros archivos de aplicación) y a las imágenes extraídas mediante Extracción de Documentos. Para obtener los precios de extracción de imágenes, consulte la página de precios Búsqueda de Azure AI.

Ejemplo: Estimación de costos

Los precios que se muestran en esta sección son hipotéticos y se usan para ilustrar el proceso de estimación. Los costos podrían ser menores. Para obtener el precio real de las transacciones, consulte Precios de Foundry Tools.

Para calcular los costos asociados con la indexación de Búsqueda de Azure AI, comience con una idea de cómo es un documento promedio para poder hacer algunos cálculos. Por ejemplo, puede aproximarse a:

• 1,000 archivos pdf
• Seis páginas cada una
• 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, OCR de las imágenes y reconocimiento de entidad de las organizaciones.

1. Para el descifrado de documentos con contenido de texto e imagen, la extracción de texto actualmente es gratis. En el caso de 6,000 imágenes, suponga un dólar estadounidense por cada mil imágenes extraídas. Ese es un costo de 6,00 USD para este paso.

2. Para el OCR de 6000 imágenes en inglés, la capacidad cognitiva de OCR utiliza el mejor algoritmo (DescribeText). Suponiendo un costo de 2,50 USD por cada 1000 imágenes analizadas, pagaría 15,00 USD en este paso.

3. Para la extracción de entidades, tendrías 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 iguales a 18 000 registros de texto. Suponiendo que 2,00 USD por cada 1000 registros de texto, este paso costaría 36,00 USD.

En su conjunto, pagaría unos 57,00 USD para ingerir 1000 documentos PDF de este tipo con el conjunto de aptitudes descrito.

Contenido relacionado

• página de precios de Búsqueda de Azure AI
• Cómo definir un conjunto de habilidades
• Crear conjunto de habilidades (REST)
• Cómo mapear campos enriquecidos