Guida introduttiva: Usare le operazioni sincrone di Analisi del contenuto

Le operazioni sincrone funzionano meglio per scenari interattivi che richiedono immediatamente contenuto estratto o che vogliono evitare l'archiviazione temporanea sul lato servizio durante l'elaborazione. Queste operazioni elaborano l'input in memoria e restituiscono contenuto strutturato direttamente nella risposta. Non si invia una richiesta separata per verificare il risultato. In questa anteprima pubblica, le operazioni sincrone sono disponibili per gli prebuilt-read analizzatori e prebuilt-layout .

Le operazioni sincrone supportano gli stessi formati di file di documento delle operazioni asincrone. Per i limiti relativi alle dimensioni, alle pagine, ai caratteri e agli intervalli di pagine, vedere Limiti del servizio Content Understanding.

Prerequisiti

  • Una sottoscrizione di Azure attiva. Se non si ha un account Azure, crearne uno gratuitamente.
  • Una risorsa Microsoft Foundry in un'area supportata. Per creare la risorsa, è necessario il ruolo Collaboratore o un ruolo superiore nella sottoscrizione o nel gruppo di risorse di destinazione.
  • Installato cURL per l'ambiente di sviluppo.

Questa guida introduttiva illustra come usare le operazioni di lettura e layout sincrone nell'API REST Content Understanding per estrarre contenuto strutturato da documenti e immagini di piccole dimensioni. Gli prebuilt-read analizzatori e prebuilt-layout supportano due operazioni sincrone:

  • analyzeInline accetta un URL come contenuto di input.
  • analyzeBinaryInline accetta un file binario come contenuto di input.

Estrarre testo da un'immagine con Lettura

La richiesta seguente invia un'immagine come dati binari all'operazione di lettura sincrona (prebuilt-read:analyzeBinaryInline). Sostituire {your-resource-endpoint}, {your-subscription-key}e il percorso del file locale con i valori.

curl --request POST \
  --url 'https://{your-resource-endpoint}/contentunderstanding/analyzers/prebuilt-read:analyzeBinaryInline?api-version=2026-06-01-preview' \
  --header 'Content-Type: application/octet-stream' \
  --header 'Ocp-Apim-Subscription-Key: {your-subscription-key}' \
  --data-binary '@D:\\Demo\\InsuranceCard.png'

La risposta contiene il testo estratto e le informazioni sulla posizione dall'immagine. Poiché si tratta di un'operazione sincrona, la risposta contiene direttamente il risultato dell'analisi. Non è necessario copiare un valore o eseguire il Operation-Location polling per ottenere un risultato.

Per altre informazioni, vedere Analizzatori del contenuto - Analizzare il file binario.

Estrarre la struttura del documento con layout

La richiesta seguente invia un URL del documento all'operazione di layout sincrono. Sostituire {your-resource-endpoint} e {your-subscription-key} con i propri valori. L'URL deve essere accessibile alla risorsa Content Understanding.

curl --request POST \
  --url 'https://{your-resource-endpoint}/contentunderstanding/analyzers/prebuilt-layout:analyzeInline?api-version=2026-06-01-preview' \
  --header 'Content-Type: application/json' \
  --header 'Ocp-Apim-Subscription-Key: {your-subscription-key}' \
  --data '{
    "inputs": [
      {
        "url": "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/rest-api/layout.png"
      }
    ]
  }'

La risposta contiene il contenuto estratto e la struttura del documento, ad esempio tabelle, sezioni, figure, formattazione, collegamenti ipertestuali e firme, se supportate. La risposta include anche informazioni sull'utilizzo per l'operazione.

Per altre informazioni, vedere Analizzatori del contenuto - Analizza.

Scegliere tra operazioni sincrone e asincrone

Usare operazioni sincrone quando l'applicazione richiede immediatamente il risultato, l'input rientra nei limiti sincroni o l'elaborazione di documenti in memoria è importante per lo scenario in uso. Usare operazioni asincrone per input di dimensioni maggiori o analisi con esecuzione più lunga. Per un esempio asincrono, vedere Avvio rapido: Usare l'API REST Content Understanding.

Passaggi successivi

  • Last updated on