Collegare una risorsa multiservizio di Intelligenza artificiale di Azure a un set di competenze in Ricerca di intelligenza artificiale di Azure

Quando si configura una pipeline di arricchimento tramite intelligenza artificiale facoltativa in Ricerca di intelligenza artificiale di Azure, è possibile arricchire gratuitamente un numero limitato di documenti. Per carichi di lavoro più grandi e più frequenti, è consigliabile collegare una risorsa multiservizio di Azure per intelligenza artificiale fatturabile.

Una risorsa multiservizio fa riferimento a un set di servizi di intelligenza artificiale di Azure come offerta, anziché a singoli servizi, con accesso concesso tramite una singola chiave API. Questa chiave viene specificata in un set di competenze e consente a Microsoft di addebitare l'utente per l'uso di questi servizi:

• Visione artificiale di Azure per l'analisi delle immagini e il riconoscimento ottico dei caratteri (OCR)
• Linguaggio di intelligenza artificiale di Azure per il rilevamento della lingua, il riconoscimento delle entità, l'analisi del sentiment e l'estrazione di frasi chiave
• Riconoscimento vocale di Azure per riconoscimento vocale e sintesi vocale
• Traduttore di intelligenza artificiale di Azure per la traduzione testuale automatica

Suggerimento

Azure offre un'infrastruttura che consente di monitorare la fatturazione e i budget. Per altre informazioni sul monitoraggio dei servizi di intelligenza artificiale di Azure, vedere Pianificare e gestire i costi per i servizi di intelligenza artificiale di Azure.

Impostare la chiave della risorsa

È possibile usare il portale di Azure, l'API REST o Azure SDK per collegare una risorsa fatturabile a un set di competenze.

Se la proprietà non viene specificata, il servizio di ricerca tenta di usare gli arricchimenti gratuiti disponibili per l'indicizzatore su base giornaliera. L'esecuzione di competenze fatturabili si arresta a 20 transazioni per ogni chiamata dell'indicizzatore e viene visualizzato un messaggio "TimeOut" nella cronologia di esecuzione dell'indicizzatore.

Azure portal

1. Accedere al portale di Azure.

2. Creare una risorsa multiservizio di Intelligenza artificiale di Azure nella stessa area del servizio di ricerca.

3. Aggiungere la chiave a una definizione del set di competenze:

   • Se si usa la procedura guidata Importa dati, immettere la chiave nel secondo passaggio" "Aggiungere arricchimenti tramite intelligenza artificiale".

   • Se si aggiunge la chiave a un set di competenze nuovo o esistente, specificare la chiave nella scheda Servizi di intelligenza artificiale di Azure.

   

REST

1. Creare una risorsa multiservizio di Intelligenza artificiale di Azure nella stessa area del servizio di ricerca.

2. Creare o aggiornare un set di competenze, specificando cognitiveServices la sezione nel corpo della richiesta del set di competenze:

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2020-06-30
api-key: [admin key]
Content-Type: application/json
{
    "name": "skillset name",
    "skills": 
    [
      {
        "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
        "categories": [ "Organization" ],
        "defaultLanguageCode": "en",
        "inputs": [
          {
            "name": "text", "source": "/document/content"
          }
        ],
        "outputs": [
          {
            "name": "organizations", "targetName": "organizations"
          }
        ]
      }
    ],
    "cognitiveServices": {
        "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
        "description": "mycogsvcs",
        "key": "<your key goes here>"
    }
}

.NET SDK

Il frammento di codice seguente proviene da azure-search-dotnet-samples, tagliato per brevità.

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 i servizi di intelligenza artificiale di Azure, seguire queste istruzioni per rimuovere la chiave in più aree e impedire l'uso della risorsa esterna. 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.

Azure portal

1. Accedere al portale di Azure e aprire la pagina Panoramica del servizio di ricerca.

2. In Set di competenze selezionare il set di competenze contenente la chiave da rimuovere.

   

3. Scorrere fino alla fine del file.

4. Rimuovere la chiave dal codice JSON e salvare il set di competenze.

   

REST

1. Ottenere il set di competenze in modo da avere la definizione completa.

2. Formulare una richiesta del set di competenze di aggiornamento, fornendo la definizione JSON del set di competenze.

3. Rimuovere la chiave nel corpo della definizione e quindi inviare la richiesta:

   PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2020-06-30
   api-key: [admin key]
   Content-Type: application/json
   {
       "name": "skillset name",
       "skills": 
       [
         {
           "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
           "categories": [ "Organization" ],
           "defaultLanguageCode": "en",
           "inputs": [
             {
               "name": "text", "source": "/document/content"
             }
           ],
           "outputs": [
             {
               "name": "organizations", "targetName": "organizations"
             }
           ]
         }
       ],
       "cognitiveServices": {
           "@odata.type": "#Microsoft.Azure.Search.CognitiveServicesByKey",
           "description": "mycogsvcs",
           "key": ""
       }
   }
   

   In alternativa, è possibile impostare "cognitiveServices" su null:

   "cognitiveServices": null,
   

Come viene usata la chiave

La fatturazione basata su chiave si applica quando le chiamate API alle risorse dei servizi di intelligenza artificiale di Azure superano 20 chiamate API per indicizzatore, al giorno.

La chiave viene usata per la fatturazione, ma non per le connessioni delle operazioni di arricchimento. Per le connessioni, un servizio di ricerca si connette tramite la rete interna a una risorsa dei servizi di intelligenza artificiale di Azure che si trova nella stessa area fisica. La maggior parte delle aree che offrono Ricerca di intelligenza artificiale di Azure offre anche altri servizi di intelligenza artificiale di Azure, ad esempio Language. Se si tenta l'arricchimento tramite intelligenza artificiale in un'area che non dispone di entrambi i servizi, verrà visualizzato questo messaggio: "La chiave fornita non è una chiave di tipo CognitiveServices valida per l'area del servizio di ricerca".

Attualmente, la fatturazione per le competenze predefinite richiede una connessione pubblica da Ricerca di intelligenza artificiale di Azure a un altro servizio di intelligenza artificiale di Azure. La disabilitazione dell'accesso alla rete pubblica interrompe la fatturazione. Se la disabilitazione delle reti pubbliche è un requisito, è possibile configurare una competenza dell'API Web personalizzata implementata con una funzione di Azure che supporta gli endpoint privati e aggiungere la risorsa dei servizi di intelligenza artificiale di Azure alla stessa rete virtuale. In questo modo, è possibile chiamare la risorsa dei servizi di intelligenza artificiale di Azure direttamente dalla competenza personalizzata usando endpoint privati.

Nota

Alcune competenze predefinite si basano su servizi di intelligenza artificiale di Azure non regionali, ad esempio la competenza traduzione testuale. L'uso di una competenza non a livello di area significa che la richiesta potrebbe essere usata in un'area diversa dall'area di Ricerca di intelligenza artificiale di Azure. Per altre informazioni sui servizi non regionali, vedere la pagina relativa ai servizi di intelligenza artificiale di Azure per area .

Requisiti chiave casi speciali

Ricerca entità personalizzata viene misurata da Ricerca di intelligenza artificiale di Azure, non dai servizi di intelligenza artificiale di Azure, ma richiede una chiave di risorsa multiservizio di Azure per sbloccare le transazioni oltre 20 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 multiservizio di Azure AI. Gli arricchimenti gratuiti sono 20 documenti al giorno, per indicizzatore. È 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 i servizi di intelligenza artificiale di Azure (vale a dire condizionale, estrazione documenti, shaper, unione di testo e suddivisione del 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 del documento, 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, Ricerca di intelligenza artificiale di Azure chiama le API dei servizi di intelligenza artificiale di Azure per le competenze predefinite basate su Visione artificiale di Azure, Traduttore e sul linguaggio di intelligenza artificiale di Azure.

Le competenze predefinite fatturabili che effettuano chiamate back-end ai servizi di intelligenza artificiale di Azure includono Entity Linking, Riconoscimento entità, Analisi immagini, Estrazione frasi chiave, Rilevamento lingua, OCR, rilevamento delle informazioni personali, sentiment e traduzione testuale.

L'estrazione di immagini è un'operazione di Ricerca di intelligenza artificiale di Azure che si verifica quando i documenti vengono violati prima dell'arricchimento. L'estrazione delle immagini è fatturabile in tutti i livelli, ad eccezione di 20 estrazione giornaliera gratuita 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 per le immagini estratte tramite Estrazione documenti. Per i prezzi di estrazione delle immagini, vedere la pagina dei prezzi di Ricerca di intelligenza artificiale di Azure.

Suggerimento

Per ridurre il costo dell'elaborazione del set di competenze, abilitare l'arricchimento incrementale (anteprima) per memorizzare nella cache e riutilizzare eventuali arricchimenti non interessati dalle modifiche apportate a un set di competenze. La memorizzazione nella cache richiede Archiviazione di Azure (vedere i prezzi, ma il costo cumulativo dell'esecuzione del set di competenze è inferiore se è possibile riutilizzare gli arricchimenti esistenti, soprattutto per i set di competenze che usano l'estrazione e l'analisi delle immagini.

Esempio: Stimare i costi

Per stimare i costi associati all'indicizzazione di Ricerca di intelligenza artificiale di Azure, 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 supponga che una pipeline costituita dal cracking dei documenti di ogni PDF, estrazione di immagini e testo, riconoscimento ottico dei caratteri (OCR) di immagini e riconoscimento delle entità delle organizzazioni.

I prezzi illustrati in questo articolo sono ipotetici. Vengono usati per illustrare il processo di stima. I costi potrebbero essere inferiori. Per il prezzo effettivo delle transazioni, vedere Prezzi dei servizi di intelligenza artificiale di Azure.

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

2. Per il riconoscimento ottico dei caratteri di 6.000 immagini in inglese, la competenza cognitiva OCR usa l'algoritmo migliore (DescribeText). Supponendo un costo di 2,50 dollari per l’analisi di 1.000 immagini, il costo raggiunto in questo passaggio sarebbe di 15 dollari.

3. Per l'estrazione di entità, si dispone di un totale di tre record di testo per pagina. (ogni record è composto da 1.000 caratteri). Tre record di testo per pagina moltiplicati per 6.000 pagine uguali a 18.000 record di testo. Supponendo un prezzo di 2 dollari ogni 1.000 record di testo, in questo passaggio si raggiungerebbe un costo di 36 dollari.

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

Passaggi successivi

• Pagina dei prezzi di Ricerca intelligenza artificiale di Azure
• Come definire un set di competenze
• Creare un set di competenze (REST)
• Come eseguire il mapping dei campi arricchiti