Ciclo de vida do modelo personalizado da Inteligência de Documentos

Com as APIs v3.1 (GA) e posteriores, os modelos personalizados introduzem uma propriedade expirationDateTime que está definida para cada modelo treinado com a API 3.1 ou posterior. Os modelos personalizados dependem da versão da API de Layout e da versão da API de operação de build do modelo. Para obter melhores resultados, continue a usar a versão da API com a qual o modelo foi treinado em todas as solicitações de análise. As diretrizes se aplicam a todos os modelos personalizados da Inteligência de Documentos, incluindo modelos de extração e classificação.

Modelos treinados com a versão da API GA

Com a API v3.1, os modelos personalizados introduzem uma nova propriedade de expiração de modelo. A expiração do modelo é definida como dois anos a partir da data em que o modelo é criado para todas as solicitações que usam uma API GA para criar um modelo. Para continuar usando o modelo após a data de validade, é necessário treinar o modelo com uma versão atual da API em GA. A versão da API pode ser aquela com a qual o modelo foi originalmente treinado ou uma versão posterior da API. A figura a seguir ilustra as opções disponíveis quando você precisa treinar novamente um modelo prestes a vencer ou vencido.

Modelos treinados com versão prévia da API

Para solicitações de build, usando uma versão prévia da API, a data de validade é definida como três meses a partir da data em que o modelo é criado. Os modelos treinados com uma API de visualização não devem ser usados em produção e devem ser treinados novamente depois que a versão da API GA correspondente estiver disponível. A compatibilidade entre versões prévias da API e versões da API GA nem sempre é mantida. Você deve esperar que os modelos treinados com uma versão prévia da API não sejam utilizáveis depois que a API de visualização for desativada.

As APIs de visualização normalmente são desativadas dentro de três meses após a API de GA correspondente estar disponível.

Exibindo a data de validade do modelo

A API do modelo GET retorna os detalhes do modelo, incluindo a propriedade expirationDateTime.

GET /documentModels/{customModelId}?api-version={apiVersion}
{
  "modelId": "{customModelId}",
  "description": "{customModelDescription}",
  "createdDateTime": "2021-09-24T12:54:35Z",
  "expirationDateTime": "2023-01-01T00:00:00Z",
  "apiVersion": "2023-07-31",
  "docTypes": { ... }
}

Readaptar um modelo

Para treinar novamente um modelo com uma versão mais recente da API, verifique se os resultados do layout dos documentos em seu conjunto de dados de treinamento correspondem à versão da API da solicitação do modelo de build. Por exemplo, se você planeja criar o modelo com a versão v3.1:2023-07-31 da API, os arquivos *.ocr.json correspondentes em seu conjunto de dados de treinamento também deverão ser gerados com a versão v3.1:2023-07-31 da API. Os arquivos ocr.json são gerados executando o layout em seu conjunto de dados de treinamento. Para validar a versão dos resultados do layout, verifique a propriedade apiVersion nos analyzeResult dos documentos ocr.json.

Próximas etapas

Saiba como criar e compor modelos personalizados: