Anexar um recurso faturável a um conjunto de habilidades no Pesquisa de IA do Azure 

Se você estiver utilizando habilidades embutidas para enriquecimento de IA no Pesquisa de IA do Azure , poderá enriquecer gratuitamente um pequeno número de documentos, até 20 transações por índice por dia. Para cargas de trabalho maiores ou mais frequentes, você deve associar um recurso faturável do Microsoft Foundry ao seu conjunto de habilidades.

Pesquisa de IA do Azure  usa recursos dedicados e hospedados internamente para executar habilidades integradas apoiadas pelas Foundry Tools e requer um recurso do Foundry apenas para fins de cobrança. A exceção é a habilidade Compreensão de Conteúdo do Azure, que usa seu recurso tanto para faturamento quanto para processamento.

Um recurso Foundry fornece acesso a vários serviços dentro das Ferramentas Foundry. Ao especificá-lo em um conjunto de habilidades, Microsoft poderá cobrar por usar os seguintes serviços:

• Azure Vision in Foundry Tools para análise de imagem, OCR (reconhecimento óptico de caracteres) e inserções multimodal.
• Azure Language in Foundry Tools para detecção de idioma, reconhecimento de entidade, análise de sentimento e extração de frase-chave.
• Tradutor do Azure no Foundry Tools para tradução automática de texto.

O processamento do conjunto de habilidades é cobrado do serviço subjacente de cada habilidade. A Pesquisa de IA do Azure consolida os encargos do Foundry Tools em um único recurso da Fábrica. Por exemplo, se você usar as habilidades Image Analysis e Language Detection, os encargos para Azure Vision e Azure Language aparecem na mesma fatura do recurso Foundry. Todos os outros recursos são cobrados de forma independente.

Para anexar um recurso da Fábrica, forneça informações de conexão no conjunto de habilidades. Você pode usar uma abordagem baseada em chave ou sem chave.

Pré-requisitos

• Conectividade em um ponto de extremidade público, a menos que o seu serviço de pesquisa atenda aos requisitos de data de criação, camada e região para conexões privadas com um recurso do Foundry.

• Um recurso Foundry com a AIServices categoria de API. Você pode verificar o tipo de API na página Overview do recurso no portal do Azure:

  

Cobrar por meio de uma conexão sem chave

Você pode usar uma identidade gerenciada e permissões para anexar um recurso do Foundry. A vantagem dessa abordagem é que a cobrança é sem chave e não tem requisitos de região.

Assim como acontece com as chaves, os detalhes que você fornece sobre o recurso são usados para cobrança, não para conexões. Todas as solicitações de API feitas pelo Pesquisa de IA do Azure  às Foundry Tools para o processamento de habilidades integradas permanecem internas e são gerenciadas pela Microsoft.

Para cobrar por meio de uma conexão sem chave:

1. No serviço Pesquisa de IA do Azure , configure uma identidade gerenciada. Há suporte para identidades atribuídas pelo sistema e atribuídas pelo usuário.

2. No recurso Foundry, atribua a função usuário dos Serviços Cognitivos à identidade gerenciada do serviço de pesquisa.

3. Configure um conjunto de habilidades para usar a identidade gerenciada. Você pode usar o portal Azure, a versão estável mais recente do Skillsets – Criar ou atualizar (API REST) ou um pacote SDK do Azure que fornece a sintaxe.

   • @odata.type é sempre #Microsoft.Azure.Search.AIServicesByIdentity.

   • subdomainUrl é o endpoint do recurso Foundry. Você pode usar o formato https://<resource-name>.services.ai.azure.com ou https://<resource-name>.cognitiveservices.azure.com, ambos disponíveis na página Keys e Endpoint no portal Azure.

   • Outras propriedades são específicas para o tipo de identidade gerenciada, conforme mostrado nos exemplos de API REST a seguir.

   • Identidade gerenciada atribuída pelo sistema
   • Identidade gerenciada atribuída pelo usuário

   Aqui está uma configuração de conjunto de habilidades de exemplo para uma identidade gerenciada atribuída pelo sistema. Nesse cenário, você deve definir identity como 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
     }
   }
   

Cobrar por meio de uma chave de recurso

Por padrão, o Pesquisa de IA do Azure  cobra por transações usando a chave de um recurso Foundry. Essa abordagem geralmente está disponível. Você pode usar o portal Azure, uma versão estável da API REST ou um SDK do Azure equivalente para adicionar a chave a um conjunto de habilidades.

Há dois tipos de chave com suporte:

• #Microsoft.Azure.Search.CognitiveServicesByKey chama o ponto de extremidade regional.
• #Microsoft.Azure.Search.AIServicesByKey chama o subdomínio. Recomendamos esse tipo porque ele dá suporte a links privados compartilhados e não tem requisitos regionais relativos ao serviço de pesquisa.

O recurso Foundry deve estar na mesma região que o serviço de pesquisa. Escolha uma região Pesquisa de IA do Azure que forneça integração com o Foundry Tools, indicada pela coluna Enriquecimento de IA. Para obter mais informações sobre o requisito da mesma região, consulte Como a chave é usada.

Se você não especificar a propriedade, o cognitiveServices serviço de pesquisa tentará usar os enriquecimentos gratuitos disponíveis para o indexador todos os dias. A execução de habilidades faturáveis é interrompida em 20 transações por invocação de indexador e uma mensagem de "tempo limite atingido" aparece no histórico de execução do indexador.

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

Remover a chave

Enriquecimentos são operações faturáveis. Se você não precisar mais chamar as Ferramentas Foundry, siga estas instruções para remover a chave e impedir o uso do recurso Foundry.

Sem a chave, o conjunto de habilidades é revertido para a alocação padrão de 20 transações gratuitas por indexador por dia. A execução de habilidades faturáveis é interrompida em 20 transações e uma mensagem de "tempo limite atingido" aparece no histórico de execução do indexador quando a alocação é usada.

Como a chave é usada

A cobrança entra em vigor quando as chamadas à API para um recurso do Foundry excedem 20 chamadas de API por indexador por dia. Você pode redefinir o indexador para redefinir a contagem de API.

Conexões baseadas em chave e sem chave são usadas para cobrança, mas não para conexões relacionadas a operações de enriquecimento.

Para conexões baseadas em chave, um serviço de pesquisa se conecta pela rede interna a um recurso foundry localizado na mesma região física. A maioria das regiões que oferecem Pesquisa de IA do Azure  também oferecem outros serviços de Azure. Se você tentar o enriquecimento de IA em uma região que não tenha ambos os serviços, verá esta mensagem: "A chave fornecida não é uma chave de tipo cognitiveServices válida para a região do serviço de pesquisa".

Para conexões sem chave, um serviço de pesquisa é autenticado usando sua atribuição de identidade e função e tem como destino um recurso do Foundry. O recurso é especificado como um URI totalmente qualificado e o URI inclui um subdomínio exclusivo.

Os indexadores podem ser configurados para serem executados em um ambiente de execução privada para processamento dedicado usando apenas os nós de pesquisa do seu próprio serviço de pesquisa. Mesmo se você estiver usando um ambiente de execução privada, Pesquisa de IA do Azure  ainda usará seus recursos provisionados internamente para executar todos os enriquecimentos de habilidades.

Requisitos de conexão pública

Dependendo de quando seu serviço de pesquisa foi criado, seu tipo de preço e sua região, a cobrança por habilidades incorporadas pode exigir uma conexão pública de Pesquisa de IA do Azure  para seu recurso do Foundry. Desabilitar o acesso à rede pública interrompe a cobrança em alguns cenários. Examine os requisitos de conexões por meio de um link privado compartilhado para determinar se o serviço de pesquisa requer uma conexão pública.

Se você não puder usar a rede pública, poderá configurar uma habilidade de API Web personalizada implementada com uma Função do Azure que suporte pontos de extremidade privados e adicionar seu recurso do Foundry à mesma VNET. Nesse cenário, você pode chamar seu recurso de Foundry diretamente da habilidade personalizada usando pontos de extremidade privados.

Casos especiais de requisitos principais

Custom Entity Lookup é medido por Pesquisa de IA do Azure , mas requer uma chave de recurso do Foundry para desbloquear transações além de 20 por indexador por dia. Somente para essa habilidade, a chave de recurso desbloqueia o número de transações, mas não está relacionada à cobrança.

Enriquecimentos gratuitos

O enriquecimento de IA oferece uma pequena quantidade de processamento gratuito de enriquecimentos faturáveis para que você possa concluir exercícios curtos sem precisar anexar um recurso externo. Enriquecimentos gratuitos são limitados a 20 documentos por indexador a cada dia. Você pode redefinir o indexador para redefinir o contador se quiser repetir um exercício.

Alguns enriquecimentos são sempre gratuitos:

• As habilidades de utilitário que não chamam o Foundry Tools (ou seja, as habilidades Condicional, Extração de documentos, Shaper, Mesclagem de texto e Divisão de texto) não são faturáveis.

• A extração de texto de documentos PDF e outros arquivos de aplicativo não é cobrada. A extração de texto, que ocorre durante a análise de documento, não é um enriquecimento de IA, mas acontece durante o processo de enriquecimento de IA e, portanto, é mencionada aqui.

Enriquecimentos faturáveis

Durante o enriquecimento de IA, o Pesquisa de IA do Azure  chama APIs para habilidades integradas baseadas no Azure Vision, Azure Language e Tradutor do Azure.

As habilidades internas faturáveis que fazem chamadas de back-end para serviços externos incluem:

• Vinculação de entidade
• Reconhecimento de entidade
• Análise de Imagem
• Extração de frase-chave
• Detecção de idioma
• OCR
• Detecção de PII (Informações de Identificação Pessoal)
• Sentimento
• Tradução de texto
• inserções multimodal do Azure Vision (versão prévia)

Um vetor de tempo de consulta apoiado pelo modelo de inserção multimodal do Serviço Cognitivo do Azure para Visão também é um enriquecimento faturável.

A extração de imagem é uma operação de IA do Azure Search que ocorre quando os documentos são decifrados antes do enriquecimento. A extração de imagem é faturável em todos os tipos de preço, exceto por 20 extrações diárias gratuitas na camada gratuita. Os custos de extração de imagem se aplicam a arquivos de imagem dentro de blobs, imagens inseridas em outros arquivos (PDF e outros arquivos de aplicativo) e imagens extraídas usando a Extração de Documentos. Para obter preços de extração de imagem, consulte a página de preços Pesquisa de IA do Azure .

Exemplo: estimar custos

Os preços mostrados nesta seção são hipotéticos e usados para ilustrar o processo de estimativa. Seus custos podem ser menores. Para obter o preço real das transações, confira Preços do Foundry Tools.

Para estimar os custos associados à indexação de Pesquisa de IA do Azure , comece com uma ideia da aparência de um documento médio para que você possa executar alguns números. Por exemplo, você pode estimar:

• 1.000 PDFs
• Seis páginas cada
• Uma imagem por página (6.000 imagens)
• 3.000 caracteres por página

Suponha um pipeline que consiste na quebra de documentos de cada PDF, extração de imagem e texto, OCR de imagens e reconhecimento de entidade das organizações.

1. Para quebra de documento com conteúdo de texto e imagem, a extração de texto está atualmente gratuita. Para 6.000 imagens, suponha US$ 1 para cada 1.000 imagens extraídas. Esse é um custo de $6,00 para esta etapa.

2. Para OCR de 6.000 imagens em inglês, a habilidade cognitiva OCR usa o melhor algoritmo (DescribeText). Supondo um custo de US$ 2,50 por 1.000 imagens a serem analisadas, você pagaria US$ 15,00 por esta etapa.

3. Para extração de entidade, você teria um total de três registros de texto por página. Cada registro tem 1.000 caracteres. Três registros de texto por página multiplicados por 6.000 páginas, igual a 18.000 registros de texto. Considerando que é cobrado US$ 2,00 por 1.000 registros de texto, essa etapa custaria US$ 36,00.

Juntando tudo, você pagaria cerca de US$ 57,00 para ingerir 1.000 documentos PDF desse tipo com o conjunto de habilidades descrito.

Conteúdo relacionado

• Página de preços do Pesquisa de IA do Azure 
• Como definir um conjunto de habilidades
• Criar conjunto de habilidades (REST)
• Como mapear campos enriquecidos