Document Classifiers - Build Classifier

Service:

Azure AI Services

API Version:

2024-02-29-preview

Crea un clasificador de documentos personalizado.

POST {endpoint}/documentintelligence/documentClassifiers:build?api-version=2024-02-29-preview

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
endpoint	path	True	string	Punto de conexión del servicio Document Intelligence.
api-version	query	True	string	Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
classifierId	True	string	Nombre único del clasificador de documentos.
docTypes	True	<string,  ClassifierDocumentTypeDetails>	Lista de tipos de documento en los que se va a clasificar.
baseClassifierId		string	ClassifierId base en la parte superior de la que se va a entrenar el clasificador.
description		string	Descripción del clasificador de documentos.

Respuestas

Nombre	Tipo	Description
202 Accepted		La solicitud se ha aceptado para su procesamiento, pero el procesamiento aún no se ha completado. Headers Operation-Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Respuesta de error inesperada.

Seguridad

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

OAuth2Auth

Type: oauth2
Flow: accessCode
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize
Token URL: https://login.microsoftonline.com/common/oauth2/token

Scopes

Nombre	Description
https://cognitiveservices.azure.com/.default

Ejemplos

Build Document Classifier

Sample Request

HTTP

POST https://myendpoint.cognitiveservices.azure.com/documentintelligence/documentClassifiers:build?api-version=2024-02-29-preview

{
  "classifierId": "myClassifier",
  "description": "Classifier description",
  "docTypes": {
    "formA": {
      "azureBlobSource": {
        "containerUrl": "https://myStorageAccount.blob.core.windows.net/myContainer?mySasToken",
        "prefix": "formADocs/"
      }
    },
    "formB": {
      "azureBlobFileListSource": {
        "containerUrl": "https://myStorageAccount.blob.core.windows.net/myContainer?mySasToken",
        "fileList": "formB.jsonl"
      }
    }
  }
}

Sample Response

Status code:

202

Operation-Location: https://myendpoint.cognitiveservices.azure.com/documentintelligence/operations/b704bb00-d130-4f3f-a1d8-ca96de3eabb4?api-version=2024-02-29-preview

Definiciones

Nombre	Description
AzureBlobContentSource	Azure Blob Storage contenido.
AzureBlobFileListContentSource	Lista de archivos en Azure Blob Storage.
BuildDocumentClassifierRequest	Cuerpo de la solicitud para crear un nuevo clasificador de documentos personalizado.
ClassifierDocumentTypeDetails	Información del tipo de documento clasificador.
ContentSourceKind	Tipo de origen de contenido.
Error	Objeto de error.
ErrorResponse	Objeto de respuesta de error.
InnerError	Objeto que contiene información más específica sobre el error.

AzureBlobContentSource

Azure Blob Storage contenido.

Nombre	Tipo	Description
containerUrl	string	Azure Blob Storage dirección URL del contenedor.
prefix	string	Prefijo de nombre de blob.

AzureBlobFileListContentSource

Lista de archivos en Azure Blob Storage.

Nombre	Tipo	Description
containerUrl	string	Azure Blob Storage dirección URL del contenedor.
fileList	string	Ruta de acceso a un archivo JSONL dentro del contenedor que especifica un subconjunto de documentos.

BuildDocumentClassifierRequest

Cuerpo de la solicitud para crear un nuevo clasificador de documentos personalizado.

Nombre	Tipo	Description
baseClassifierId	string	ClassifierId base en la parte superior de la que se va a entrenar el clasificador.
classifierId	string	Nombre único del clasificador de documentos.
description	string	Descripción del clasificador de documentos.
docTypes	<string,  ClassifierDocumentTypeDetails>	Lista de tipos de documento en los que se va a clasificar.

ClassifierDocumentTypeDetails

Información del tipo de documento clasificador.

Nombre	Tipo	Description
azureBlobFileListSource	AzureBlobFileListContentSource	Azure Blob Storage lista de archivos que especifica los datos de entrenamiento para un tipo de documento clasificador. Debe especificarse azureBlobSource o azureBlobFileListSource.
azureBlobSource	AzureBlobContentSource	Azure Blob Storage ubicación que contiene los datos de entrenamiento de un tipo de documento clasificador. Debe especificarse azureBlobSource o azureBlobFileListSource.
sourceKind	ContentSourceKind	Tipo de origen de datos de entrenamiento.

ContentSourceKind

Tipo de origen de contenido.

Nombre	Tipo	Description
azureBlob	string	Archivos en una ruta de acceso dentro de un contenedor de Azure Blob Storage.
azureBlobFileList	string	Lista de archivos que especifica archivos individuales en un contenedor de Azure Blob Storage.
base64	string	Contenido representado a través de la codificación Base64.
url	string	Contenido en una dirección URL específica.

Error

Objeto de error.

Nombre	Tipo	Description
code	string	Uno de los conjuntos de códigos de error definidos por el servidor.
details	Error[]	Matriz de detalles sobre errores específicos que llevaron a este error notificado.
innererror	InnerError	Objeto que contiene información más específica que el objeto actual sobre el error.
message	string	Representación legible del error.
target	string	Destino del error.

ErrorResponse

Objeto de respuesta de error.

Nombre	Tipo	Description
error	Error	Información de error.

InnerError

Objeto que contiene información más específica sobre el error.

Nombre	Tipo	Description
code	string	Uno de los conjuntos de códigos de error definidos por el servidor.
innererror	InnerError	Error interno.
message	string	Representación legible del error.