Anexe um recurso faturável a um conjunto de competências no Azure AI Search

Se estiver a usar competências integradas para enriquecimento de IA no Azure AI Search, pode enriquecer um pequeno número de documentos gratuitamente, até 20 transações por índice por dia. Para cargas de trabalho maiores ou mais frequentes, deve anexar um recurso faturável do Microsoft Foundry ao seu conjunto de competências.

O Azure AI Search utiliza recursos dedicados e internamente alojados para executar competências integradas apoiadas pelas Foundry Tools e requer um recurso Foundry exclusivamente para fins de faturação. A exceção é a Azure Content Understanding Skill, que utiliza o seu recurso tanto para faturação como para processamento.

Um recurso Foundry fornece acesso a múltiplos serviços dentro das Foundry Tools. Quando o especifica num conjunto de competências, a Microsoft pode cobrar-lhe pelo uso dos seguintes serviços:

• Azure Vision em Foundry Tools para análise de imagens, reconhecimento ótico de caracteres (OCR) e embeddings multimodais.
• Azure Language nas Foundry Tools para detecção de idiomas, reconhecimento de entidades, análise de sentimento e extração de expressões-chave.
• Azure Translator no Foundry Tools para tradução automática de texto.

O processamento do conjunto de competências é faturado ao serviço subjacente de cada competência. O Azure AI Search consolida os encargos das Foundry Tools num único recurso Foundry. Por exemplo, se usar as competências de Análise de Imagens e Deteção de Linguagem , as cobranças pelo Azure Vision e Azure Language aparecem na mesma fatura do seu recurso Foundry. Todos os outros recursos são faturados de forma independente.

Para anexar um recurso da Foundry, forneça informação de ligação no conjunto de competências. Pode usar uma abordagem baseada em chaves ou sem chaves, que está atualmente em versão preliminar.

Prerequisites

• Conectividade através de um endpoint público, a menos que o seu serviço de pesquisa atenda aos requisitos de data de criação, camada e região para ligações privadas a um recurso Foundry.

• Um recurso da Foundry com o AIServices tipo de API. Pode verificar o tipo de API na página de Visão Geral do recurso no portal Azure:

  

Faturar através de uma conexão sem chave

Pode usar uma identidade gerida e permissões para anexar um recurso Foundry. A vantagem desta abordagem é que a faturação é sem chave e não tem requisitos regionais.

Tal como com as chaves, os detalhes que fornece sobre o recurso são usados para faturação, não para ligações. Todos os pedidos de API feitos pelo Azure AI Search às Ferramentas Foundry para o processamento de competências integradas permanecem internos e são geridos pela Microsoft.

Para faturar através de uma ligação sem chave:

1. No seu serviço Azure AI Search, configure uma identidade gerida. São suportadas identidades atribuídas pelo sistema e atribuídas pelo utilizador.

2. No seu recurso Foundry, atribua o papel de Utilizador de Serviços Cognitivos à identidade gerida do seu serviço de pesquisa.

3. Configurar um perfil de habilidades para usar a identidade gerida. Pode usar o portal Azure, a versão de pré-visualização mais recente do Skillssets - Create Or Update (API REST), ou um pacote beta do Azure SDK que forneça a sintaxe.

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

   • subdomainUrl é o ponto final do seu recurso Foundry. Pode usar o formato https://<resource-name>.services.ai.azure.com ou https://<resource-name>.cognitiveservices.azure.com, ambos disponíveis na página Chaves e Pontos de Extremidade no portal Azure.

   • Outras propriedades são específicas do tipo de identidade gerida, como mostrado nos exemplos seguintes da API REST.

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

     Aqui está um exemplo de configuração de conjunto de competências para uma identidade gerida atribuída pelo sistema. Neste cenário, deve definir identity para null.

     POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2025-11-01-preview
     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
       }
     }
     

Faturar através de uma chave de recurso

Por defeito, o Azure AI Search cobra pelas transações com a utilização da chave de um recurso da Foundry. Esta abordagem está geralmente disponível. Podes usar o portal Azure, uma versão estável da API REST, ou um Azure SDK equivalente para adicionar a chave a um conjunto de competências.

Existem dois tipos de chaves suportados:

• #Microsoft.Azure.Search.CognitiveServicesByKey chama o endpoint regional.
• #Microsoft.Azure.Search.AIServicesByKey chama o subdomínio. Recomendamos este tipo porque suporta ligações privadas partilhadas e não tem requisitos regionais relativos ao serviço de pesquisa.

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

Se não especificar a propriedade cognitiveServices, o seu serviço de pesquisa tenta usar os enriquecimentos gratuitos disponíveis diariamente para o seu indexador. A execução das habilidades faturáveis termina após 20 transações em cada invocação do indexador, e uma mensagem "Time Out" aparece no histórico de execução do indexador.

PUT https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2025-09-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);

Remova a chave

Os enriquecimentos são operações faturáveis. Se já não precisar de ligar para a Foundry Tools, siga estas instruções para remover a chave e evitar o uso do recurso Foundry.

Sem a chave, o conjunto de habilidades reverte para a alocação padrão de 20 transações gratuitas por indexador por dia. A execução das habilidades faturáveis termina em 20 transações, e uma mensagem "Time Out" aparece no histórico de execução do indexador quando a alocação é esgotada.

Como a chave é usada

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

As ligações sem chave e baseadas em chave são usadas para faturação, mas não para ligações relacionadas com operações de enriquecimento.

Para ligações baseadas em chaves, um serviço de pesquisa liga-se através da rede interna a um recurso Foundry localizado na mesma região física. A maioria das regiões que oferecem Azure AI Search também oferece outros serviços Azure. Se você tentar enriquecimento de IA em uma região que não tenha os dois serviços, verá esta mensagem: "A chave fornecida não é uma chave de tipo CognitiveServices válida para a região do seu serviço de pesquisa".

Para ligações sem chave, um serviço de pesquisa autentica-se usando a sua identidade e atribuição de funções e direciona-se para um recurso Foundry. O recurso é especificado como um URI totalmente qualificado, e o URI inclui um subdomínio único.

Os indexadores podem ser configurados para serem executados em um ambiente de execução privado para processamento dedicado usando apenas os nós de pesquisa do seu próprio serviço de pesquisa. Mesmo que estejas a usar um ambiente de execução privada, o Azure AI Search continua a usar os seus recursos internamente provisionados para realizar todos os enriquecimentos de competências.

Requisitos de ligação pública

Dependendo de quando o seu serviço de pesquisa foi criado, do seu escalão de preços e da sua região, a faturação por competências integradas pode exigir uma ligação pública do Azure AI Search ao seu recurso Foundry. A desativação do acesso à rede pública interrompe a faturação em alguns cenários. Analise os requisitos para conexões por meio de um link privado compartilhado para determinar se seu serviço de pesquisa requer uma conexão pública.

Se não conseguires usar a rede pública, podes configurar uma competência de API Web Personalizada implementada com uma Função Azure que suporta endpoints privados e adicionar o teu recurso Foundry à mesma VNET. Neste cenário, pode chamar o seu recurso Foundry diretamente a partir da competência personalizada usando endpoints privados.

Principais requisitos casos especiais

O Custom Entity Lookup é medido pelo Azure AI Search, mas requer uma chave de recurso Foundry para desbloquear transações superiores a 20 por indexador por dia. Para esta competência apenas, a chave de recurso desbloqueia o número de transações, mas não está relacionada com a faturação.

Enriquecimentos gratuitos

O enriquecimento por IA oferece uma pequena quantidade de processamento gratuito de enriquecimentos faturáveis para que possa realizar pequenos exercícios sem ter de ligar um recurso externo. Enriquecimentos gratuitos são até 20 documentos por indexador por dia. Você pode redefinir o indexador para redefinir o contador se quiser repetir um exercício.

Alguns enriquecimentos são sempre gratuitos:

• Competências de utilidade que não chamam Foundry Tools (nomeadamente Condicional, Extração de Documentos, Shaper, Fusão de Texto e Divisão de Texto) não são cobradas.

• A extração de texto de documentos PDF e outros arquivos de aplicativos não pode ser faturável. A extração de texto, que ocorre durante a decifração de documentos, não é um enriquecimento de IA por si só, mas ocorre durante o processo de enriquecimento de IA e, por isso, é mencionada aqui.

Os enriquecimentos faturáveis

Durante o enriquecimento de IA, o Azure AI Search chama APIs para competências incorporadas baseadas no Azure Vision, Azure Language e Azure Translator.

Competências faturáveis incorporadas que fazem chamadas de backend para serviços externos incluem:

• Associação de Entidades
• Reconhecimento de Entidades
• Análise de Imagem
• Extração de Expressões-Chave
• Deteção de Idioma
• OCR
• Deteção de Informação Pessoalmente Identificável (PII)
• Sentimento
• Tradução de texto
• Azure Vision multimodal embeddings

Um vetorizador em tempo de consulta apoiado pelo modelo de embedding multimodal Azure Vision é também um enriquecimento faturável.

A extração de imagem é uma operação de Pesquisa de IA do Azure que ocorre quando os documentos são quebrados antes do enriquecimento. A extração de imagem é faturável em todos os níveis de preços, exceto para 20 extrações diárias gratuitas no nível gratuito. Os custos de extração de imagens aplicam-se a ficheiros de imagem dentro de blobs, imagens incorporadas noutros ficheiros (PDF e outros ficheiros de aplicação) e imagens extraídas usando Extração de Documentos. Para obter preços de extração de imagem, consulte a página de preços do Azure AI Search.

Exemplo: Estimar custos

Os preços apresentados nesta secção são hipotéticos e usados para ilustrar o processo de estimação. Os seus custos podem ser mais baixos. Para o preço real das transações, consulte preços das Foundry Tools.

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

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

Assuma um pipeline que consiste na decodificação de documentos de cada PDF, extração de imagens e texto, OCR de imagens e reconhecimento de entidades das organizações.

1. Para quebra de documentos com conteúdo de texto e imagem, a extração de texto é atualmente gratuita. Para 6.000 imagens, assuma $1 para cada 1.000 imagens extraídas. Esse é um custo de 6,00 US$ 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 registos de texto por página multiplicados por 6 000 páginas equivalem a 18 000 registos de texto. Supondo 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 Azure AI Search
• Como definir um conjunto de competências
• Criar conjunto de habilidades (REST)
• Como mapear campos enriquecidos