Collegare una risorsa dei servizi di intelligenza artificiale di Azure a un set di competenze in Ricerca di intelligenza artificiale di Azure

Se si usano competenze predefinite per l'arricchimento facoltativo di intelligenza artificiale in Ricerca di intelligenza artificiale di Azure, è possibile arricchire gratuitamente un numero ridotto di documenti, limitato a 20 transazioni giornaliere per indice. Per carichi di lavoro più grandi e più frequenti, è consigliabile collegare una risorsa multiservizio per i servizi di intelligenza artificiale di Azure fatturabile.

Azure AI Ricerca utilizza risorse multiservizio dedicate e ospitate internamente dai servizi Azure AI per l'esecuzione delle abilità predefinite, ma richiede la tua risorsa multiservizio a scopo di fatturazione.

Una risorsa multiservizio dei servizi di intelligenza artificiale di Azure offre una raccolta di servizi di intelligenza artificiale di Azure, anziché singoli servizi. La configurazione di una risorsa multiservizio in un set di competenze di Ricerca Intelligenza Artificiale di Azure permette a Microsoft di addebitare l'utilizzo di questi servizi:

• Azure AI Vision per l'analisi delle immagini, il riconoscimento ottico dei caratteri (OCR) e gli embedding multimodali
• Azure AI Language per il rilevamento del linguaggio, il riconoscimento delle entità, l'analisi del sentiment 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

Le eccezioni alla fatturazione tramite la risorsa multiservizio includono AzureOpenAIEmbedding o la fatturazione delle competenze AML. Ricerca di intelligenza artificiale di Azure non ospita internamente i modelli da Azure OpenAI o dal catalogo dei modelli di Azure AI Foundry. L'uso delle competenze e dei vettori AML e Di Azure OpenAI è tramite i prezzi con pagamento in base al consumo di Azure OpenAI e i prezzi con pagamento in base al consumo di Azure Machine Learning, rispettivamente. Alcune altre competenze, ad esempio Suddivisione testo e Unione testo, non sono fatturabili.

Per collegare una risorsa multiservizio di Azure per intelligenza artificiale, è necessario fornire le informazioni di connessione nel set di 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 una risorsa multiservizio di Servizi di intelligenza artificiale di Azure.
• Risorsa multiservizio di Azure per intelligenza artificiale creata tramite il [portale di Azure[(https://portal.azure.com) solo.

Nota

Se la risorsa di Intelligenza artificiale di Azure è configurata per l'uso di un endpoint privato, Ricerca intelligenza artificiale di Azure può connettersi usando un collegamento privato condiviso. Per altre informazioni, vedere i requisiti e i limiti per l'uso di collegamenti privati condivisi.

Fatturare tramite una connessione senza chiave

Nota

Questa funzionalità è attualmente in anteprima pubblica. Questa anteprima viene fornita senza un 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 il portale di Azure o le API REST di anteprima più recenti e i pacchetti beta SDK, è possibile collegare una risorsa multiservizio di Servizi di intelligenza artificiale di Azure usando un'identità gestita e le autorizzazioni. Il vantaggio di questo approccio è che la fatturazione è senza chiave e non ha alcuna dipendenza dalle aree.

1. Configurare Ricerca AI di Azure per utilizzare un'identità gestita.

2. Nella risorsa multiservizio dei servizi di intelligenza artificiale di Azure, assegna l'identità al ruolo Utente servizi cognitivi.

3. Usando il portale di Azure, l'API REST set di competenze 2024-11-01-preview o successive, 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. Può essere gestita dal sistema o assegnata dall'utente.

   • L'identità deve disporre dei permessi di 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 dei servizi di intelligenza artificiale di Azure. L'URL del sottodominio deve includere un nome univoco, ad esempio https://hereismyuniquename.cognitiveservices.azure.com. Se il servizio è stato creato tramite il portale di Azure, un sottodominio univoco viene generato automaticamente come parte della configurazione del servizio. Assicurarsi che il servizio includa un sottodominio univoco prima di usarlo con l'integrazione di Ricerca 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 proprietà @odata.type 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

Azure AI Search può anche pagare per le transazioni usando la chiave di risorsa multiservizio di Servizi di intelligenza artificiale di Azure. 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.

Esistono due tipi di chiave supportati: #Microsoft.Azure.Search.CognitiveServicesByKey che chiama l'endpoint a livello di area e "#Microsoft.Azure.Search.AIServicesByKey che chiama il sottodominio. È consigliabile usare AIServicesByKey per il supporto dei collegamenti privati condivisi e la possibilità di funzionare senza requisiti a livello di area relativi al servizio di ricerca.

La risorsa multiservizio dei servizi di intelligenza artificiale di Azure deve trovarsi nella stessa area di Ricerca di intelligenza artificiale di Azure. Per altre informazioni, vedere Aree supportate da Ricerca di intelligenza artificiale di Azure e scegliere un'area che fornisce l'integrazione dei servizi di intelligenza artificiale.

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.

Portale di Azure

1. Accedere al portale di Azure.

2. Creare una risorsa multiservizio di Servizi di intelligenza artificiale di Azure 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 di Importazione guidata dati, creare o selezionare la risorsa dei servizi di Azure AI. 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.

Nota

portale di Azure allega automaticamente la chiave di tipo #Microsoft.Azure.Search.CognitiveServicesByKey.

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-11-01-Preview
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.AIServicesByKey",
        "description": "mycogsvcs",
        "subdomainUrl": “https://[subdomain-name].cognitiveservices.azure.com",
        "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.

Portale di Azure

1. Accedere al portale di Azure.

2. In gestione ricerca > Set di competenze, 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 basate su chiave, 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 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, 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, destinata a una risorsa multiservizio di Servizi di Azure AI specificata come URI completo, con un sottodominio univoco in tale URI.

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 la risorsa multiservizio con provisioning interno dei Servizi di Azure AI 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 Azure AI Search ai Servizi di Azure AI multiservizio. 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

Ricerca entità personalizzata è misurata da Azure AI Search, non dai servizi Azure AI, ma richiede una chiave di risorsa multiservizio dei servizi Azure AI per sbloccare le transazioni oltre le 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 Servizi di intelligenza artificiale di Azure. 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 e viene pertanto menzionata 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 intelligenza artificiale di Azure includono Entity Linking, Entity Recognition, Image Analysis, Key Phrase Extraction, Language Detection, OCR, Rilevamento di informazioni personali identificabili (PII), Sentiment, Text Translation e la competenza di incorporamenti multimodali di Azure AI Vision.

Un vettore in fase di query supportato dal modello di incorporamento bidirezionale di Visione di Azure AI è anche un arricchimento fatturabile.

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, partire da un'idea di come appare un documento medio, in modo da poter fare alcuni calcoli. 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 dalla scomposizione di ogni PDF, dall'estrazione di testo e immagini, dal riconoscimento ottico dei caratteri (OCR) delle immagini e dal riconoscimento delle entità relative alle 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 la decifrazione di documenti con contenuto di testo e immagini, l'estrazione di testo è gratuita al momento. 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