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

Articolo
01/22/2025

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 un account multiservizio di Azure per intelligenza artificiale fatturabile.

Ricerca di intelligenza artificiale di Azure usa risorse dedicate ospitate internamente in Azure PER intelligenza artificiale multiservizio per l'esecuzione predefinita delle competenze, ma richiede l'account multiservizio a scopo di fatturazione.

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 gli incorporamenti migrati
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

Le eccezioni alla fatturazione tramite l'account 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 multi-risorsa di Intelligenza artificiale di Azure, è 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 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 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 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.

Configurare Ricerca intelligenza artificiale di Azure per l'uso di un'identità gestita.
Nella risorsa multiservizio di Intelligenza artificiale di Azure assegnare l'identità al ruolo utente di Servizi cognitivi.
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. 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. 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 @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 le transazioni 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.

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.

L'account multiservizio azure per intelligenza artificiale 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.

Accedere al portale di Azure.
Creare una risorsa multiservizio di Azure per intelligenza artificiale nella stessa area del servizio di ricerca.
Ottenere la chiave di risorsa dalla pagina Chiavi>risorse ed endpoint.
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.

Nota

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

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

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
REST

Accedere al portale di Azure.
In Set di competenze di gestione della ricerca > selezionare un set di competenze dall'elenco.
Scorrere fino alla sezione nel file contenente "cognitiveServices".
Eliminare il valore della chiave dal codice JSON e salvare il set di competenze.

Ottenere il set di competenze in modo da avere la definizione completa.
Formulare una richiesta di aggiornamento del set di competenze, fornendo la definizione JSON del set di competenze.

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, verrà 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 Azure per intelligenza artificiale 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 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 intelligenza artificiale di Azure includono Entity Linking, Entity Recognition, Image Analysis, Key Phrase Extraction, Language Detection, OCR, Personally Identifiable Information (PII) Detection, Sentiment, Text Translation e La competenza di incorporamenti cluster di Visione artificiale di Azure.

Un vettore in fase di query supportato dal modello di incorporamento bidirezionale di Visione artificiale di Azure è 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, 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.

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.
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.
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.

Condividi tramite

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

Prerequisiti

Fatturare tramite una connessione senza chiave

Esempio: identità gestita assegnata dal sistema

Esempio: identità gestita assegnata dall'utente

Fatturare tramite una chiave di risorsa

Rimuovere la chiave

Come viene usata la chiave

Requisiti di connessione pubblica

Casi speciali di requisiti chiave

Arricchimenti gratuiti

Arricchimenti fatturabili

Esempio: Stimare i costi

Passaggi successivi

Commenti e suggerimenti

Risorse aggiuntive