Anexe um recurso faturável a um conjunto de competências no Pesquisa de IA do Azure

Se estiveres a usar competências incorporadas para enriquecimento de IA em Pesquisa de IA do Azure, podes 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 Microsoft Foundry ao seu conjunto de competências.

O Pesquisa de IA do Azure utiliza recursos dedicados e internamente alojados para executar competências integradas apoiadas pelo Foundry Tools e requer um recurso do Foundry exclusivamente para fins de faturação. A exceção é a competência Azure Compreensão de Conteúdo, 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 nas Ferramentas da Plataforma para análise de imagens, reconhecimento ótico de caracteres (OCR) e embeddings multimodais.
• Azure Language in Foundry Tools para deteção de linguagem, reconhecimento de entidades, análise de sentimento e extração de frases-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 Pesquisa de IA do Azure consolida os encargos das Foundry Tools num único recurso Foundry. Por exemplo, se usar as competências Análise de Imagem e Deteção de Linguagem, as cobranças por Azure Visão e Azure Língua aparecem na mesma conta 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.

Pré-requisitos

• Conectividade através de um ponto final público, a menos que o seu serviço de pesquisa cumpra os requisitos de data de criação, nível 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 Overview do recurso no portal Azure:

  

Bill através de uma ligaçã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 Pesquisa de IA do Azure para o Foundry Tools para o processamento de capacidades integradas continuam internos e geridos pela Microsoft.

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

1. No seu serviço Pesquisa de IA do Azure, 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. Configure um conjunto de capacidades para usar a identidade gerida. Pode usar o portal Azure, a versão estável mais recente do Skillssets - Create Or Update (REST API), ou um pacote SDK do Azure 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 nas páginas Keys e Endpoint no portal Azure.

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

   • Identidade gerida pelo sistema
   • Identidade gerida atribuída pelo utilizador

   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=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
     }
   }
   

Fatura através de uma chave de recursos

Por padrão, o Pesquisa de IA do Azure cobra pelas transações que utilizam a chave de um recurso da Foundry. Esta abordagem está geralmente disponível. 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 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 Pesquisa de IA do Azure que forneça integração com Foundry Tools, indicada pela coluna AI enrichment. Para mais informações sobre o requisito da mesma região, veja Como a chave é utilizada.

Se não especificar a cognitiveServices propriedade, o seu serviço de pesquisa tenta usar diariamente os enriquecimentos gratuitos disponíveis para o seu indexador. A execução das capacidades faturáveis termina em 20 transações por 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=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);

Remove 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 competências reverte para a alocação padrão de 20 transações gratuitas por indexador por dia. A execução das competências 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 é utilizada.

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. Podes repor o indexador para redefinir a contagem de APIs.

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 o Pesquisa de IA do Azure também oferece outros serviços do Azure. Se tentar o enriquecimento de IA numa região que não tenha ambos os serviços, verá esta mensagem: "A chave fornecida não é uma chave válida do tipo CognitiveServices 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 funcionar num ambiente de execução privada para processamento dedicado, utilizando apenas os nós de pesquisa do seu próprio serviço de pesquisa. Mesmo que estejas a usar um ambiente de execução privado, o Pesquisa de IA do Azure 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 incorporadas pode exigir uma ligação pública de Pesquisa de IA do Azure ao seu recurso Foundry. Desativar o acesso à rede pública interrompe a faturação em alguns cenários. Revise os requisitos para ligações através de um link privado partilhado para determinar se o seu serviço de pesquisa requer uma ligação pública.

Se não conseguires usar a rede pública, podes configurar uma Custom Web API skill implementada com uma função Azure Function que suporta endpoints privados e adicionar o teu recurso Foundry ao mesmo VNET. Neste cenário, podes chamar o teu recurso Foundry diretamente a partir da skill personalizada usando endpoints privados.

Requisitos chave casos especiais

Custom Entity Lookup é medido por Pesquisa de IA do Azure, mas requer uma chave de recurso Foundry para desbloquear transações acima de 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 exercícios curtos sem ter de conectar um recurso externo. O número de enriquecimentos gratuitos é de 20 documentos por indexador por dia. Podes reiniciar o indexador para reiniciar o contador se quiseres repetir um exercício.

Alguns enriquecimentos são sempre gratuitos:

• As competências utilitárias 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 faturáveis.

• A extração de texto de documentos PDF e outros ficheiros de aplicação não é faturável. A extração de texto, que ocorre durante a quebra de documentos, não é um enriquecimento de IA, mas ocorre durante o enriquecimento de IA e, portanto, é mencionada aqui.

Enriquecimentos faturáveis

Durante o enriquecimento de IA, Pesquisa de IA do Azure chama APIs para competências incorporadas baseadas em Azure Vision, Azure Language e Azure Translator.

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

• Ligação de Entidades
• Reconhecimento de Entidade
• Análise de Imagem
• Extração de Frases-Chave
• Deteção de Linguagem
• OCR
• Deteção de Informação Pessoalmente Identificável (PII)
• Sentimento
• Tradução de Texto
• Incorporações multimodais do Azure Vision (pré-visualização)

Um vetorizador em tempo de consulta suportado pelo modelo de incrustação multimodal Azure Vision é também um enriquecimento faturável.

A extração de imagens é uma operação do Pesquisa de IA do Azure que ocorre quando documentos são decifrados 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 preços de extração de imagens, consulte a página de preços Pesquisa de IA do Azure.

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 Pesquisa de IA do Azure, comece com uma ideia de como é um documento médio para poder fazer alguns cálculos. Por exemplo, tu podes 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 o processamento de documentos com texto e imagens inseridas, a extração de texto é gratuita atualmente. Para 6.000 imagens, assuma $1 por cada 1.000 imagens extraídas. Custa 6,00 dólares por este passo.

2. Para OCR de 6.000 imagens em inglês, a competência cognitiva OCR utiliza o melhor algoritmo (DescribeText). Assumindo um custo de $2,50 por cada 1.000 imagens a analisar, pagaria $15,00 por esta etapa.

3. Para extração de entidades, terias um total de três registos de texto por página. Cada registo 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. Assumindo $2,00 por cada 1.000 registos de texto, esta etapa custaria $36,00.

Juntando tudo, pagarias cerca de 57,00 dólares para ingerir 1.000 documentos PDF deste tipo com as competências descritas.

Conteúdo relacionado

• Página de preços do Pesquisa de IA do Azure
• Como definir um conjunto de competências
• Criar Conjunto de Competências (REST)
• Como mapear campos enriquecidos