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.
Este conteúdo aplica-se a:
v4.0 (GA) | Versões anteriores:
v3.1 (GA)
v3.0 (em retirada)
v2.1 (em retirada)
::: fim do moniker
Este conteúdo aplica-se a:
v3.0 (em descontinuação) | Últimas versões:
v4.0 (GA)
v3.1 | Versão anterior:
v2.1 (em descontinuação)
Este conteúdo aplica-se a:
v2.1 | Última versão:
v4.0 (GA)
Importante
A operação v4.0 2024-11-30 (GA) model compose adiciona um classificador explicitamente treinado em vez de um classificador implícito para análise. Para a versão anterior do modelo Composto, veja os modelos personalizados compostos v3.1. Se está atualmente a usar modelos compostos, considere atualizar para a implementação mais recente.
O que é um modelo composto?
Com modelos compostos, podes agrupar vários modelos personalizados num modelo composto chamado com um único ID de modelo. Por exemplo, o seu modelo escrito pode incluir modelos personalizados treinados para analisar as suas encomendas de fornecimento, equipamentos e mobiliário. Em vez de tentar selecionar manualmente o modelo apropriado, pode usar um modelo composto para determinar o modelo personalizado adequado para cada análise e extração.
Alguns cenários exigem classificar primeiro o documento e depois analisá-lo com o modelo mais adequado para extrair os campos do modelo. Tais cenários podem incluir aqueles em que um utilizador carrega um documento mas o tipo de documento não é explicitamente conhecido. Outro cenário pode ser quando vários documentos são digitalizados em conjunto num único ficheiro e o ficheiro é submetido para processamento. A sua aplicação precisa então de identificar os documentos componentes e selecionar o melhor modelo para cada documento.
Em versões anteriores, a model compose operação realizava uma classificação implícita para decidir qual o modelo personalizado que melhor representa o documento submetido. A implementação da operação em 2024-11-30 (GA) substitui a classificação implícita das versões anteriores por uma etapa explícita de classificação e adiciona um encaminhamento condicional.
Benefícios da nova operação de composição do modelo
A nova model compose operação exige que treines um classificador explícito e oferece vários benefícios.
Melhoria incremental contínua. Pode melhorar consistentemente a qualidade do classificador adicionando mais amostras e melhorando gradualmente a classificação. Este ajuste fino garante que os seus documentos são sempre encaminhados para o modelo correto para extração.
Controlo total sobre o encaminhamento. Ao adicionar o encaminhamento baseado na confiança, define um limiar de confiança para o tipo de documento e para a resposta de classificação.
Ignore os tipos de documentos específicos durante a operação. Implementações anteriores da
model composeoperação selecionaram o melhor modelo de análise para extração com base na pontuação de confiança, mesmo que as pontuações de confiança mais altas fossem relativamente baixas. Ao fornecer um limiar de confiança ou ao não mapear explicitamente um tipo de documento conhecido da classificação para um modelo de extração, pode ignorar tipos específicos de documentos.Analise múltiplas instâncias do mesmo tipo de documento. Quando combinado com a
splitModeopção do classificador, amodel composeoperação pode detetar múltiplas instâncias do mesmo documento num ficheiro e dividir o ficheiro para processar cada documento de forma independente. UsingsplitModepermite o processamento de múltiplas instâncias de um documento num único pedido.Suporte para funcionalidades adicionais. Funcionalidades adicionais como campos de consulta ou códigos de barras também podem ser especificadas como parte dos parâmetros do modelo de análise.
O máximo atribuído ao modelo personalizado aumentou para 500. A nova implementação da
model composeoperação permite-lhe atribuir até 500 modelos personalizados treinados a um único modelo composto.
Como usar o Model Compose
Comece por recolher amostras de todos os documentos necessários, incluindo amostras com informações que devem ser extraídas ou ignoradas.
Treine um classificador organizando os documentos em pastas onde os nomes das pastas sejam o tipo de documento que pretende usar na definição do seu modelo composto.
Por fim, treine um modelo de extração para cada um dos tipos de documentos que pretende usar.
Depois de treinados os seus modelos de classificação e extração, utilize o Document Intelligence Studio, bibliotecas de clientes ou a API REST para compor os modelos de classificação e extração num modelo composto.
Use o splitMode parâmetro para controlar o comportamento de divisão de ficheiros:
- Nenhum. O ficheiro inteiro é tratado como um único documento.
- por Página. Cada página do ficheiro é tratada como um documento separado.
- auto. O ficheiro é automaticamente dividido em documentos.
Faturação e preços
Os modelos compostos são apresentados da mesma forma que os modelos personalizados individuais. O preço baseia-se no número de páginas analisadas pelo modelo de análise a jusante. A faturação baseia-se no preço de extração das páginas encaminhadas para um modelo de extração. Com a adição da classificação explícita, são incorridas taxas pela classificação de todas as páginas do ficheiro de entrada. Para mais informações, consulte a página de preços da Inteligência Documental.
Utilize a operação de composição do modelo
Começa por criar uma lista de todos os IDs de modelo que queres compor num único modelo.
Compõe os modelos num único ID de modelo usando o Studio, a API REST ou bibliotecas de clientes.
Utilize a ID do modelo composto para analisar documentos.
Faturamento
Os modelos compostos são apresentados da mesma forma que os modelos personalizados individuais. O preço baseia-se no número de páginas analisadas. A faturação baseia-se no custo de extração das páginas encaminhadas para um modelo de extração. Para mais informações, consulte a página de preços da Inteligência Documental.
- Não há alteração nos preços ao analisar um documento usando um modelo personalizado individual ou um modelo personalizado composto.
Características dos modelos compostos
Custom templateecustom neuralos modelos podem ser compostos em conjunto num único modelo composto através de múltiplas versões da API.A resposta inclui uma
docTypepropriedade para indicar qual dos modelos compostos foi usado para analisar o documento.Para
custom templatemodelos, o modelo composto pode ser criado usando variações de um modelo personalizado ou diferentes tipos de formulários. Esta operação é útil quando os formulários recebidos pertencem a um de vários modelos.Para modelos
custom neural, a melhor prática é adicionar todas as diferentes variações de um único tipo de documento num único conjunto de dados de treino e treinar num modelo neural personalizado. Amodel composeoperação é mais adequada para cenários em que tem documentos de diferentes tipos a ser submetidos para análise.
Compor limites do modelo
Com esta
model composeoperação, pode atribuir até 500 modelos a um único ID de modelo. Se o número de modelos que quero compor ultrapassar o limite superior de um modelo composto, pode usar uma destas alternativas:Classifica os documentos antes de chamar o modelo personalizado. Pode usar o modelo Read e construir uma classificação baseada no texto extraído dos documentos e de certas frases, usando fontes como código, expressões regulares ou pesquisa.
Se quiser extrair os mesmos campos de vários documentos estruturados, semi-estruturados e não estruturados, considere usar o modelo neural personalizado de aprendizagem profunda. Saiba mais sobre as diferenças entre o modelo de template personalizado e o modelo neural personalizado.
Analisar um documento usando modelos compostos é idêntico a analisar um documento usando um único modelo. O
Analyze Documentresultado devolve umadocTypepropriedade que indica qual dos modelos componentes selecionou para analisar o documento.Atualmente, a
model composeoperação está disponível apenas para modelos personalizados treinados com etiquetas.
Compatibilidade de modelos compostos
| Modelo personalizado | Modelos treinados com v2.1 e v2.0 | Modelos personalizados e modelos neurais v3.1 e v3.0 | Modelos personalizáveis e modelos neurais v4.0 2024-11-30 (GA) |
|---|---|---|---|
| Modelos treinados com as versões 2.1 e v2.0 | Não Suportado | Não Suportado | Não Suportado |
| Modelos personalizados e modelos neurais v3.0 e v3.1 | Não Suportado | Apoiado | Apoiado |
| Modelos personalizados e modelos neurais v4.0 | Não Suportado | Apoiado | Apoiado |
Para compor um modelo treinado com uma versão anterior da API (v2.1 ou anterior), treine um modelo com a API v3.0 usando o mesmo conjunto de dados rotulado. Essa adição garante que o modelo v2.1 pode ser composto com outros modelos.
Com modelos compostos usando a versão 2.1 da API, continua a ser suportado, sem necessidade de atualizações.
Opções de desenvolvimento
O Document Intelligence v4.0:2024-11-30 (GA) suporta as seguintes ferramentas, aplicações e bibliotecas:
| Destaque | Recursos |
|---|---|
| Modelo personalizado | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
| Modelo composto | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
Document Intelligence v3.1:2023-07-31 (GA) suporta as seguintes ferramentas, aplicações e bibliotecas:
| Destaque | Recursos |
|---|---|
| Modelo personalizado | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
| Modelo composto | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
Document Intelligence v3.0:2022-08-31 (GA) suporta as seguintes ferramentas, aplicações e bibliotecas:
| Destaque | Recursos |
|---|---|
| Modelo personalizado | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
| Modelo composto | • Document Intelligence Studio • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
O Document Intelligence v2.1 suporta os seguintes recursos:
| Destaque | Recursos |
|---|---|
| Modelo personalizado | • Ferramenta de rotulagem |
| Modelo composto | • Ferramenta de rotulagem de Document Intelligence • REST API • C# SDK • Java SDK • JavaScript SDK • Python SDK |
Próximos passos
Aprenda a criar e compor modelos personalizados: