Collegare una risorsa fatturabile a un set di competenze in Azure AI Search

Se si usano competenze predefinite per l'arricchimento AI in Azure AI Search, è possibile arricchire gratuitamente un numero ridotto di documenti, fino a 20 transazioni per indice al giorno. Per carichi di lavoro più grandi o più frequenti, è necessario collegare una risorsa Microsoft Foundry fatturabile alla risorsa skillset.

Azure AI Search usa risorse dedicate ospitate internamente per eseguire competenze predefinite supportate da Foundry Tools e richiede una risorsa Foundry esclusivamente a scopo di fatturazione. L'eccezione è la competenza di comprensione dei contenuti di Azure, che utilizza la tua risorsa sia per la fatturazione che per l'elaborazione.

Una risorsa Foundry fornisce l'accesso a più servizi all'interno di Foundry Tools. Quando lo si specifica in un set di competenze, Microsoft è in grado di addebitare l'utente per l'uso dei servizi seguenti:

• Azure Vision in Foundry Tools per l'analisi delle immagini, il riconoscimento ottico dei caratteri (OCR) e gli incorporamenti multimodali.
• Azure Language in Foundry Tools per il rilevamento della lingua, il riconoscimento delle entità, l'analisi del sentiment e l'estrazione di frasi chiave.
• Traduttore di Azure in Foundry Tools per la traduzione testuale automatica.

L'elaborazione del set di competenze viene fatturata al servizio sottostante di ogni competenza. Azure AI Search consolida gli addebiti per gli strumenti Foundry in una singola risorsa Foundry. Ad esempio, se si usano le competenze Image Analysis e Language Detection, gli addebiti per Azure Vision e Azure Language vengono visualizzati nella stessa fattura per la risorsa Foundry. Tutte le altre risorse vengono fatturate in modo indipendente.

Per collegare una risorsa Foundry, specificare le informazioni di connessione nel set di competenze. È possibile usare un approccio basato su chiave o senza chiave.

Prerequisiti

• Connettività su un endpoint pubblico, a meno che il servizio di ricerca non soddisfi i requisiti di data di creazione, livello e area per le connessioni private a una risorsa Foundry.

• Risorsa Foundry con il AIServices tipo di API. È possibile verificare il tipo di API nella pagina Overview della risorsa nel portale di Azure:

  

Fatturare tramite una connessione senza chiave

È possibile usare un'identità gestita e le autorizzazioni per collegare una risorsa Foundry. Il vantaggio di questo approccio è che la fatturazione è senza chiave e non ha requisiti per l'area.

Come per le chiavi, i dettagli forniti sulla risorsa vengono usati per la fatturazione, non per le connessioni. Tutte le richieste API effettuate da Azure AI Search a Foundry Tools per l'elaborazione predefinita delle competenze rimangono interne e gestite da Microsoft.

Per fatturare tramite una connessione senza chiave:

1. Nel servizio Azure AI Search configurare un'identità gestita. Sono supportate sia le identità assegnate dal sistema che le identità assegnate dall'utente.

2. Nella risorsa Foundry assegna il ruolo Cognitive Services User all'identità gestita del tuo servizio di ricerca.

3. Configurare un set di competenze per l'uso dell'identità gestita. È possibile usare il portale di Azure, la versione stabile più recente di Skillsets - Create Or Update (API REST) o un pacchetto Azure SDK che fornisce la sintassi.

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

   • subdomainUrl è l'endpoint della risorsa Foundry. È possibile usare il formato https://<resource-name>.services.ai.azure.com o https://<resource-name>.cognitiveservices.azure.com, entrambi disponibili nella pagina Keys e Endpoint nel portale di Azure.

   • Altre proprietà sono specifiche del tipo di identità gestita, come illustrato negli esempi di API REST seguenti.

   • Identità gestita assegnata dal sistema
   • Identità gestita assegnata dall'utente

   Ecco una configurazione del set di competenze di esempio per un'identità gestita assegnata dal sistema. In questo scenario, è necessario impostare identity su 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
     }
   }
   

Fatturare tramite una chiave di risorsa

Per impostazione predefinita, Azure AI Search addebita delle transazioni utilizzando la chiave di una risorsa Foundry. Questo approccio è disponibile a livello generale. È possibile usare il portale di Azure, una versione stabile dell'API REST o un Azure SDK equivalente per aggiungere la chiave a un set di competenze.

Esistono due tipi di chiave supportati:

• #Microsoft.Azure.Search.CognitiveServicesByKey chiama l'endpoint a livello di area.
• #Microsoft.Azure.Search.AIServicesByKey chiama il sottodominio. È consigliabile usare questo tipo perché supporta collegamenti privati condivisi e non ha requisiti a livello di area relativi al servizio di ricerca.

La risorsa Foundry deve trovarsi nella stessa area del servizio di ricerca. Scegliere un'area Azure AI Search che fornisce l'integrazione degli strumenti Foundry, indicata dalla colonna AI arricchimento. Per ulteriori informazioni sul requisito della stessa regione, vedere Come viene usata la chiave.

Se non si specifica la cognitiveServices proprietà , il servizio di ricerca tenta di usare gli arricchimenti gratuiti disponibili per l'indicizzatore ogni giorno. L'esecuzione di abilità fatturabili si arresta a 20 transazioni per ogni invocazione dell'indicizzatore e viene visualizzato un messaggio "Time Out" nella cronologia di esecuzione dell'indicizzatore.

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

Rimuovere la chiave

Gli arricchimenti sono operazioni fatturabili. Se non è più necessario chiamare Foundry Tools, seguire queste istruzioni per rimuovere la chiave e impedire l'uso della risorsa Foundry.

Senza la chiave, il set di competenze torna all'allocazione predefinita di 20 transazioni gratuite per indicizzatore al giorno. L'esecuzione di competenze fatturabili si arresta a 20 transazioni e viene visualizzato un messaggio "TimeOut" nella cronologia di esecuzione dell'indicizzatore quando viene usata l'allocazione.

Come viene usata la chiave

La fatturazione diventa effettiva quando le chiamate API a una risorsa Foundry superano 20 chiamate API per indicizzatore al giorno. È possibile reimpostare l'indicizzatore per reimpostare il numero di API.

Le connessioni senza chiave e basate su chiave vengono usate per la fatturazione, ma non per le connessioni correlate alle operazioni di arricchimento.

Per le connessioni basate su chiave, un servizio di ricerca si connette tramite la rete interna a una risorsa Foundry che si trova nella stessa area fisica. La maggior parte delle aree che offrono Azure AI Search offrono anche altri servizi di Azure. Se si tenta l'arricchimento tramite intelligenza artificiale in un'area che non dispone di entrambi i servizi, viene visualizzato questo messaggio: "La chiave fornita non è una chiave di tipo CognitiveServices valida per l'area del servizio di ricerca".

Per le connessioni senza chiave, un servizio di ricerca esegue l'autenticazione usando l'identità e l'assegnazione di ruolo e ha come destinazione una risorsa Foundry. La risorsa è specificata come URI completamente qualificato e include un sottodominio univoco.

Gli indicizzatori possono essere configurati per l'esecuzione in un ambiente di esecuzione privato per l'elaborazione dedicata usando solo i nodi di ricerca del proprio servizio di ricerca. Anche se si usa un ambiente di esecuzione privato, Azure AI Search usa ancora le risorse di cui è stato effettuato il provisioning internamente per eseguire tutti gli arricchimenti delle competenze.

Requisiti di connessione pubblica

A seconda del momento in cui è stato creato il servizio di ricerca, il piano tariffario e la relativa area, la fatturazione per competenze predefinite può richiedere una connessione pubblica da Azure AI Search alla risorsa Foundry. La disabilitazione dell'accesso alla rete pubblica interrompe la fatturazione in alcuni scenari. Esaminare i requisiti per le connessioni tramite un collegamento privato condiviso per determinare se il servizio di ricerca richiede una connessione pubblica.

Se non è possibile usare la rete pubblica, è possibile configurare una skill personalizzata API Web implementata con una funzione Azure che supporta endpoint privati e aggiungere la risorsa Foundry alla stessa VNET. In questo scenario è possibile chiamare la risorsa Foundry direttamente dalla competenza personalizzata usando endpoint privati.

Requisiti chiave casi speciali

Ricerca di Entità Personalizzate è monitorata da Azure AI Search, ma è necessaria una chiave risorsa di Foundry per abilitare più di 20 transazioni per indicizzatore al giorno. Solo per questa competenza, la chiave della risorsa sblocca il numero di transazioni, ma non è correlata alla fatturazione.

Arricchimenti gratuiti

L'arricchimento tramite intelligenza artificiale offre una piccola quantità di elaborazione gratuita di arricchimenti fatturabili in modo da poter completare brevi esercizi senza dover collegare una risorsa esterna. Gli arricchimenti gratuiti sono 20 documenti per indicizzatore al giorno. È possibile reimpostare l'indicizzatore per reimpostare il contatore se si vuole ripetere un esercizio.

Alcuni arricchimenti sono sempre gratuiti:

• Le competenze di utilità che non chiamano gli strumenti Foundry (vale a dire le competenze Condizionale, Estrazione documenti, Shaper, Unione testo e Suddivisione testo ) non sono fatturabili.

• L'estrazione di testo da documenti PDF e altri file dell'applicazione non è fatturabile. L'estrazione del testo, che si verifica durante il cracking dei documenti, non è un arricchimento tramite intelligenza artificiale, ma si verifica durante l'arricchimento tramite intelligenza artificiale ed è quindi indicato qui.

Arricchimenti fatturabili

Durante l'arricchimento tramite intelligenza artificiale, Azure AI Search chiama le API per competenze predefinite basate su visione Azure, linguaggio Azure e Traduttore di Azure.

Le competenze predefinite fatturabili che effettuano chiamate back-end a servizi esterni includono:

• Collegamento di entità
• Riconoscimento delle entità
• Analisi delle immagini
• Estrazione frasi chiave
• Rilevamento della lingua
• OCR
• Rilevamento delle informazioni personali
• Sentimento
• Traduzione di testo
• Embedding multimodali di Azure Vision

Un vettorizzatore query-time supportato dal modello di embedding multimodale Azure Vision è anche un arricchimento fatturabile.

L'estrazione di immagini è un'operazione Azure AI Search che si verifica quando i documenti vengono violati prima dell'arricchimento. L'estrazione delle immagini è fatturabile in tutti i piani tariffari, ad eccezione di 20 estrazione giornaliere gratuite nel livello gratuito. I costi di estrazione delle immagini si applicano ai file di immagine all'interno di BLOB, immagini incorporate in altri file (FILE PDF e altri file dell'app) e immagini estratte tramite Estrazione documenti. Per i prezzi di estrazione delle immagini, vedere la pagina dei prezzi Azure AI Search.

Esempio: Stimare i costi

I prezzi illustrati in questa sezione sono ipotetici e usati per illustrare il processo di stima. I costi potrebbero essere inferiori. Per il prezzo effettivo delle transazioni, vedere Prezzi di Foundry Tools.

Per stimare i costi associati all'indicizzazione Azure AI Search, iniziare con un'idea dell'aspetto di un documento medio in modo da poter eseguire alcuni numeri. Ad esempio, è possibile approssimare:

• 1.000 PDF
• Sei pagine ognuna
• Un'immagine per pagina (6.000 immagini)
• 3.000 caratteri per pagina

Si consideri una pipeline costituita da analisi dei documenti di ogni PDF, estrazione del testo e delle immagini, OCR delle immagini e riconoscimento delle entità organizzative.

1. Per il cracking dei documenti con il contenuto di testo e immagine, l'estrazione di testo è attualmente gratuita. Per 6.000 immagini, presupporre $1 per ogni 1.000 immagini estratte. Questo è un costo di $ 6,00 per questo passaggio.

2. Per l'OCR di 6.000 immagini in inglese, la competenza cognitiva OCR utilizza l'algoritmo migliore, DescribeText. Supponendo un costo di $ 2,50 per 1.000 immagini da analizzare, si pagherebbe $ 15,00 per questo passaggio.

3. Per l'estrazione di entità, si dispone di un totale di tre record di testo per pagina. Ogni record è di 1.000 caratteri. Tre record di testo per pagina moltiplicati per 6.000 pagine uguali a 18.000 record di testo. Supponendo che si applichino 2,00 USD per 1.000 record di testo, questo passaggio costerebbe 36,00 USD.

Mettendo tutto insieme, si pagherà circa $ 57,00 per inserire 1.000 documenti PDF di questo tipo con il set di competenze descritto.

Contenuto correlato

• Azure AI Search pagina dei prezzi
• Come definire un set di competenze
• Creare un set di competenze (REST)
• Come eseguire il mapping dei campi arricchiti