Habilidade de percepção do Text Merge

Note

Pesquisa de IA do Azure  está disponível por meio do portal Azure, APIs REST e SDKs do Azure. Ele também sustenta o IQ do Foundry, a camada de conhecimento gerenciado que transforma o conteúdo da empresa em bases de conhecimento reutilizáveis e com reconhecimento de permissão para agentes no portal do Microsoft Foundry.

A habilidade Mesclagem de Texto consolida o texto de uma matriz de cadeias de caracteres em um único campo.

Note

Essa habilidade não está associada às Ferramentas de Fundação. Não é possível e não tem nenhum requisito de chave das Ferramentas de Fundimento.

@odata.type

Microsoft.Skills.Text.MergeSkill

Parâmetros de habilidade

Os parâmetros diferenciam maiúsculas de minúsculas.

Nome do parâmetro Description
insertPreTag Cadeia de caracteres a serem incluídas antes de cada inserção. O valor padrão é " ". Para omitir o espaço, defina o valor como "".
insertPostTag Cadeia de caracteres a ser incluída antes de cada inserção. O valor padrão é " ". Para omitir o espaço, defina o valor como "".

Entradas de competências

Nome do campo de entrada Description
itemsToInsert Matriz de cadeias de caracteres a serem mescladas.
text (opcional) Corpo do texto principal a ser inserido. Se text não for fornecido, os elementos serão itemsToInsert concatenados.
offsets (opcional) Matriz de posições dentro de text onde itemsToInsert devem ser inseridas. Se fornecido, o número de elementos de text deve ser igual ao número de elementos de textToInsert. Caso contrário, todos os itens serão anexados ao final dotext.

Resultados de competências

Nome do resultado Description
mergedText O texto mesclado resultante.
mergedOffsets Matriz de posições dentro demergedText onde os elementos de itemsToInsert foram inseridos

Entrada de exemplo

Um documento JSON fornece entrada utilizável para esta habilidade JSON poderia ser:

{
  "values": [
    {
      "recordId": "1",
      "data":
      {
        "text": "The brown fox jumps over the dog",
        "itemsToInsert": ["quick", "lazy"],
        "offsets": [3, 28]
      }
    }
  ]
}

Saída de exemplo

Este exemplo mostra a saída da entrada anterior, supondo que o insertPreTag seja definido como " ", e insertPostTag seja definido como "".

{
  "values": [
    {
      "recordId": "1",
      "data":
      {
        "mergedText": "The quick brown fox jumps over the lazy dog"
      }
    }
  ]
}

Definição do conjunto de habilidades de exemplo estendido

Um cenário comum para o Text Merge é a capacidade de mesclar a representação textual de imagens (texto de uma habilidade OCR ou a legenda de uma imagem) no campo de conteúdo de um documento.

O conjunto de qualificações do exemplo a seguir usa a habilidade de OCR para extrair o texto de imagens inseridas no documento. Em seguida, cria um campo merged_text que contém texto original e OCRed de cada imagem. Saiba mais sobre a habilidade OCR aqui.

{
  "description": "Extract text from images and merge with content text to produce merged_text",
  "skills":
  [
    {
      "description": "Extract text (plain and structured) from image.",
      "@odata.type": "#Microsoft.Skills.Vision.OcrSkill",
      "context": "/document/normalized_images/*",
      "defaultLanguageCode": "en",
      "detectOrientation": true,
      "inputs": [
        {
          "name": "image",
          "source": "/document/normalized_images/*"
        }
      ],
      "outputs": [
        {
          "name": "text"
        }
      ]
    },
    {
      "@odata.type": "#Microsoft.Skills.Text.MergeSkill",
      "description": "Create merged_text, which includes all the textual representation of each image inserted at the right location in the content field.",
      "context": "/document",
      "insertPreTag": " ",
      "insertPostTag": " ",
      "inputs": [
        {
          "name":"text", 
          "source": "/document/content"
        },
        {
          "name": "itemsToInsert", 
          "source": "/document/normalized_images/*/text"
        },
        {
          "name":"offsets", 
          "source": "/document/normalized_images/*/contentOffset" 
        }
      ],
      "outputs": [
        {
          "name": "mergedText", 
          "targetName" : "merged_text"
        }
      ]
    }
  ]
}

O exemplo acima presume que um campo de imagens normalizado existe. Para gerar esse campo, defina a configuração imageAction na definição do indexador para generateNormalizedImages conforme mostrado abaixo:

{
  //...rest of your indexer definition goes here ...
  "parameters":{
    "configuration":{
        "dataToExtract":"contentAndMetadata",
        "imageAction":"generateNormalizedImages"
    }
  }
}

Consulte também