Collegare una risorsa multiservizio di Azure per intelligenza artificiale a un set di competenze in Azure AI Search

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

Un account multiservizio fornisce una raccolta di servizi di intelligenza artificiale di Azure, anziché di singoli servizi. La fornitura di un account in un set di competenze di Ricerca intelligenza artificiale di Azure consente a Microsoft di addebitare l'utente per l'uso di questi servizi:

• Visione artificiale di Azure per l'analisi delle immagini, il riconoscimento ottico dei caratteri (OCR) e il testo e l'incorporamento diimmaginii.
• Lingua di Azure AI per il rilevamento del linguaggio, il riconoscimento delle entità, l'analisi valutazione e l'estrazione di frasi chiave
• Voce di Azure AI per il riconoscimento vocale e la sintesi vocale
• Traduttore per Azure AI per la traduzione testuale automatica

È necessario fornire informazioni di connessione alla risorsa multi-risorsa di Intelligenza artificiale di Azure nel set di competenze. Ricerca di intelligenza artificiale di Azure non usa la connessione per i carichi di lavoro del set di competenze, ma usa la connessione per accedere ai contatori di fatturazione nella risorsa. Di conseguenza, l'account dei servizi di intelligenza artificiale di Azure viene usato per la fatturazione, non per l'elaborazione delle competenze. Ricerca di intelligenza artificiale di Azure usa risorse dedicate separate per l'elaborazione delle competenze.

È possibile usare una chiave nella connessione o implementare un approccio senza chiave attualmente in anteprima.

Suggerimento

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

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 un account multiservizio di Intelligenza artificiale di Azure.

Nota

Se la risorsa di Intelligenza artificiale di Azure è configurata per l'uso di un endpoint privato, Ricerca di intelligenza artificiale di Azure può connettersi usando un collegamento privato condiviso se il servizio di ricerca è stato creato dopo il 3 aprile 2024 e si trova in un'area che offre una potenza di calcolo della capacità superiore ed è in un livello supportato. Per altre informazioni, vedere i requisiti per l'uso di collegamenti privati condivisi.

Fatturare tramite una connessione senza chiave

Nota

Questa funzionalità è attualmente in anteprima pubblica. Questa anteprima viene messa a disposizione senza contratto di servizio e non è consigliata per i carichi di lavoro di produzione. Alcune funzionalità potrebbero non essere supportate o potrebbero presentare funzionalità limitate. Per altre informazioni, vedere le Condizioni supplementari per l'uso delle anteprime di Microsoft Azure.

Usando le API REST di anteprima portale di Azure o versioni successive e i pacchetti beta SDK, è possibile collegare una risorsa multiservizio di Azure AI usando un'identità gestita e autorizzazioni. Il vantaggio di questo approccio è che la fatturazione è senza chiave e non ha alcuna dipendenza dalle aree.

1. Configurare Ricerca intelligenza artificiale di Azure per l'uso di un'identità gestita.

2. Nella risorsa multiservizio di Intelligenza artificiale di Azure assegnare l'identità al ruolo utente di Servizi cognitivi.

3. Usando il portale di Azure o l'API REST skillset 2024-11-01-preview o un pacchetto beta di Azure SDK che fornisce la sintassi, configurare un set di competenze per l'uso di un'identità:

   • L'identità gestita usata nella connessione appartiene al servizio di ricerca.
   • L'identità può essere gestita dal sistema o assegnata dall'utente.
   • L'identità deve disporre delle autorizzazioni utente di Servizi cognitivi per la risorsa di intelligenza artificiale di Azure.
   • @odata.type è sempre #Microsoft.Azure.Search.AIServicesByIdentity.
   • subdomainUrl è l'endpoint della risorsa multiservizio di Intelligenza artificiale di Azure. Può trovarsi in qualsiasi area supportata congiuntamente da Ricerca di intelligenza artificiale di Azure e dai servizi di intelligenza artificiale di Azure.

Come per le chiavi, i dettagli forniti sulla risorsa di Servizi di intelligenza artificiale di Azure vengono usati per la fatturazione, non per le connessioni. Tutte le richieste API effettuate da Ricerca di intelligenza artificiale di Azure ai servizi di intelligenza artificiale di Azure per l'elaborazione predefinita delle competenze continuano a essere interne e gestite da Microsoft.

Esempio: identità gestita assegnata dal sistema

Identity è impostato su Null.

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": null 
    }  
} 

Esempio: identità gestita assegnata dall'utente

L'identità è impostata sull'ID risorsa dell'identità gestita assegnata dall'utente. Per trovare un'identità gestita assegnata dall'utente esistente, vedere Gestire le identità gestite assegnate dall'utente.

Per un'identità gestita assegnata dall'utente, impostare le @odata.type proprietà e userAssignedIdentity .

POST https://[service-name].search.windows.net/skillsets/[skillset-name]?api-version=2024-11-01-Preview  

{  
    "name": "my skillset name",  
    "skills":   
    [  
      // skills definition goes here 
    ],  
    "cognitiveServices": {  
        "@odata.type": "#Microsoft.Azure.Search.AIServicesByIdentity",  
        "description": "",  
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",  
        "identity": {   
            "@odata.type":  "#Microsoft.Azure.Search.DataUserAssignedIdentity",   
            "userAssignedIdentity": ""/subscriptions/{subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-assigned-managed-identity-name}"" 
        }
    } 
}

Fatturare tramite una chiave di risorsa

Ricerca di intelligenza artificiale di Azure può anche pagare per la transazione usando la chiave di risorsa multiservizio di Azure per intelligenza artificiale. Questo approccio è l'impostazione predefinita ed è disponibile a livello generale. È possibile usare il portale di Azure, l'API REST o azure SDK per aggiungere la chiave a un set di competenze.

È sufficiente aggiungere la chiave, non il sottodominio o l'endpoint. Se la cognitiveServices 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 Azure per intelligenza artificiale nella stessa area del servizio di ricerca.

3. Ottenere la chiave di risorsa dalla pagina Chiavi>risorse ed endpoint.

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

   • Se si usa una procedura guidata Importa dati, creare o selezionare l'account azure per intelligenza artificiale. La procedura guidata aggiunge la chiave di risorsa alla definizione del set di competenze.

   • Per un set di competenze nuovo o esistente, fornire la chiave nella definizione del set di competenze.

REST

1. Usare l'API Crea o Aggiorna set di competenze specificando cognitiveServices la sezione nel corpo della richiesta:

PUT https://[servicename].search.windows.net/skillsets/[skillset name]?api-version=2024-07-01
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 multiservizio 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.

2. In Set di competenze di gestione della ricerca > selezionare un set di competenze dall'elenco.

   

3. Scorrere fino alla sezione nel file contenente "cognitiveServices".

4. Eliminare il valore della 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 di aggiornamento del set di competenze, 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=2024-07-01
   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 diventa effettiva quando le chiamate API alle risorse dei servizi di intelligenza artificiale di Azure 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 delle operazioni di arricchimento. Per le connessioni, un servizio di ricerca si connette tramite la rete interna a una risorsa dei Servizi di Azure AI che si trova nella stessa area fisica. La maggior parte delle aree che offrono Azure AI Search 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".

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 l'ambiente di esecuzione privata, Ricerca di intelligenza artificiale di Azure usa ancora la risorsa multiservizio con provisioning interno di Azure per intelligenza artificiale per eseguire tutti gli arricchimenti delle competenze.

Nota

Alcune competenze predefinite si basano su servizi di intelligenza artificiale di Azure non a livello di area, 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 da quella di Azure AI Search. Per altre informazioni sui servizi non a livello di area, vedere la pagina Prodotto Servizi di Azure AI in base all'area.

Requisiti di connessione pubblica

A seconda della creazione del servizio di ricerca e del relativo livello e area, la fatturazione per le competenze predefinite può richiedere una connessione pubblica da Ricerca di intelligenza artificiale di Azure a servizi multiservizio di Azure per intelligenza artificiale. 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 competenza 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 Azure AI direttamente dalla competenza personalizzata usando endpoint privati.

Casi speciali di requisiti chiave

La Ricerca di entità personalizzate viene misurata da Azure AI Search, non dai Servizi di Azure AI, ma richiede una chiave di risorsa multiservizio di Azure per sbloccare le transazioni successive a 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 dell'utilità che non chiamano i Servizi di Azure AI (vale a dire Condizionale, Estrazione documenti, Shaper, Unione di testoe competenze di 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 di 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 dei Servizi di Azure AI per le competenze predefinite basate su Visione artificiale di Azure, Traduttore e Azure AI Language.

Le competenze predefinite fatturabili che effettuano chiamate back-end ai Servizi di Azure AI includono Collegamento delle entità, Riconoscimento di entità, Analisi delle immagini, Estrazione frasi chiave, Rilevamento lingua, OCR, Informazioni personali, Valutazionee Traduzione testo.

L'estrazione di immagini è un'operazione di Azure AI Search che si verifica quando i documenti vengono decifrati prima dell'arricchimento. L'estrazione delle immagini è fatturabile in tutti i livelli, ad eccezione di 20 estrazioni 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 per le immagini estratte usando Estrazione documenti. Per i prezzi dell'estrazione di immagini, vedere la pagina dei prezzi di Azure AI Search.

Suggerimento

Per ridurre il costo dell'elaborazione del set di competenze, abilitare l'arricchimento incrementale 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 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 Azure AI Search, iniziare con un'idea dell'aspetto di un documento medio in modo da poter vedere i primi numeri. Ad esempio, è possibile approssimare:

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

Si supponga di avere una pipeline costituita dall'individuazione del documento di ogni file PDF con estrazione di testo e immagini, riconoscimento ottico dei caratteri (OCR) delle immagini e riconoscimento di entità delle organizzazioni.

I prezzi illustrati in questo articolo sono illustrativi e vengono usati per spiegare il processo di stima. I costi potrebbero essere inferiori. Per il prezzo effettivo delle transazioni, vedere Prezzi dei Servizi di Azure AI.

1. Per l'individuazione di documenti con contenuto di testo e immagini, attualmente l'estrazione di testo è gratuita. Per 6,000 immagini, si supponga un costo di 1 dollaro per ogni 1.000 immagini estratte. Si tratta di 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 delle entità, abbiamo un totale di 3 record di testo per ogni 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.

Unendo i due passaggi, si arriverebbe a pagare circa 57 dollari per inserire 1.000 documenti PDF di questo tipo con il set di competenze descritto.

Passaggi successivi

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