Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Note
O Pesquisa de IA do Azure está disponível através do portal Azure, APIs REST e SDKs do Azure. Também sustenta o Foundry IQ, a camada de conhecimento gerida que transforma conteúdos empresariais em bases de conhecimento reutilizáveis e conscientes de permissões para agentes no portal Microsoft Foundry.
A competência Extração de Documentos extrai conteúdo de um ficheiro no pipeline de enriquecimento. Por padrão, a extração ou recuperação de conteúdo está integrada no pipeline de enriquecimento. No entanto, usando a habilidade Extração de Documentos, você pode controlar como os parâmetros são definidos e como o conteúdo extraído é nomeado na árvore de enriquecimento.
Para pesquisa vetorial e multimodal, combine Extração de Documentos com a competência División de Texto para implementar uma abordagem configurável de fragmentação de dados. O tutorial Multimodal demonstra este cenário.
Note
Esta competência não está limitada às Ferramentas de Fundição e não tem requisito de chave para as Ferramentas de Fundição.
Esta habilidade extrai texto e imagens. A extração de texto é gratuita. A extração de imagens é faturável pelo Pesquisa de IA do Azure. Em um serviço de pesquisa gratuito, o custo de 20 transações por indexador por dia é absorvido para que você possa concluir inícios rápidos, tutoriais e pequenos projetos sem nenhum custo. Para níveis básicos e superiores, a extração de imagens é faturável.
@odata.type
Microsoft.Skills.Util.DocumentExtractionSkill
Formatos de documento suportados
O DocumentExtractionSkill pode extrair texto dos seguintes formatos de documento:
- CSV (consulte Indexação de blobs CSV)
- EML
- EPUB
- GZ
- HTML
- JSON (consulte Indexação de blobs JSON)
- KML (XML para representações geográficas)
- Markdown
- Formatos do Microsoft Office: DOCX/DOC/DOCM, XLSX/XLS/XLSM, PPTX/PPT/PPTM, MSG (e-mails do Outlook), XML (XML WORD de 2003 e 2006)
- Formatos de documentos abertos: ODT, ODS, ODP
- Arquivos de texto sem formatação (consulte também Indexação de texto sem formatação)
- RTF
- XML
- ZIP
Parâmetros de habilidade
Os parâmetros diferenciam maiúsculas de minúsculas.
| Inputs | Valores permitidos | Description |
|---|---|---|
parsingMode |
defaulttextjson |
Define para default extração de documentos de ficheiros que não sejam texto puro ou JSON. Para ficheiros fonte que contenham marcação, como ficheiros PDF, HTML, RTF e Microsoft Office, use o padrão para extrair texto sem linguagem de marcação ou etiquetas. Se parsingMode não for definido explicitamente, o valor é default.Defina como text se os arquivos de origem forem TXT. Este modo de análise melhora o desempenho em ficheiros de texto simples. Se os ficheiros incluírem marcação, este modo preserva as etiquetas na saída final.Defina para json extrair conteúdo estruturado de ficheiros JSON. |
dataToExtract |
contentAndMetadataallMetadata |
Defina como contentAndMetadata para extrair todos os metadados e conteúdo textual de cada arquivo. Se dataToExtract não for definido explicitamente, o valor é contentAndMetadata.Defina para allMetadata extrair apenas as propriedades dos metadados do tipo de conteúdo, como metadados únicos dos ficheiros PNG. |
configuration |
Ver abaixo. | Um dicionário de parâmetros opcionais que ajustam como a extração do documento é realizada. Consulte a tabela abaixo para obter descrições das propriedades de configuração suportadas. |
| Parâmetro de configuração | Valores permitidos | Description |
|---|---|---|
imageAction |
nonegenerateNormalizedImagesgenerateNormalizedImagePerPage |
Defina para none ignorar imagens ou arquivos de imagem incorporados no conjunto de dados ou se os dados de origem não incluírem arquivos de imagem. Esse valor é o padrão.Para OCR e análise de imagem, defina para generateNormalizedImages ter a habilidade de criar uma matriz de imagens normalizadas como parte da quebra de documentos. Esta ação requer parsingMode que definam e defaultdataToExtract definam como contentAndMetadata. Uma imagem normalizada tem uma saída uniforme que é dimensionada e rodada para promover uma renderização consistente nos resultados de pesquisa visual. A habilidade gera esta informação para cada imagem.Se definires imageAction para generateNormalizedImagePerPage, cada página PDF é renderizada como uma imagem e normalizada em vez de extrair imagens incorporadas. Os tipos de arquivo não PDF são tratados da mesma forma como se generateNormalizedImages estivessem definidos. |
normalizedImageMaxWidth |
Qualquer número inteiro entre 50-10000 | A largura máxima (em pixels) para imagens normalizadas geradas. A predefinição é 2 000. |
normalizedImageMaxHeight |
Qualquer número inteiro entre 50-10000 | A altura máxima (em pixels) para imagens normalizadas geradas. A predefinição é 2 000. |
Note
O padrão de 2000 pixels para a largura e altura máximas das imagens normalizadas é baseado nos tamanhos máximos suportados pela habilidade OCR e pela habilidade de análise de imagem. A habilidade OCR suporta uma largura e altura máximas de 4200 para idiomas diferentes do inglês e 10000 para o inglês. Se você aumentar os limites máximos, o processamento pode falhar em imagens maiores, dependendo da definição do conjunto de habilidades e do idioma dos documentos.
Entradas de habilidades
| Nome de entrada | Description |
|---|---|
file_data |
O arquivo do qual o conteúdo deve ser extraído. |
A entrada "file_data" deve ser um objeto definido como:
{
"$type": "file",
"data": "BASE64 encoded string of the file"
}
Em alternativa, pode ser definido como:
{
"$type": "file",
"url": "URL to download file",
"sasToken": "OPTIONAL: SAS token for authentication if the URL provided is for a file in blob storage"
}
O objeto de referência de arquivo pode ser gerado de três maneiras:
Definir o parâmetro na definição do
allowSkillsetToReadFileDataindexador como "true". Isso cria um caminho/document/file_dataque é um objeto que representa os dados do arquivo original baixados da fonte de dados do blob. Este parâmetro só se aplica a arquivos no armazenamento de Blob.allowSkillsetToReadFileDatatorna os dados do ficheiro descarregados disponíveis para a competência. Não aumenta o tamanho do ficheiro blob indexer nem os limites de conteúdo extraído.Definir o parâmetro na definição do
imageActionindexador para um valor diferente denone. Isso cria uma matriz de imagens que segue a convenção necessária para entrada nessa habilidade se passada individualmente (ou seja,/document/normalized_images/*).Ter uma habilidade personalizada retorna um objeto json definido EXATAMENTE como acima. O
$typeparâmetro deve ser definido exatamentefilee odataparâmetro deve ser os dados da matriz de bytes codificados base 64 do conteúdo do arquivo, ou ourlparâmetro deve ser uma URL formatada corretamente com acesso para baixar o arquivo nesse local.
Resultados em termos de competências
| Nome do resultado | Description |
|---|---|
content |
O conteúdo textual do documento. |
normalized_images |
Quando imageAction é definido para um valor diferente de none, o novo campo de normalized_images contém um array de imagens. Para mais informações sobre o formato de saída, consulte Extrair texto e informação de imagens. |
Definição da amostra
{
"@odata.type": "#Microsoft.Skills.Util.DocumentExtractionSkill",
"parsingMode": "default",
"dataToExtract": "contentAndMetadata",
"configuration": {
"imageAction": "generateNormalizedImages",
"normalizedImageMaxWidth": 2000,
"normalizedImageMaxHeight": 2000
},
"context": "/document",
"inputs": [
{
"name": "file_data",
"source": "/document/file_data"
}
],
"outputs": [
{
"name": "content",
"targetName": "extracted_content"
},
{
"name": "normalized_images",
"targetName": "extracted_normalized_images"
}
]
}
Entrada de exemplo
{
"values": [
{
"recordId": "1",
"data":
{
"file_data": {
"$type": "file",
"data": "aGVsbG8="
}
}
}
]
}
Saída da amostra
{
"values": [
{
"recordId": "1",
"data": {
"content": "hello",
"normalized_images": []
}
}
]
}