Analisar documentos e pedaços de texto para ações de IA em fluxos de trabalho para aplicações Azure Logic

Aplica-se a: Azure Logic Apps (Consumption + Standard)

Às vezes, você tem que converter o conteúdo em tokens, que são palavras ou pedaços de caracteres, ou dividir um documento grande em partes menores antes de poder usar esse conteúdo com algumas ações. Por exemplo, as ações Azure AI Search ou Azure OpenAI esperam entrada tokenizada e podem lidar com apenas um número limitado de tokens.

Para esses cenários, use as ações de Operações de Dados denominadas Analisar um documento e Fragmentar texto no fluxo de trabalho do aplicativo lógico. Essas ações, respectivamente, transformam conteúdo, como um documento PDF, arquivo CSV, arquivo Excel e assim por diante, em saída de cadeia de caracteres tokenizada e, em seguida, dividem a cadeia de caracteres em partes, com base no número de tokens. Em seguida, pode referenciar e utilizar esses resultados com ações seguintes no seu fluxo de trabalho.

Este guia mostra como adicionar e configurar ações para analisar documentos e fragmentar texto no seu fluxo de trabalho.

Problemas e limitações conhecidos

Atualmente, as ações Analisar um documento e Fragmentar texto não suportam arquivos host, por exemplo, arquivos binários de mainframe e midrange, como arquivos VSAM (Virtual Storage Access Method). No entanto, se estiver trabalhando com fluxos de trabalho Padrão, é possível usar a ação interna do IBM Host File chamada Parse Host File Contents em vez disso.

Pré-requisitos

• Uma conta e subscrição do Azure. Se não tiver uma subscrição do Azure, inscreva-se para obter uma conta do Azure gratuita.

• Um fluxo de trabalho de aplicativo lógico Consumo ou Padrão com um gatilho existente porque as operações Analisar um documento e Fragmentar texto estão disponíveis apenas como ações. Certifique-se de que a ação que recupera o conteúdo que você deseja analisar ou fragmentar precede essas operações de dados.

Analisar um documento

A ação Analisar um documento converte conteúdo, como um documento PDF, arquivo CSV, arquivo Excel e assim por diante, em uma cadeia de caracteres tokenizada. Neste exemplo, imagine que o seu fluxo de trabalho se inicia com o gatilho Pedido chamado Quando é recebido um pedido HTTP. Esse gatilho aguarda para receber uma solicitação HTTP enviada de outro componente, como uma função do Azure, outro fluxo de trabalho de aplicativo lógico e assim por diante. A solicitação HTTP inclui a URL de um novo documento carregado que está disponível para o fluxo de trabalho recuperar e analisar. Uma ação HTTP segue imediatamente o gatilho e envia uma solicitação HTTP para a URL do documento e retorna com o conteúdo do documento de seu local de armazenamento.

Se você usar outras fontes de conteúdo, como Armazenamento de Blob do Azure, SharePoint, OneDrive, Sistema de Arquivos, FTP e assim por diante, poderá verificar se os gatilhos estão disponíveis para essas fontes. Você também pode verificar se há ações disponíveis para recuperar o conteúdo dessas fontes. Para obter mais informações, consulte Operações internas e conectores gerenciados.

1. No portal Azure, abra o recurso e o fluxo de trabalho da aplicação lógica no editor.

2. Sob o gatilho e as ações existentes, siga estas etapas gerais para adicionar a ação de Operações de Dados chamada Analisar um documento ao seu fluxo de trabalho.

3. No designer, selecione a ação Analisar um documento .

4. Após abrir o painel de informações da ação, na guia Parâmetros, na propriedade Conteúdo do Documento, especifique o conteúdo a analisar seguindo estas etapas:

   1. Selecione dentro da caixa de conteúdo do documento.

      As opções para a lista de conteúdo dinâmico (ícone relâmpago) e o editor de expressões (ícone de função) são exibidas.

      • Para escolher a saída de uma ação anterior, selecione a lista de conteúdo dinâmico.

      • Para criar uma expressão que manipule a saída de uma ação anterior, selecione o editor de expressão.

      Este exemplo continua selecionando o ícone de relâmpago para a lista de conteúdo dinâmico.

   2. Depois que a lista de conteúdo dinâmico for aberta, selecione a saída desejada de uma operação anterior.

      Neste exemplo, a ação Analisar um documento faz referência à saída Corpo da ação HTTP.

      

      A saída do Corpo agora aparece na caixa de Conteúdo do Documento:

      

5. Na ação Analisar um documento, adicione as ações que você deseja trabalhar com a saída de cadeia de caracteres tokenizada, por exemplo, Texto em bloco, que este guia descreve mais tarde.

Analisar um documento - Referência

Parâmetros

Resultados

Fragmentar texto

A ação Fragmentar texto divide o conteúdo em partes menores para ações subsequentes para uso mais fácil no fluxo de trabalho atual. As etapas a seguir se baseiam no exemplo da seção Analisar um documento e dividem a saída da cadeia de caracteres de token para uso com operações de IA do Azure que esperam pequenos blocos de conteúdo tokenizados.

1. No portal Azure, abra o recurso e o fluxo de trabalho da aplicação lógica no editor.

2. Na ação Analisar um documento, siga estas etapas gerais para adicionar a ação Operações de Dados chamada Fragmentar texto.

3. No designer, selecione a ação Fragmentar texto .

4. Depois do painel de informações da ação abrir, na guia Parâmetros, para a propriedade Estratégia de Fragmentação, selecione TokenSize como método de fragmentação, se não estiver já selecionado.

   Estratégia	Descrição
   TokenSize	Divida o conteúdo especificado, com base no número de tokens.

5. Depois de selecionar a estratégia, selecione dentro da caixa Texto para especificar o conteúdo para fragmentação.

   As opções para a lista de conteúdo dinâmico (ícone relâmpago) e o editor de expressões (ícone de função) são exibidas.

   • Para escolher a saída de uma ação anterior, selecione a lista de conteúdo dinâmico.

   • Para criar uma expressão que manipule a saída de uma ação anterior, selecione o editor de expressão.

   Este exemplo continua selecionando o ícone de relâmpago para a lista de conteúdo dinâmico.

   1. Depois que a lista de conteúdo dinâmico for aberta, selecione a saída desejada de uma operação anterior.

      Neste exemplo, a ação Dividir texto em partes refere-se à saída do texto analisado da ação Analisar um documento.

      

      A caixa de texto agora mostra a saída da ação de resultado analisado:

      

6. Conclua a configuração da ação Fragmentar texto com base na estratégia selecionada e no cenário. Para obter mais informações, consulte Texto em bloco - Referência.

Agora, quando você adiciona outras ações que esperam e usam entrada tokenizada, como as ações de IA do Azure, o conteúdo de entrada é formatado para facilitar o consumo.

Fragmentar texto - Referência

Parâmetros

Resultados

Exemplo de fluxo de trabalho

O exemplo a seguir inclui outras ações que criam um padrão de fluxo de trabalho completo para ingerir dados de qualquer fonte:

Conteúdos relacionados

• Integre as Ferramentas Foundry com fluxos de trabalho padrão nas aplicações Azure Logic
• Fragmentação de documentos grandes para pesquisa vetorial