Document Classifiers - Build Classifier

Služba:

Azure AI Services

Verze rozhraní API:

2024-11-30

Vytvoří vlastní klasifikátor dokumentů.

POST {endpoint}/documentintelligence/documentClassifiers:build?api-version=2024-11-30

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string uri	Koncový bod služby Document Intelligence
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
classifierId	True	string	Jedinečný název klasifikátoru dokumentu
docTypes	True	<string,  ClassifierDocumentTypeDetails>	Seznam typů dokumentů, které se mají klasifikovat
allowOverwrite		boolean	Povolte přepsání existujícího klasifikátoru se stejným názvem.
baseClassifierId		string	Základní klasifikátorId nad kterým chcete vytrénovat klasifikátor.
description		string	Popis klasifikátoru dokumentu

Odpovědi

Name	Typ	Description
202 Accepted		Žádost byla přijata ke zpracování, ale zpracování ještě nebylo dokončeno. Hlavičky Operation-Location: string Retry-After: integer
Other Status Codes	DocumentIntelligenceErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

Ocp-Apim-Subscription-Key

Typ: apiKey
V: header

OAuth2Auth

Typ: oauth2
Tok: accessCode
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize
URL tokenu: https://login.microsoftonline.com/common/oauth2/token

Rozsahy

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

Příklady

Build Document Classifier

Ukázkový požadavek

HTTP

POST https://myendpoint.cognitiveservices.azure.com/documentintelligence/documentClassifiers:build?api-version=2024-11-30

{
  "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"
      }
    }
  }
}

Ukázková odpověď

Stavový kód:

202

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

Definice

Name	Description
AzureBlobContentSource	Obsah služby Azure Blob Storage
AzureBlobFileListContentSource	Seznam souborů ve službě Azure Blob Storage
BuildDocumentClassifierRequest	Text požadavku pro sestavení nového vlastního klasifikátoru dokumentů
ClassifierDocumentTypeDetails	Informace o typu dokumentu klasifikátoru
ContentSourceKind	Typ zdroje obsahu
DocumentIntelligenceError	Objekt chyby.
DocumentIntelligenceErrorResponse	Objekt odpovědi na chybu
DocumentIntelligenceInnerError	Objekt obsahující konkrétnější informace o chybě.

AzureBlobContentSource

Obsah služby Azure Blob Storage

Name	Typ	Description
containerUrl	string	Adresa URL kontejneru služby Azure Blob Storage
prefix	string	Předpona názvu objektu blob

AzureBlobFileListContentSource

Seznam souborů ve službě Azure Blob Storage

Name	Typ	Description
containerUrl	string	Adresa URL kontejneru služby Azure Blob Storage
fileList	string	Cesta k souboru JSONL v kontejneru určujícím podmnožinu dokumentů

BuildDocumentClassifierRequest

Text požadavku pro sestavení nového vlastního klasifikátoru dokumentů

Name	Typ	Default value	Description
allowOverwrite	boolean	False	Povolte přepsání existujícího klasifikátoru se stejným názvem.
baseClassifierId	string		Základní klasifikátorId nad kterým chcete vytrénovat klasifikátor.
classifierId	string		Jedinečný název klasifikátoru dokumentu
description	string		Popis klasifikátoru dokumentu
docTypes	<string,  ClassifierDocumentTypeDetails>		Seznam typů dokumentů, které se mají klasifikovat

ClassifierDocumentTypeDetails

Informace o typu dokumentu klasifikátoru

Name	Typ	Description
azureBlobFileListSource	AzureBlobFileListContentSource	Seznam souborů Azure Blob Storage určující trénovací data pro typ dokumentu klasifikátoru Je nutné zadat azureBlobSource nebo azureBlobFileListSource.
azureBlobSource	AzureBlobContentSource	Umístění služby Azure Blob Storage obsahující trénovací data pro typ dokumentu klasifikátoru Je nutné zadat azureBlobSource nebo azureBlobFileListSource.
sourceKind	ContentSourceKind	Typ trénovacího zdroje dat

ContentSourceKind

Typ zdroje obsahu

Name	Typ	Description
azureBlob	string	Soubory v cestě v kontejneru Azure Blob Storage
azureBlobFileList	string	Seznam souborů určující jednotlivé soubory v kontejneru Azure Blob Storage.
base64	string	Obsah reprezentovaný kódováním Base64
url	string	Obsah na konkrétní adrese URL

DocumentIntelligenceError

Objekt chyby.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
details	DocumentIntelligenceError[]	Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
innererror	DocumentIntelligenceInnerError	Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message	string	Čitelné znázornění chyby člověkem.
target	string	Cíl chyby.

DocumentIntelligenceErrorResponse

Objekt odpovědi na chybu

Name	Typ	Description
error	DocumentIntelligenceError	Informace o chybě

DocumentIntelligenceInnerError

Objekt obsahující konkrétnější informace o chybě.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
innererror	DocumentIntelligenceInnerError	Vnitřní chyba.
message	string	Čitelné znázornění chyby člověkem.