Modalità agentic per l'analisi dei documenti (anteprima)

La modalità agentic in Azure Content Understanding in Foundry Tools analizza documenti complessi quando una risposta deve essere compilata da prove anziché estratte da un'unica posizione. Può ragionare in un documento, eseguire calcoli, convalidare i risultati, interpretare le informazioni visive e restituire campi strutturati corrispondenti allo schema.

Quando usare la modalità agentic

La modalità agentic è l'opzione Di comprensione dei contenuti più avanzata per i problemi di analisi dei documenti più complessi. Se l'estrazione standard non produce il risultato necessario, provare la modalità agentic quando si ragiona ulteriormente sui dati nel file di input potrebbe creare una risposta migliore. La modalità agentica applica il massimo sforzo di ragionamento del servizio per ottenere il massimo dalle sue funzionalità di intelligenza artificiale.

Usare la modalità agentic per gli scenari di documento che richiedono una o più di queste funzionalità:

• Ragionamento a più passaggi: connettere le informazioni correlate in parti diverse di un documento per costruire una risposta.
• Calcoli: derivare valori come totali, differenze o riconciliazione non indicati direttamente.
• Convalida: controllare i valori per la coerenza interna o contro le condizioni nelle descrizioni dei campi.
• Analisi visiva: usare informazioni in tabelle complesse, figure, moduli e altri elementi visivi nell'ambito dell'analisi.
• Output strutturato: restituisce il risultato come campi conformi allo schema dell'analizzatore.

Ad esempio, utilizzare la modalità agentic per riconciliare i valori in un report finanziario, verificare se un documento soddisfa un set di requisiti o analizzare la correlazione tra un contratto e le relative modifiche nello stesso file.

La modalità agentic può estrarre campi da un singolo documento o motivo in più documenti logici contenuti nel file di input.

Per l'estrazione diretta dei campi, usare un analizzatore di documenti standard. La modalità agentica non è una sostituzione per la revisione umana in scenari ad alto impatto.

Selezionare il flusso di lavoro agentico

Impostare config.workflow quando si crea un analizzatore di documenti usando la versione 2026-06-01-previewdell'API :

• Usare "default"o omettere workflowper consentire al servizio di selezionare il flusso di lavoro standard o avanzato in base alla configurazione dell'analizzatore.
• Usare "agentic" per abilitare la modalità agente.

{
  "description": "Calculate and validate totals in an invoice",
  "baseAnalyzerId": "prebuilt-document",
  "models": {
    "completion": "gpt-5.2"
  },
  "config": {
    "workflow": "agentic" // Agentic workflow selector
  },
  "fieldSchema": {
    "fields": {
      ...
    }
  }
}

Il valore inviato è un selettore in fase di creazione. Dopo aver creato l'analizzatore, config.workflow contiene un valore risolto e con controllo delle versioni. Ad esempio, "agentic" risolve a "agentic.2026-06-01-preview". Per le regole di risoluzione, vedere workflow.

Costi e latenza

Il flusso di lavoro risolto agentic.* usa la frequenza di contestualizzazione avanzata. La modalità agentic utilizza anche più token del modello rispetto a un flusso di lavoro standard e in genere richiede più tempo per lo stesso documento. Eseguire test con documenti rappresentativi per determinare se il miglioramento della qualità soddisfa i requisiti di latenza e costi.

Per altre informazioni, vedere Informazioni sui prezzi di Content Understanding.

Limitazioni dell'anteprima

L'anteprima iniziale presenta queste limitazioni:

• Ogni richiesta di analisi supporta un file di input.
• La modalità agentic supporta solo analizzatori di documenti.
• I campi che usano il extract metodo non sono supportati.
• L'uso di esempi etichettati per migliorare l'analizzatore non è supportato.

Per altri limiti di input, vedere Quote e limiti del servizio.

Eseguire la migrazione dalla modalità Pro

La modalità Pro è disponibile solo nell'API 2025-05-01-preview , ora ritirata. Eseguire la migrazione alla modalità agentic nell'API 2026-06-01-preview .

Quando si esegue la migrazione, tenere presenti le differenze seguenti:

• Configurare la modalità agentic tramite l'API 2026-06-01-preview impostando config.workflow su "agentic". Dopo la creazione, il servizio restituisce il valore "agentic.2026-06-01-preview"risolto . La modalità agente non è una sostituzione dell'agente per la 2025-05-01-preview configurazione della modalità pro. Esaminare lo schema dell'analizzatore e del campo con la documentazione relativa alla modalità agentic prima di eseguire la migrazione.
• L'anteprima della modalità agente iniziale supporta un file di input per ogni richiesta di analisi. Se il flusso di lavoro in modalità Pro si basa su più documenti di input o dati di riferimento, verificare che la modalità agente supporti lo scenario prima di eseguire la migrazione.

Contenuti correlati

Usare queste risorse per altre informazioni sugli analizzatori, l'elaborazione dei documenti e i prezzi:

• Guida introduttiva: Analizzare un documento con la modalità agentic
• Che cos'è un analizzatore content Understanding?
• Panoramica dell'elaborazione dei documenti