Miscellaneous Operations - Get Document Model Build Operation

Reference

Služba:: Azure AI Services

Verze rozhraní API:: 2024-11-30

Získá informace o operaci.

GET {endpoint}/documentintelligence/operations/{operationId}?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
operationId	path	True	string	ID operace
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-client-request-id		string uuid	Neprůzrný globálně jedinečný identifikátor řetězce vygenerovaný klientem pro požadavek.

Odpovědi

Name	Typ	Description
200 OK	DocumentModelBuildOperationDetails	Požadavek byl úspěšný. Hlavičky x-ms-client-request-id: string
Other Status Codes	DocumentIntelligenceErrorResponse	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

DocumentModelBuildOperationDetails

Požadavek byl úspěšný.

Hlavičky

x-ms-client-request-id: string

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

Get Operation - Document Model Build

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 200

{
  "operationId": "b704bb00-d130-4f3f-a1d8-ca96de3eabb4",
  "status": "succeeded",
  "percentCompleted": 100,
  "createdDateTime": "2021-09-23T09:12:57Z",
  "lastUpdatedDateTime": "2021-09-23T09:13:01Z",
  "kind": "documentModelBuild",
  "resourceLocation": "https://myendpoint.cognitiveservices.azure.com/documentintelligence/documentModels/myCustomModel",
  "result": {
    "modelId": "myCustomModel",
    "description": "Custom model description",
    "createdDateTime": "2021-09-23T09:13:01Z",
    "apiVersion": "2024-11-30"
  }
}

Definice

Name	Description
AzureBlobContentSource	Obsah služby Azure Blob Storage
AzureBlobFileListContentSource	Seznam souborů ve službě Azure Blob Storage
DocumentAnalysisFeature	Funkce analýzy dokumentů, které chcete povolit.
DocumentBuildMode	Režim sestavení vlastního modelu dokumentu
DocumentFieldSchema	Popis sémantického schématu pole pomocí syntaxe stylu schématu JSON
DocumentFieldType	Sémantický datový typ hodnoty pole
DocumentIntelligenceError	Objekt chyby.
DocumentIntelligenceErrorResponse	Objekt odpovědi na chybu
DocumentIntelligenceInnerError	Objekt obsahující konkrétnější informace o chybě.
DocumentIntelligenceOperationStatus	Stav operace.
DocumentIntelligenceWarning	Objekt chyby.
DocumentModelBuildOperationDetails	Získání objektu odpovědi operace
DocumentModelDetails	Informace o modelu dokumentu
DocumentTypeDetails	Informace o typu dokumentu
OperationKind	Typ operace.
SplitMode	Chování rozdělení souboru

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ů

DocumentAnalysisFeature

Funkce analýzy dokumentů, které chcete povolit.

Name	Typ	Description
barcodes	string	Povolte detekci čárových kódů v dokumentu.
formulas	string	Povolte detekci matematických výrazů v dokumentu.
keyValuePairs	string	Povolte detekci obecných párů klíč-hodnota (pole formulářů) v dokumentu.
languages	string	Povolte detekci jazyka textového obsahu.
ocrHighResolution	string	Pokud chcete zpracovávat dokumenty s jemným tiskem, proveďte OCR s vyšším rozlišením.
queryFields	string	Povolte extrakci dalších polí pomocí parametru dotazu queryFields.
styleFont	string	Povolte rozpoznávání různých stylů písem.

DocumentBuildMode

Režim sestavení vlastního modelu dokumentu

Name	Typ	Description
neural	string	Podpora dokumentů s různými vizuálními šablonami
template	string	Cílové dokumenty s podobnými šablonami vizuálů

DocumentFieldSchema

Popis sémantického schématu pole pomocí syntaxe stylu schématu JSON

Name	Typ	Description
description	string	Popis pole
example	string	Příklad obsahu pole
items	DocumentFieldSchema	Schéma typu pole každého prvku pole
properties	<string, DocumentFieldSchema>	Pojmenovaná dílčí pole pole objektu
type	DocumentFieldType	Sémantický datový typ hodnoty pole

DocumentFieldType

Sémantický datový typ hodnoty pole

Name	Typ	Description
address	string	Parsovaná adresa.
array	string	Seznam dílčích polí stejného typu
boolean	string	Logická hodnota, normalizovaná na hodnotu true nebo false.
countryRegion	string	Země/oblast, normalizovaná na formát ISO 3166-1 alfa-3 (např. USA).
currency	string	Částka měny s volitelným symbolem měny a jednotkou
date	string	Datum, normalizované ve formátu ISO 8601 (RRRR-MM-DD)
integer	string	Celočíselné číslo, normalizované na 64bitové celé číslo se signedem.
number	string	Číslo s plovoucí desetinnou čárkou, normalizované na dvojitou přesnost s plovoucí desetinnou čárkou.
object	string	Pojmenovaný seznam dílčích polí potenciálně různých typů
phoneNumber	string	Telefonní číslo, normalizované na formát E.164 (+{CountryCode}{SubscriberNumber}).
selectionGroup	string	Pole vybraných řetězcových hodnot
selectionMark	string	Je pole vybrané?
signature	string	Existuje podpis?
string	string	Prostý text.
time	string	Čas normalizovaný do formátu ISO 8601 (hh:mm:ss).

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.

DocumentIntelligenceOperationStatus

Stav operace.

Name	Typ	Description
canceled	string	Operace byla zrušena.
failed	string	Operace se nezdařila.
notStarted	string	Operace ještě nebyla spuštěna.
running	string	Operace probíhá.
skipped	string	Operace byla vynechána.
succeeded	string	Operace byla úspěšná.

DocumentIntelligenceWarning

Objekt chyby.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů upozornění.
message	string	Čitelné znázornění varování člověkem.
target	string	Cíl chyby.

DocumentModelBuildOperationDetails

Získání objektu odpovědi operace

Name	Typ	Description
apiVersion	string	Verze rozhraní API používaná k vytvoření této operace.
createdDateTime	string	Datum a čas (UTC) při vytvoření operace
error	DocumentIntelligenceError	Došlo k chybě.
kind	string: documentModelBuild	Typ operace.
lastUpdatedDateTime	string	Datum a čas (UTC) při poslední aktualizaci stavu
operationId	string	ID operace
percentCompleted	integer	Průběh operace (0–100).
resourceLocation	string	Adresa URL prostředku, na který tato operace cílí.
result	DocumentModelDetails	Výsledek operace při úspěchu.
status	DocumentIntelligenceOperationStatus	Stav operace. notStarted, running, completed, or failed
tags	object	Seznam atributů značky klíč-hodnota přidružených k modelu dokumentu

DocumentModelDetails

Informace o modelu dokumentu

Name	Typ	Default value	Description
apiVersion	string		Verze rozhraní API používaná k vytvoření tohoto modelu dokumentu.
azureBlobFileListSource	AzureBlobFileListContentSource		Seznam souborů Azure Blob Storage určující trénovací data Je nutné zadat azureBlobSource nebo azureBlobFileListSource.
azureBlobSource	AzureBlobContentSource		Umístění služby Azure Blob Storage obsahující trénovací data Je nutné zadat azureBlobSource nebo azureBlobFileListSource.
buildMode	DocumentBuildMode		Režim sestavení vlastního modelu dokumentu
classifierId	string		U složených modelů se vlastní klasifikátor rozděluje a klasifikuje vstupní soubor.
createdDateTime	string		Datum a čas (UTC) při vytvoření modelu dokumentu
description	string		Popis modelu dokumentu
docTypes	<string, DocumentTypeDetails>		Podporované typy dokumentů
expirationDateTime	string		Datum a čas (UTC), kdy vyprší platnost modelu dokumentu.
modelId	string		Jedinečný název modelu dokumentu
modifiedDateTime	string		Datum a čas (UTC) při poslední změně modelu dokumentu
split	SplitMode	none	U složených modelů chování rozdělení souboru.
tags	object		Seznam atributů značky klíč-hodnota přidružených k modelu dokumentu
trainingHours	number		Počet hodin GPU ekvivalentních v100 spotřebovaných pro trénování modelu
warnings	DocumentIntelligenceWarning[]		Seznam upozornění, ke kterým došlo při sestavování modelu

DocumentTypeDetails

Informace o typu dokumentu

Name	Typ	Description
buildMode	DocumentBuildMode	Režim sestavení vlastního modelu dokumentu
confidenceThreshold	number	Analýzu proveďte pouze v případě, že spolehlivost docType překračuje prahovou hodnotu.
description	string	Popis modelu dokumentu
features	DocumentAnalysisFeature[]	Seznam volitelných analytických funkcí
fieldConfidence	object	Odhadovaná spolehlivost pro každé pole
fieldSchema	<string, DocumentFieldSchema>	Popis sémantického schématu dokumentu pomocí syntaxe stylu schématu JSON
maxDocumentsToAnalyze	integer	Maximální početdokumentůchch Default=all.
modelId	string	Model dokumentů, který se má použít k analýze dokumentů se zadaným typem
queryFields	string[]	Seznam dalších polí k extrakci Ex. "NumberOfGuests,StoreNumber"

OperationKind

Typ operace.

Name	Typ	Description
documentClassifierBuild	string	Vytvořte nový vlastní model klasifikátoru.
documentClassifierCopyTo	string	Zkopírujte existující klasifikátor dokumentu do potenciálně jiného prostředku, oblasti nebo předplatného.
documentModelBuild	string	Vytvořte nový vlastní model dokumentu.
documentModelCompose	string	Vytvořte nový vlastní model dokumentu z existujících modelů.
documentModelCopyTo	string	Zkopírujte existující model dokumentu do potenciálně jiného prostředku, oblasti nebo předplatného.

SplitMode

Chování rozdělení souboru

Name	Typ	Description
auto	string	Automaticky rozdělte soubor na dokumenty.
none	string	Považovat celý soubor za jeden dokument.
perPage	string	Každou stránku v souboru můžete považovat za samostatný dokument.

Sdílet prostřednictvím

Miscellaneous Operations - Get Document Model Build Operation

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

Ocp-Apim-Subscription-Key

OAuth2Auth

Rozsahy

Příklady

Get Operation - Document Model Build

Ukázkový požadavek

Ukázková odpověď

Definice

AzureBlobContentSource

AzureBlobFileListContentSource

DocumentAnalysisFeature

DocumentBuildMode

DocumentFieldSchema

DocumentFieldType

DocumentIntelligenceError

DocumentIntelligenceErrorResponse

DocumentIntelligenceInnerError

DocumentIntelligenceOperationStatus

DocumentIntelligenceWarning

DocumentModelBuildOperationDetails

DocumentModelDetails

DocumentTypeDetails

OperationKind

SplitMode

Další materiály