Analizzare documenti e testo in blocchi come stringhe con token per i flussi di lavoro in App per la logica di Azure

Si applica a: App per la logica di Azure (Consumo + Standard)

In alcuni casi è necessario convertire il contenuto in token, ovvero parole o blocchi di caratteri, oppure dividere un documento di grandi dimensioni in parti più piccole prima di poter usare questo contenuto con azioni specifiche. Ad esempio, le azioni Azure AI Search o Azure OpenAI prevedono input con token e possono gestire solo un numero limitato di token.

Per questi scenari, usare le azioni di Operazioni dati denominate Analizzare un documento e Suddividere testo in blocchi nel flusso di lavoro dell'app per la logica. Queste azioni trasformano rispettivamente il contenuto, ad esempio un documento PDF, un file CSV, un file Excel e così via, in una stringa tokenizzata e quindi suddivide la stringa in parti, in base al numero di token. È possibile quindi fare riferimento e usare questi output con le azioni successive previste dal flusso di lavoro.

Questa guida illustra come aggiungere e configurare azioni per l'analisi dei documenti e la suddivisione in blocchi del flusso di lavoro.

Problemi noti e limitazioni

• Nei flussi di lavoro a consumo l'azione Parse un documento è disponibile solo nelle aree Azure seguenti:

  • Australia orientale
  • Brasile meridionale
  • Asia orientale
  • Stati Uniti orientali
  • Stati Uniti orientali 2
  • North Europe
  • Stati Uniti centro-meridionali
  • Sud-est asiatico
  • Svezia centrale
  • West US 2 (Regione Ovest degli Stati Uniti 2)
  • Stati Uniti occidentali 3
  • UK South

  Queste regioni forniscono connessioni all'origine dati, tracciamento dei documenti, suddivisione dei documenti, supporto per i modelli di incorporamento di Azure OpenAI e supporto predefinito per l'indicizzazione per l'estrazione dei dati. Per altre informazioni, vedere Indicizzazione automatica in Ricerca di intelligenza artificiale con flussi di lavoro in App per la logica di Azure.

• Le azioni Analizzare un documento e Suddividere testo in blocchi non supportano attualmente file host come i file binari mainframe e di fascia intermedia, ad esempio i file VSAM (Virtual Storage Access Method). Tuttavia, se si usano flussi di lavoro Standard, è possibile usare l'azione predefinita IBM Host File denominata Analizza contenuto file host.

Prerequisiti

• Un account e una sottoscrizione Azure. Se non si ha una sottoscrizione Azure, iscriversi per ottenere un account Azure gratuito.

• Un flusso di lavoro dell'app per la logica A consumo o Standard con un trigger esistente perché le operazioni Analizzare un documento e Suddividere testo in blocchi sono disponibili solo come azioni. Assicurarsi che l'azione che recupera il contenuto da analizzare o da suddividere in blocchi preceda queste operazioni sui dati.

Analizzare un documento

L'azione Parse un documento converte il contenuto, ad esempio un documento PDF, un file CSV, Excel file e così via, in una stringa con token. Per questo esempio, si supponga che il flusso di lavoro inizi con il trigger Di richiesta denominato Quando viene ricevuta una richiesta HTTP. Questo trigger attende di ricevere una richiesta HTTP inviata da un altro componente, ad esempio una funzione Azure, un altro flusso di lavoro dell'app per la logica e così via. La richiesta HTTP include l'URL di un nuovo documento caricato disponibile per essere recuperato e analizzato dal flusso di lavoro. Un'azione HTTP segue immediatamente il trigger, invia una richiesta HTTP all'URL del documento e restituisce il contenuto del documento dalla relativa posizione di archiviazione.

Se si usano altre origini di contenuto, ad esempio Archiviazione BLOB di Azure, SharePoint, OneDrive, file system, FTP e così via, è possibile verificare se i trigger sono disponibili per queste origini. È possibile verificare anche se sono disponibili azioni per recuperare il contenuto di queste origini. Per altre informazioni, vedere Operazioni predefinite e Connettori gestiti.

1. Nel portale Azure, apri la risorsa della tua logic app e il flusso di lavoro nel designer.

2. Nel trigger e nelle azioni esistenti, seguire questa procedura generale per aggiungere l'azione di Operazioni dati denominata Analizzare un documento al flusso di lavoro.

3. Nella finestra di progettazione selezionare l'azione Analizzare un documento.

4. Quando si apre il riquadro delle informazioni dell'azione, nella scheda Parametri, in corrispondenza della proprietà Contenuto del documento specificare il contenuto da analizzare seguendo questa procedura:

   1. Selezionare all'interno della casella Contenuto del documento.

      Vengono visualizzate le opzioni per l'elenco di contenuto dinamico (icona a forma di fulmine) e per l'editor di espressioni (icona della funzione).

      • Per scegliere l'output da un'azione precedente, selezionare l'elenco di contenuto dinamico.

      • Per creare un'espressione che modifichi l'output da un'azione precedente, selezionare l'editor di espressioni.

      Questo esempio continua selezionando l'icona a forma di fulmine per l'elenco di contenuto dinamico.

   2. Quando si apre il riquadro delle informazioni dell'azione, selezionare l'output desiderato da un'operazione precedente.

      In questo esempio, l'azione Analizzare un documento fa riferimento all'output Corpo dell'azione HTTP.

      

      L'output Corpo viene ora visualizzato nella casella Contenuto del documento:

      

5. Nell'azione Analizzare un documento aggiungere le azioni che si desidera usare con l'output di stringa con token, ad esempio Suddividere testo in blocchi, descritto più avanti in questa guida.

Analizzare un documento - Riferimento

Parametri

Output

Suddividere testo in blocchi

L'azione Suddividere testo in blocchi suddivide il contenuto in parti più piccole, in modo da poter essere usato più facilmente nelle azioni successive del flusso di lavoro corrente. I passaggi seguenti si basano sull'esempio della sezione Parse un documento e suddivide l'output della stringa del token da usare con operazioni di intelligenza artificiale Azure che prevedono blocchi di contenuto di piccole dimensioni con token.

1. Nel portale Azure aprire la risorsa e il flusso di lavoro dell'app per la logica nella finestra di progettazione.

2. Nell'azione Analizzare un documento, seguire questa procedura generale per aggiungere l'azione di Operazioni dati denominata Suddividere testo in blocchi.

3. Nella finestra di progettazione selezionare l'azione Suddividere testo in blocchi.

4. Quando si apre il riquadro delle informazioni dell'azione, nella scheda Parametri, in corrispondenza della proprietà Strategia di suddivisione in blocchi, selezionare TokenSize come metodo di suddivisione in blocchi, se non è già selezionato.

   Strategia	Descrizione
   TokenSize	Suddividere il contenuto specificato in base al numero di token.

5. Dopo aver selezionato la strategia, selezionare all'interno della casella Testo per specificare il contenuto per la suddivisione in blocchi.

   Vengono visualizzate le opzioni per l'elenco di contenuto dinamico (icona a forma di fulmine) e per l'editor di espressioni (icona della funzione).

   • Per scegliere l'output da un'azione precedente, selezionare l'elenco di contenuto dinamico.

   • Per creare un'espressione che modifichi l'output da un'azione precedente, selezionare l'editor di espressioni.

   Questo esempio continua selezionando l'icona a forma di fulmine per l'elenco di contenuto dinamico.

   1. Quando si apre il riquadro delle informazioni dell'azione, selezionare l'output desiderato da un'operazione precedente.

      In questo esempio, l'azione Suddividere testo in blocchi fa riferimento all’output Testo del risultato analizzato generato dall'azione Analizzare un documento.

      

      La casella Testo mostra ora l'output dell'azione Risultato analizzato:

      

6. Completare la configurazione dell'azione Suddividere testo in blocchi in base alla strategia e allo scenario selezionati. Per altre informazioni, vedere Suddividere testo in blocchi - Riferimento.

Ora, quando si aggiungono altre azioni che prevedono e usano input con token, ad esempio le azioni di intelligenza artificiale Azure, il contenuto di input viene formattato per un utilizzo più semplice.

Suddividere testo in blocchi - Riferimento

Parametri

Output

Esempio di flusso di lavoro

L'esempio seguente include altre azioni che danno origine a un modello di flusso di lavoro completo per inserire dati da qualsiasi origine:

Contenuti correlati

• Integrate Foundry Tools con flussi di lavoro Standard in App per la logica di Azure
• Suddivisione in blocchi di documenti di grandi dimensioni per la ricerca vettoriale