Partilhar via


DocumentModelAdministrationClient class

Um cliente para interagir com os recursos de gerenciamento de modelo do serviço Reconhecimento de Formulários, como criar, ler, listar, excluir e copiar modelos.

Exemplos:

Azure Active Directory

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

Chave de API (Chave de Subscrição)

import { AzureKeyCredential, DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new AzureKeyCredential("<API key>");
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

Construtores

DocumentModelAdministrationClient(string, KeyCredential, DocumentModelAdministrationClientOptions)

Crie uma instância DocumentModelAdministrationClient a partir de um ponto de extremidade de recurso e uma chave de API estática (KeyCredential),

Exemplo:

import { AzureKeyCredential, DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new AzureKeyCredential("<API key>");
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);
DocumentModelAdministrationClient(string, TokenCredential, DocumentModelAdministrationClientOptions)

Crie uma instância DocumentModelAdministrationClient a partir de um ponto de extremidade de recurso e um TokenCredentialde Identidade do Azure.

Consulte o pacote @azure/identity para obter mais informações sobre a autenticação com o Azure Ative Directory.

Exemplo:

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

Métodos

beginBuildDocumentClassifier(string, DocumentClassifierDocumentTypeSources, BeginBuildDocumentClassifierOptions)

Crie um novo classificador de documentos com o ID do classificador e os tipos de documento fornecidos.

O ID do classificador deve ser exclusivo entre os classificadores dentro do recurso.

Os tipos de documento são fornecidos como um objeto que mapeia o nome do tipo de documento para o conjunto de dados de treinamento para esse tipo de documento. Dois métodos de entrada de dados de treinamento são suportados:

  • azureBlobSource, que treina um classificador usando os dados no contêiner de Armazenamento de Blob do Azure fornecido.
  • azureBlobFileListSource, que é semelhante ao azureBlobSource mas permite um controle mais refinado sobre os arquivos incluídos no conjunto de dados de treinamento usando uma lista de arquivos formatada em JSONL.

O serviço Reconhecimento de Formulário lê o conjunto de dados de treinamento de um contêiner de Armazenamento do Azure, fornecido como uma URL para o contêiner com um token SAS que permite que o back-end do serviço se comunique com o contêiner. No mínimo, as permissões "ler" e "listar" são necessárias. Além disso, os dados no contêiner dado devem ser organizados de acordo com uma convenção específica, que é documentada em documentação do serviço para a construção de classificadores de documentos personalizados.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const newClassifiedId = "aNewClassifier";
const containerUrl1 = "<training data container SAS URL 1>";
const containerUrl2 = "<training data container SAS URL 2>";

const poller = await client.beginBuildDocumentClassifier(
  newClassifiedId,
  {
    // The document types. Each entry in this object should map a document type name to a
    // `ClassifierDocumentTypeDetails` object
    formX: {
      azureBlobSource: {
        containerUrl: containerUrl1,
      },
    },
    formY: {
      azureBlobFileListSource: {
        containerUrl: containerUrl2,
        fileList: "path/to/fileList.jsonl",
      },
    },
  },
  {
    // Optionally, a text description may be attached to the classifier
    description: "This is an example classifier!",
  },
);

// Classifier building, like model creation operations, returns a poller that eventually produces a
// DocumentClassifierDetails object
const classifierDetails = await poller.pollUntilDone();

const {
  classifierId, // identical to the classifierId given when creating the classifier
  description, // identical to the description given when creating the classifier (if any)
  createdOn, // the Date (timestamp) that the classifier was created
  docTypes, // information about the document types in the classifier and their details
} = classifierDetails;
beginBuildDocumentModel(string, DocumentModelSource, DocumentModelBuildMode, BeginBuildDocumentModelOptions)

Crie um novo modelo com um determinado ID a partir de uma fonte de conteúdo de modelo.

A ID do modelo pode consistir em qualquer texto, desde que não comece com "prebuilt-" (como esses modelos se referem a modelos pré-construídos do Form Recognizer que são comuns a todos os recursos) e desde que ainda não exista dentro do recurso.

A fonte de conteúdo descreve o mecanismo que o serviço usará para ler os dados de treinamento de entrada. Consulte o tipo de <xref:DocumentModelContentSource> para obter mais informações.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const containerSasUrl = "<SAS url to the blob container storing training documents>";

// You must provide the model ID. It can be any text that does not start with "prebuilt-".
// For example, you could provide a randomly generated GUID using the "uuid" package.
// The second parameter is the SAS-encoded URL to an Azure Storage container with the training documents.
// The third parameter is the build mode: one of "template" (the only mode prior to 4.0.0-beta.3) or "neural".
// See https://aka.ms/azsdk/formrecognizer/buildmode for more information about build modes.
const poller = await client.beginBuildDocumentModel(
  "<model ID>",
  { azureBlobSource: { containerUrl: containerSasUrl } },
  "template",
  {
    // The model description is optional and can be any text.
    description: "This is my new model!",
    onProgress: ({ status }) => {
      console.log(`operation status: ${status}`);
    },
  },
);
const model = await poller.pollUntilDone();

console.log(`Model ID: ${model.modelId}`);
console.log(`Description: ${model.description}`);
console.log(`Created: ${model.createdOn}`);

// A model may contain several document types, which describe the possible object structures of fields extracted using
// this model

console.log("Document Types:");
for (const [docType, { description, fieldSchema: schema }] of Object.entries(
  model.docTypes ?? {},
)) {
  console.log(`- Name: "${docType}"`);
  console.log(`  Description: "${description}"`);

  // For simplicity, this example will only show top-level field names
  console.log("  Fields:");

  for (const [fieldName, fieldSchema] of Object.entries(schema)) {
    console.log(`  - "${fieldName}" (${fieldSchema.type})`);
    console.log(`    ${fieldSchema.description ?? "<no description>"}`);
  }
}
beginBuildDocumentModel(string, string, DocumentModelBuildMode, BeginBuildDocumentModelOptions)

Crie um novo modelo com uma determinada ID a partir de um conjunto de documentos de entrada e campos rotulados.

A ID do modelo pode consistir em qualquer texto, desde que não comece com "prebuilt-" (como esses modelos se referem a modelos pré-construídos do Form Recognizer que são comuns a todos os recursos) e desde que ainda não exista dentro do recurso.

O serviço Reconhecimento de Formulário lê o conjunto de dados de treinamento de um contêiner de Armazenamento do Azure, fornecido como uma URL para o contêiner com um token SAS que permite que o back-end do serviço se comunique com o contêiner. No mínimo, as permissões "ler" e "listar" são necessárias. Além disso, os dados no contêiner dado devem ser organizados de acordo com uma convenção específica, que é documentada em documentação do serviço para a construção de modelos personalizados.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const containerSasUrl = "<SAS url to the blob container storing training documents>";

// You must provide the model ID. It can be any text that does not start with "prebuilt-".
// For example, you could provide a randomly generated GUID using the "uuid" package.
// The second parameter is the SAS-encoded URL to an Azure Storage container with the training documents.
// The third parameter is the build mode: one of "template" (the only mode prior to 4.0.0-beta.3) or "neural".
// See https://aka.ms/azsdk/formrecognizer/buildmode for more information about build modes.
const poller = await client.beginBuildDocumentModel("<model ID>", containerSasUrl, "template", {
  // The model description is optional and can be any text.
  description: "This is my new model!",
  onProgress: ({ status }) => {
    console.log(`operation status: ${status}`);
  },
});
const model = await poller.pollUntilDone();

console.log(`Model ID: ${model.modelId}`);
console.log(`Description: ${model.description}`);
console.log(`Created: ${model.createdOn}`);

// A model may contain several document types, which describe the possible object structures of fields extracted using
// this model

console.log("Document Types:");
for (const [docType, { description, fieldSchema: schema }] of Object.entries(
  model.docTypes ?? {},
)) {
  console.log(`- Name: "${docType}"`);
  console.log(`  Description: "${description}"`);

  // For simplicity, this example will only show top-level field names
  console.log("  Fields:");

  for (const [fieldName, fieldSchema] of Object.entries(schema)) {
    console.log(`  - "${fieldName}" (${fieldSchema.type})`);
    console.log(`    ${fieldSchema.description ?? "<no description>"}`);
  }
}
beginComposeDocumentModel(string, Iterable<string>, BeginComposeDocumentModelOptions)

Cria um único modelo composto a partir de vários submodelos pré-existentes.

O modelo composto resultante combina os tipos de documentos de seus modelos de componentes e insere uma etapa de classificação no pipeline de extração para determinar qual de seus submodelos de componentes é mais apropriado para a entrada dada.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const composeModelId = "aNewComposedModel";
const subModelIds = ["documentType1Model", "documentType2Model", "documentType3Model"];

// The resulting composed model can classify and extract data from documents
// conforming to any of the above document types
const poller = await client.beginComposeDocumentModel(composeModelId, subModelIds, {
  description: "This is a composed model that can handle several document types.",
});
// Model composition, like all other model creation operations, returns a poller that eventually produces a
// ModelDetails object
const modelDetails = await poller.pollUntilDone();

const {
  modelId, // identical to the modelId given when creating the model
  description, // identical to the description given when creating the model
  createdOn, // the Date (timestamp) that the model was created
  docTypes, // information about the document types of the composed submodels
} = modelDetails;
beginCopyModelTo(string, CopyAuthorization, BeginCopyModelOptions)

Copia um modelo com a ID fornecida para o recurso e a ID do modelo codificados por uma determinada autorização de cópia.

Consulte CopyAuthorization e getCopyAuthorization.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient, AzureKeyCredential } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

// We create the copy authorization using a client authenticated with the destination resource. Note that these two
// resources can be the same (you can copy a model to a new ID in the same resource).
const copyAuthorization = await client.getCopyAuthorization("<destination model ID>");

// Finally, use the _source_ client to copy the model and await the copy operation
// We need a client for the source model's resource
const sourceEndpoint = "https://<source resource name>.cognitiveservices.azure.com";
const sourceCredential = new AzureKeyCredential("<source api key>");
const sourceClient = new DocumentModelAdministrationClient(sourceEndpoint, sourceCredential);
const poller = await sourceClient.beginCopyModelTo("<source model ID>", copyAuthorization);

// Model copying, like all other model creation operations, returns a poller that eventually produces a ModelDetails
// object
const modelDetails = await poller.pollUntilDone();

const {
  modelId, // identical to the modelId given when creating the copy authorization
  description, // identical to the description given when creating the copy authorization
  createdOn, // the Date (timestamp) that the model was created
  docTypes, // information about the document types of the model (identical to the original, source model)
} = modelDetails;
deleteDocumentClassifier(string, OperationOptions)

Exclui um classificador com o ID fornecido do recurso do cliente, se ele existir. Esta operação NÃO pode ser revertida.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

await client.deleteDocumentClassifier("<classifier ID to delete>");
deleteDocumentModel(string, DeleteDocumentModelOptions)

Exclui um modelo com a ID fornecida do recurso do cliente, se existir. Esta operação NÃO pode ser revertida.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

await client.deleteDocumentModel("<model ID to delete>");
getCopyAuthorization(string, GetCopyAuthorizationOptions)

Cria uma autorização para copiar um modelo para o recurso, usado com o método beginCopyModelTo.

O CopyAuthorization concede a outro recurso de serviço cognitivo o direito de criar um modelo no recurso deste cliente com o ID do modelo e a descrição opcional que são codificados na autorização.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

// The copyAuthorization data structure stored below grants any cognitive services resource the right to copy a
// model into the client's resource with the given destination model ID.
const copyAuthorization = await client.getCopyAuthorization("<destination model ID>");
getDocumentClassifier(string, OperationOptions)

Recupera informações sobre um classificador (DocumentClassifierDetails) por ID.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const foundClassifier = "<classifier ID>";

const {
  classifierId, // identical to the ID given when calling `getDocumentClassifier`
  description, // a textual description of the classifier, if provided during classifier creation
  createdOn, // the Date (timestamp) that the classifier was created
  // information about the document types in the classifier and their corresponding traning data
  docTypes,
} = await client.getDocumentClassifier(foundClassifier);

// The `docTypes` property is a map of document type names to information about the training data
// for that document type.
for (const [docTypeName, classifierDocTypeDetails] of Object.entries(docTypes)) {
  console.log(`- '${docTypeName}': `, classifierDocTypeDetails);
}
getDocumentModel(string, GetModelOptions)

Recupera informações sobre um modelo (DocumentModelDetails) por ID.

Esse método pode recuperar informações sobre modelos personalizados e pré-construídos.

Mudança Crítica

Em versões anteriores da API REST e do SDK do Form Recognizer, o método getModel podia retornar qualquer modelo, mesmo um que não conseguiu criar devido a erros. Nas novas versões de serviço, getDocumentModel e listDocumentModelssó produzem modelos criados com sucesso (ou seja, modelos que estão "prontos" para uso). Os modelos com falha agora são recuperados por meio das APIs de "operações", consulte getOperation e listOperations.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

// The ID of the prebuilt business card model
const prebuiltModelId = "prebuilt-businessCard";

const {
  modelId, // identical to the modelId given when calling `getDocumentModel`
  description, // a textual description of the model, if provided during model creation
  createdOn, // the Date (timestamp) that the model was created
  // information about the document types in the model and their field schemas
  docTypes: {
    // the document type of the prebuilt business card model
    "prebuilt:businesscard": {
      // an optional, textual description of this document type
      description: businessCardDescription,
      // the schema of the fields in this document type, see the FieldSchema type
      fieldSchema,
      // the service's confidences in the fields (an object with field names as properties and numeric confidence
      // values)
      fieldConfidence,
    },
  },
} = await client.getDocumentModel(prebuiltModelId);
getOperation(string, GetOperationOptions)

Recupera informações sobre uma operação (OperationDetails) por sua ID.

As operações representam tarefas que não são de análise, como criar, compor ou copiar um modelo.

getResourceDetails(GetResourceDetailsOptions)

Recupere informações básicas sobre o recurso deste cliente.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const {
  // Information about the custom models in the current resource
  customDocumentModels: {
    // The number of custom models in the current resource
    count,
    // The maximum number of models that the current resource can support
    limit,
  },
} = await client.getResourceDetails();
listDocumentClassifiers(ListModelsOptions)

Liste detalhes sobre classificadores no recurso. Esta operação suporta paginação.

Exemplos

Iteração assíncrona

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

for await (const details of client.listDocumentClassifiers()) {
  const {
    classifierId, // The classifier's unique ID
    description, // a textual description of the classifier, if provided during creation
    docTypes, // information about the document types in the classifier and their corresponding traning data
  } = details;
}

// The listDocumentClassifiers method is paged, and you can iterate by page using the `byPage` method.
const pages = client.listDocumentClassifiers().byPage();

for await (const page of pages) {
  // Each page is an array of classifiers and can be iterated synchronously
  for (const details of page) {
    const {
      classifierId, // The classifier's unique ID
      description, // a textual description of the classifier, if provided during creation
      docTypes, // information about the document types in the classifier and their corresponding traning data
    } = details;
  }
}
listDocumentModels(ListModelsOptions)

Listar resumos de modelos no recurso. Modelos personalizados e pré-construídos serão incluídos. Esta operação suporta paginação.

O resumo do modelo (DocumentModelSummary) inclui apenas as informações básicas sobre o modelo e não inclui informações sobre os tipos de documento no modelo (como esquemas de campo e valores de confiança).

Para acessar as informações completas sobre o modelo, use getDocumentModel.

Mudança Crítica

Em versões anteriores da API REST do Form Recognizer e do SDK, o método listModels retornava todos os modelos, mesmo aqueles que não conseguiram criar devido a erros. Nas novas versões de serviço, listDocumentModels e getDocumentModelsó produzem modelos criados com sucesso (ou seja, modelos que estão "prontos" para uso). Os modelos com falha agora são recuperados por meio das APIs de "operações", consulte getOperation e listOperations.

Exemplos

Iteração assíncrona

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

// Iterate over all models in the current resource
for await (const summary of client.listDocumentModels()) {
  const {
    modelId, // The model's unique ID
    description, // a textual description of the model, if provided during model creation
  } = summary;

  // You can get the full model info using `getDocumentModel`
  const model = await client.getDocumentModel(modelId);
}

// The listDocumentModels method is paged, and you can iterate by page using the `byPage` method.
const pages = client.listDocumentModels().byPage();

for await (const page of pages) {
  // Each page is an array of models and can be iterated synchronously
  for (const summary of page) {
    const {
      modelId, // The model's unique ID
      description, // a textual description of the model, if provided during model creation
    } = summary;

    // You can get the full model info using `getDocumentModel`
    const model = await client.getDocumentModel(modelId);
  }
}
listOperations(ListOperationsOptions)

Listar operações de criação de modelo no recurso. Isso produzirá todas as operações, incluindo as operações que não conseguiram criar modelos com êxito. Esta operação suporta paginação.

Exemplos

Iteração assíncrona

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

for await (const operation of client.listOperations()) {
  const {
    operationId, // the operation's GUID
    status, // the operation status, one of "notStarted", "running", "succeeded", "failed", or "canceled"
    percentCompleted, // the progress of the operation, from 0 to 100
  } = operation;
}

// The listOperations method is paged, and you can iterate by page using the `byPage` method.
const pages = client.listOperations().byPage();

for await (const page of pages) {
  // Each page is an array of operation info objects and can be iterated synchronously
  for (const operation of page) {
    const {
      operationId, // the operation's GUID
      status, // the operation status, one of "notStarted", "running", "succeeded", "failed", or "canceled"
      percentCompleted, // the progress of the operation, from 0 to 100
    } = operation;
  }
}

Detalhes do Construtor

DocumentModelAdministrationClient(string, KeyCredential, DocumentModelAdministrationClientOptions)

Crie uma instância DocumentModelAdministrationClient a partir de um ponto de extremidade de recurso e uma chave de API estática (KeyCredential),

Exemplo:

import { AzureKeyCredential, DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new AzureKeyCredential("<API key>");
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);
new DocumentModelAdministrationClient(endpoint: string, credential: KeyCredential, options?: DocumentModelAdministrationClientOptions)

Parâmetros

endpoint

string

a URL do ponto de extremidade de uma instância dos Serviços Cognitivos do Azure

credential
KeyCredential

uma KeyCredential contendo a chave de assinatura da instância dos Serviços Cognitivos

options
DocumentModelAdministrationClientOptions

Configurações opcionais para configurar todos os métodos no cliente

DocumentModelAdministrationClient(string, TokenCredential, DocumentModelAdministrationClientOptions)

Crie uma instância DocumentModelAdministrationClient a partir de um ponto de extremidade de recurso e um TokenCredentialde Identidade do Azure.

Consulte o pacote @azure/identity para obter mais informações sobre a autenticação com o Azure Ative Directory.

Exemplo:

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);
new DocumentModelAdministrationClient(endpoint: string, credential: TokenCredential, options?: DocumentModelAdministrationClientOptions)

Parâmetros

endpoint

string

a URL do ponto de extremidade de uma instância dos Serviços Cognitivos do Azure

credential
TokenCredential

uma instância TokenCredential do pacote @azure/identity

options
DocumentModelAdministrationClientOptions

Configurações opcionais para configurar todos os métodos no cliente

Detalhes de Método

beginBuildDocumentClassifier(string, DocumentClassifierDocumentTypeSources, BeginBuildDocumentClassifierOptions)

Crie um novo classificador de documentos com o ID do classificador e os tipos de documento fornecidos.

O ID do classificador deve ser exclusivo entre os classificadores dentro do recurso.

Os tipos de documento são fornecidos como um objeto que mapeia o nome do tipo de documento para o conjunto de dados de treinamento para esse tipo de documento. Dois métodos de entrada de dados de treinamento são suportados:

  • azureBlobSource, que treina um classificador usando os dados no contêiner de Armazenamento de Blob do Azure fornecido.
  • azureBlobFileListSource, que é semelhante ao azureBlobSource mas permite um controle mais refinado sobre os arquivos incluídos no conjunto de dados de treinamento usando uma lista de arquivos formatada em JSONL.

O serviço Reconhecimento de Formulário lê o conjunto de dados de treinamento de um contêiner de Armazenamento do Azure, fornecido como uma URL para o contêiner com um token SAS que permite que o back-end do serviço se comunique com o contêiner. No mínimo, as permissões "ler" e "listar" são necessárias. Além disso, os dados no contêiner dado devem ser organizados de acordo com uma convenção específica, que é documentada em documentação do serviço para a construção de classificadores de documentos personalizados.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const newClassifiedId = "aNewClassifier";
const containerUrl1 = "<training data container SAS URL 1>";
const containerUrl2 = "<training data container SAS URL 2>";

const poller = await client.beginBuildDocumentClassifier(
  newClassifiedId,
  {
    // The document types. Each entry in this object should map a document type name to a
    // `ClassifierDocumentTypeDetails` object
    formX: {
      azureBlobSource: {
        containerUrl: containerUrl1,
      },
    },
    formY: {
      azureBlobFileListSource: {
        containerUrl: containerUrl2,
        fileList: "path/to/fileList.jsonl",
      },
    },
  },
  {
    // Optionally, a text description may be attached to the classifier
    description: "This is an example classifier!",
  },
);

// Classifier building, like model creation operations, returns a poller that eventually produces a
// DocumentClassifierDetails object
const classifierDetails = await poller.pollUntilDone();

const {
  classifierId, // identical to the classifierId given when creating the classifier
  description, // identical to the description given when creating the classifier (if any)
  createdOn, // the Date (timestamp) that the classifier was created
  docTypes, // information about the document types in the classifier and their details
} = classifierDetails;
function beginBuildDocumentClassifier(classifierId: string, docTypeSources: DocumentClassifierDocumentTypeSources, options?: BeginBuildDocumentClassifierOptions): Promise<DocumentClassifierPoller>

Parâmetros

classifierId

string

o ID exclusivo do classificador a ser criado

docTypeSources
DocumentClassifierDocumentTypeSources

os tipos de documento a serem incluídos no classificador e suas fontes (um mapa de nomes de tipos de documento para ClassifierDocumentTypeDetails)

options
BeginBuildDocumentClassifierOptions

Configurações opcionais para a operação de compilação do classificador

Devoluções

uma operação de longa duração (poller) que acabará por produzir os detalhes do classificador criado ou um erro

beginBuildDocumentModel(string, DocumentModelSource, DocumentModelBuildMode, BeginBuildDocumentModelOptions)

Crie um novo modelo com um determinado ID a partir de uma fonte de conteúdo de modelo.

A ID do modelo pode consistir em qualquer texto, desde que não comece com "prebuilt-" (como esses modelos se referem a modelos pré-construídos do Form Recognizer que são comuns a todos os recursos) e desde que ainda não exista dentro do recurso.

A fonte de conteúdo descreve o mecanismo que o serviço usará para ler os dados de treinamento de entrada. Consulte o tipo de <xref:DocumentModelContentSource> para obter mais informações.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const containerSasUrl = "<SAS url to the blob container storing training documents>";

// You must provide the model ID. It can be any text that does not start with "prebuilt-".
// For example, you could provide a randomly generated GUID using the "uuid" package.
// The second parameter is the SAS-encoded URL to an Azure Storage container with the training documents.
// The third parameter is the build mode: one of "template" (the only mode prior to 4.0.0-beta.3) or "neural".
// See https://aka.ms/azsdk/formrecognizer/buildmode for more information about build modes.
const poller = await client.beginBuildDocumentModel(
  "<model ID>",
  { azureBlobSource: { containerUrl: containerSasUrl } },
  "template",
  {
    // The model description is optional and can be any text.
    description: "This is my new model!",
    onProgress: ({ status }) => {
      console.log(`operation status: ${status}`);
    },
  },
);
const model = await poller.pollUntilDone();

console.log(`Model ID: ${model.modelId}`);
console.log(`Description: ${model.description}`);
console.log(`Created: ${model.createdOn}`);

// A model may contain several document types, which describe the possible object structures of fields extracted using
// this model

console.log("Document Types:");
for (const [docType, { description, fieldSchema: schema }] of Object.entries(
  model.docTypes ?? {},
)) {
  console.log(`- Name: "${docType}"`);
  console.log(`  Description: "${description}"`);

  // For simplicity, this example will only show top-level field names
  console.log("  Fields:");

  for (const [fieldName, fieldSchema] of Object.entries(schema)) {
    console.log(`  - "${fieldName}" (${fieldSchema.type})`);
    console.log(`    ${fieldSchema.description ?? "<no description>"}`);
  }
}
function beginBuildDocumentModel(modelId: string, contentSource: DocumentModelSource, buildMode: DocumentModelBuildMode, options?: BeginBuildDocumentModelOptions): Promise<DocumentModelPoller>

Parâmetros

modelId

string

o ID exclusivo do modelo a ser criado

contentSource
DocumentModelSource

Uma fonte de conteúdo que fornece os dados de treinamento para este modelo

buildMode

DocumentModelBuildMode

o modo a utilizar ao construir o modelo (ver DocumentModelBuildMode)

options
BeginBuildDocumentModelOptions

Configurações opcionais para a operação de compilação do modelo

Devoluções

uma operação de longa duração (poller) que acabará por produzir as informações do modelo criado ou um erro

beginBuildDocumentModel(string, string, DocumentModelBuildMode, BeginBuildDocumentModelOptions)

Crie um novo modelo com uma determinada ID a partir de um conjunto de documentos de entrada e campos rotulados.

A ID do modelo pode consistir em qualquer texto, desde que não comece com "prebuilt-" (como esses modelos se referem a modelos pré-construídos do Form Recognizer que são comuns a todos os recursos) e desde que ainda não exista dentro do recurso.

O serviço Reconhecimento de Formulário lê o conjunto de dados de treinamento de um contêiner de Armazenamento do Azure, fornecido como uma URL para o contêiner com um token SAS que permite que o back-end do serviço se comunique com o contêiner. No mínimo, as permissões "ler" e "listar" são necessárias. Além disso, os dados no contêiner dado devem ser organizados de acordo com uma convenção específica, que é documentada em documentação do serviço para a construção de modelos personalizados.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const containerSasUrl = "<SAS url to the blob container storing training documents>";

// You must provide the model ID. It can be any text that does not start with "prebuilt-".
// For example, you could provide a randomly generated GUID using the "uuid" package.
// The second parameter is the SAS-encoded URL to an Azure Storage container with the training documents.
// The third parameter is the build mode: one of "template" (the only mode prior to 4.0.0-beta.3) or "neural".
// See https://aka.ms/azsdk/formrecognizer/buildmode for more information about build modes.
const poller = await client.beginBuildDocumentModel("<model ID>", containerSasUrl, "template", {
  // The model description is optional and can be any text.
  description: "This is my new model!",
  onProgress: ({ status }) => {
    console.log(`operation status: ${status}`);
  },
});
const model = await poller.pollUntilDone();

console.log(`Model ID: ${model.modelId}`);
console.log(`Description: ${model.description}`);
console.log(`Created: ${model.createdOn}`);

// A model may contain several document types, which describe the possible object structures of fields extracted using
// this model

console.log("Document Types:");
for (const [docType, { description, fieldSchema: schema }] of Object.entries(
  model.docTypes ?? {},
)) {
  console.log(`- Name: "${docType}"`);
  console.log(`  Description: "${description}"`);

  // For simplicity, this example will only show top-level field names
  console.log("  Fields:");

  for (const [fieldName, fieldSchema] of Object.entries(schema)) {
    console.log(`  - "${fieldName}" (${fieldSchema.type})`);
    console.log(`    ${fieldSchema.description ?? "<no description>"}`);
  }
}
function beginBuildDocumentModel(modelId: string, containerUrl: string, buildMode: DocumentModelBuildMode, options?: BeginBuildDocumentModelOptions): Promise<DocumentModelPoller>

Parâmetros

modelId

string

o ID exclusivo do modelo a ser criado

containerUrl

string

URL codificada em SAS para um contêiner de Armazenamento do Azure que contém o conjunto de dados de treinamento

buildMode

DocumentModelBuildMode

o modo a utilizar ao construir o modelo (ver DocumentModelBuildMode)

options
BeginBuildDocumentModelOptions

Configurações opcionais para a operação de compilação do modelo

Devoluções

uma operação de longa duração (poller) que acabará por produzir as informações do modelo criado ou um erro

beginComposeDocumentModel(string, Iterable<string>, BeginComposeDocumentModelOptions)

Cria um único modelo composto a partir de vários submodelos pré-existentes.

O modelo composto resultante combina os tipos de documentos de seus modelos de componentes e insere uma etapa de classificação no pipeline de extração para determinar qual de seus submodelos de componentes é mais apropriado para a entrada dada.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const composeModelId = "aNewComposedModel";
const subModelIds = ["documentType1Model", "documentType2Model", "documentType3Model"];

// The resulting composed model can classify and extract data from documents
// conforming to any of the above document types
const poller = await client.beginComposeDocumentModel(composeModelId, subModelIds, {
  description: "This is a composed model that can handle several document types.",
});
// Model composition, like all other model creation operations, returns a poller that eventually produces a
// ModelDetails object
const modelDetails = await poller.pollUntilDone();

const {
  modelId, // identical to the modelId given when creating the model
  description, // identical to the description given when creating the model
  createdOn, // the Date (timestamp) that the model was created
  docTypes, // information about the document types of the composed submodels
} = modelDetails;
function beginComposeDocumentModel(modelId: string, componentModelIds: Iterable<string>, options?: BeginComposeDocumentModelOptions): Promise<DocumentModelPoller>

Parâmetros

modelId

string

o ID exclusivo do modelo a ser criado

componentModelIds

Iterable<string>

um Iterable de cadeias de caracteres que representam as IDs de modelo exclusivas dos modelos a serem compostos;

options
BeginComposeDocumentModelOptions

Configurações opcionais para a criação de modelos

Devoluções

uma operação de longa duração (poller) que acabará por produzir as informações do modelo criado ou um erro

beginCopyModelTo(string, CopyAuthorization, BeginCopyModelOptions)

Copia um modelo com a ID fornecida para o recurso e a ID do modelo codificados por uma determinada autorização de cópia.

Consulte CopyAuthorization e getCopyAuthorization.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient, AzureKeyCredential } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

// We create the copy authorization using a client authenticated with the destination resource. Note that these two
// resources can be the same (you can copy a model to a new ID in the same resource).
const copyAuthorization = await client.getCopyAuthorization("<destination model ID>");

// Finally, use the _source_ client to copy the model and await the copy operation
// We need a client for the source model's resource
const sourceEndpoint = "https://<source resource name>.cognitiveservices.azure.com";
const sourceCredential = new AzureKeyCredential("<source api key>");
const sourceClient = new DocumentModelAdministrationClient(sourceEndpoint, sourceCredential);
const poller = await sourceClient.beginCopyModelTo("<source model ID>", copyAuthorization);

// Model copying, like all other model creation operations, returns a poller that eventually produces a ModelDetails
// object
const modelDetails = await poller.pollUntilDone();

const {
  modelId, // identical to the modelId given when creating the copy authorization
  description, // identical to the description given when creating the copy authorization
  createdOn, // the Date (timestamp) that the model was created
  docTypes, // information about the document types of the model (identical to the original, source model)
} = modelDetails;
function beginCopyModelTo(sourceModelId: string, authorization: CopyAuthorization, options?: BeginCopyModelOptions): Promise<DocumentModelPoller>

Parâmetros

sourceModelId

string

a ID exclusiva do modelo de origem que será copiado

authorization
CopyAuthorization

uma autorização para copiar o modelo, criada usando o getCopyAuthorization

options
BeginCopyModelOptions

configurações opcionais para

Devoluções

uma operação de longa duração (poller) que acabará por produzir as informações do modelo copiado ou um erro

deleteDocumentClassifier(string, OperationOptions)

Exclui um classificador com o ID fornecido do recurso do cliente, se ele existir. Esta operação NÃO pode ser revertida.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

await client.deleteDocumentClassifier("<classifier ID to delete>");
function deleteDocumentClassifier(classifierId: string, options?: OperationOptions): Promise<void>

Parâmetros

classifierId

string

a ID exclusiva do classificador a ser excluído do recurso

options
OperationOptions

Configurações opcionais para a solicitação

Devoluções

Promise<void>

deleteDocumentModel(string, DeleteDocumentModelOptions)

Exclui um modelo com a ID fornecida do recurso do cliente, se existir. Esta operação NÃO pode ser revertida.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

await client.deleteDocumentModel("<model ID to delete>");
function deleteDocumentModel(modelId: string, options?: DeleteDocumentModelOptions): Promise<void>

Parâmetros

modelId

string

a ID exclusiva do modelo a ser excluído do recurso

options
DeleteDocumentModelOptions

Configurações opcionais para a solicitação

Devoluções

Promise<void>

getCopyAuthorization(string, GetCopyAuthorizationOptions)

Cria uma autorização para copiar um modelo para o recurso, usado com o método beginCopyModelTo.

O CopyAuthorization concede a outro recurso de serviço cognitivo o direito de criar um modelo no recurso deste cliente com o ID do modelo e a descrição opcional que são codificados na autorização.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

// The copyAuthorization data structure stored below grants any cognitive services resource the right to copy a
// model into the client's resource with the given destination model ID.
const copyAuthorization = await client.getCopyAuthorization("<destination model ID>");
function getCopyAuthorization(destinationModelId: string, options?: GetCopyAuthorizationOptions): Promise<CopyAuthorization>

Parâmetros

destinationModelId

string

o ID exclusivo do modelo de destino (o ID para o qual copiar o modelo)

options
GetCopyAuthorizationOptions

Configurações opcionais para criar a autorização de cópia

Devoluções

uma autorização de cópia que codifica o modelId fornecido e a descrição opcional

getDocumentClassifier(string, OperationOptions)

Recupera informações sobre um classificador (DocumentClassifierDetails) por ID.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const foundClassifier = "<classifier ID>";

const {
  classifierId, // identical to the ID given when calling `getDocumentClassifier`
  description, // a textual description of the classifier, if provided during classifier creation
  createdOn, // the Date (timestamp) that the classifier was created
  // information about the document types in the classifier and their corresponding traning data
  docTypes,
} = await client.getDocumentClassifier(foundClassifier);

// The `docTypes` property is a map of document type names to information about the training data
// for that document type.
for (const [docTypeName, classifierDocTypeDetails] of Object.entries(docTypes)) {
  console.log(`- '${docTypeName}': `, classifierDocTypeDetails);
}
function getDocumentClassifier(classifierId: string, options?: OperationOptions): Promise<DocumentClassifierDetails>

Parâmetros

classifierId

string

o ID exclusivo do classificador a ser consultado

options
OperationOptions

Configurações opcionais para a solicitação

Devoluções

informações sobre o classificador com o ID fornecido

getDocumentModel(string, GetModelOptions)

Recupera informações sobre um modelo (DocumentModelDetails) por ID.

Esse método pode recuperar informações sobre modelos personalizados e pré-construídos.

Mudança Crítica

Em versões anteriores da API REST e do SDK do Form Recognizer, o método getModel podia retornar qualquer modelo, mesmo um que não conseguiu criar devido a erros. Nas novas versões de serviço, getDocumentModel e listDocumentModelssó produzem modelos criados com sucesso (ou seja, modelos que estão "prontos" para uso). Os modelos com falha agora são recuperados por meio das APIs de "operações", consulte getOperation e listOperations.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

// The ID of the prebuilt business card model
const prebuiltModelId = "prebuilt-businessCard";

const {
  modelId, // identical to the modelId given when calling `getDocumentModel`
  description, // a textual description of the model, if provided during model creation
  createdOn, // the Date (timestamp) that the model was created
  // information about the document types in the model and their field schemas
  docTypes: {
    // the document type of the prebuilt business card model
    "prebuilt:businesscard": {
      // an optional, textual description of this document type
      description: businessCardDescription,
      // the schema of the fields in this document type, see the FieldSchema type
      fieldSchema,
      // the service's confidences in the fields (an object with field names as properties and numeric confidence
      // values)
      fieldConfidence,
    },
  },
} = await client.getDocumentModel(prebuiltModelId);
function getDocumentModel(modelId: string, options?: GetModelOptions): Promise<DocumentModelDetails>

Parâmetros

modelId

string

a ID exclusiva do modelo a ser consultado

options
GetModelOptions

Configurações opcionais para a solicitação

Devoluções

informações sobre o modelo com o ID fornecido

getOperation(string, GetOperationOptions)

Recupera informações sobre uma operação (OperationDetails) por sua ID.

As operações representam tarefas que não são de análise, como criar, compor ou copiar um modelo.

function getOperation(operationId: string, options?: GetOperationOptions): Promise<OperationDetails>

Parâmetros

operationId

string

o ID da operação a consultar

options
GetOperationOptions

Configurações opcionais para a solicitação

Devoluções

Promise<OperationDetails>

informações sobre a operação com o ID fornecido

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

// The ID of the operation, which should be a GUID
const findOperationId = "<operation GUID>";

const {
  operationId, // identical to the operationId given when calling `getOperation`
  kind, // the operation kind, one of "documentModelBuild", "documentModelCompose", or "documentModelCopyTo"
  status, // the status of the operation, one of "notStarted", "running", "failed", "succeeded", or "canceled"
  percentCompleted, // a number between 0 and 100 representing the progress of the operation
  createdOn, // a Date object that reflects the time when the operation was started
  lastUpdatedOn, // a Date object that reflects the time when the operation state was last modified
} = await client.getOperation(findOperationId);

getResourceDetails(GetResourceDetailsOptions)

Recupere informações básicas sobre o recurso deste cliente.

Exemplo

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

const {
  // Information about the custom models in the current resource
  customDocumentModels: {
    // The number of custom models in the current resource
    count,
    // The maximum number of models that the current resource can support
    limit,
  },
} = await client.getResourceDetails();
function getResourceDetails(options?: GetResourceDetailsOptions): Promise<ResourceDetails>

Parâmetros

options
GetResourceDetailsOptions

Configurações opcionais para a solicitação

Devoluções

Promise<ResourceDetails>

Informações básicas sobre o recurso deste cliente

listDocumentClassifiers(ListModelsOptions)

Liste detalhes sobre classificadores no recurso. Esta operação suporta paginação.

Exemplos

Iteração assíncrona

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

for await (const details of client.listDocumentClassifiers()) {
  const {
    classifierId, // The classifier's unique ID
    description, // a textual description of the classifier, if provided during creation
    docTypes, // information about the document types in the classifier and their corresponding traning data
  } = details;
}

// The listDocumentClassifiers method is paged, and you can iterate by page using the `byPage` method.
const pages = client.listDocumentClassifiers().byPage();

for await (const page of pages) {
  // Each page is an array of classifiers and can be iterated synchronously
  for (const details of page) {
    const {
      classifierId, // The classifier's unique ID
      description, // a textual description of the classifier, if provided during creation
      docTypes, // information about the document types in the classifier and their corresponding traning data
    } = details;
  }
}
function listDocumentClassifiers(options?: ListModelsOptions): PagedAsyncIterableIterator<DocumentClassifierDetails, DocumentClassifierDetails[], PageSettings>

Parâmetros

options
ListModelsOptions

Configurações opcionais para as solicitações do classificador

Devoluções

um assíncrono iterável de detalhes do classificador que suporta paginação

listDocumentModels(ListModelsOptions)

Listar resumos de modelos no recurso. Modelos personalizados e pré-construídos serão incluídos. Esta operação suporta paginação.

O resumo do modelo (DocumentModelSummary) inclui apenas as informações básicas sobre o modelo e não inclui informações sobre os tipos de documento no modelo (como esquemas de campo e valores de confiança).

Para acessar as informações completas sobre o modelo, use getDocumentModel.

Mudança Crítica

Em versões anteriores da API REST do Form Recognizer e do SDK, o método listModels retornava todos os modelos, mesmo aqueles que não conseguiram criar devido a erros. Nas novas versões de serviço, listDocumentModels e getDocumentModelsó produzem modelos criados com sucesso (ou seja, modelos que estão "prontos" para uso). Os modelos com falha agora são recuperados por meio das APIs de "operações", consulte getOperation e listOperations.

Exemplos

Iteração assíncrona

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

// Iterate over all models in the current resource
for await (const summary of client.listDocumentModels()) {
  const {
    modelId, // The model's unique ID
    description, // a textual description of the model, if provided during model creation
  } = summary;

  // You can get the full model info using `getDocumentModel`
  const model = await client.getDocumentModel(modelId);
}

// The listDocumentModels method is paged, and you can iterate by page using the `byPage` method.
const pages = client.listDocumentModels().byPage();

for await (const page of pages) {
  // Each page is an array of models and can be iterated synchronously
  for (const summary of page) {
    const {
      modelId, // The model's unique ID
      description, // a textual description of the model, if provided during model creation
    } = summary;

    // You can get the full model info using `getDocumentModel`
    const model = await client.getDocumentModel(modelId);
  }
}
function listDocumentModels(options?: ListModelsOptions): PagedAsyncIterableIterator<DocumentModelSummary, DocumentModelSummary[], PageSettings>

Parâmetros

options
ListModelsOptions

Configurações opcionais para as solicitações de modelo

Devoluções

um assíncrono iterável de resumos de modelo que suporta paginação

listOperations(ListOperationsOptions)

Listar operações de criação de modelo no recurso. Isso produzirá todas as operações, incluindo as operações que não conseguiram criar modelos com êxito. Esta operação suporta paginação.

Exemplos

Iteração assíncrona

import { DefaultAzureCredential } from "@azure/identity";
import { DocumentModelAdministrationClient } from "@azure/ai-form-recognizer";

const credential = new DefaultAzureCredential();
const client = new DocumentModelAdministrationClient(
  "https://<resource name>.cognitiveservices.azure.com",
  credential,
);

for await (const operation of client.listOperations()) {
  const {
    operationId, // the operation's GUID
    status, // the operation status, one of "notStarted", "running", "succeeded", "failed", or "canceled"
    percentCompleted, // the progress of the operation, from 0 to 100
  } = operation;
}

// The listOperations method is paged, and you can iterate by page using the `byPage` method.
const pages = client.listOperations().byPage();

for await (const page of pages) {
  // Each page is an array of operation info objects and can be iterated synchronously
  for (const operation of page) {
    const {
      operationId, // the operation's GUID
      status, // the operation status, one of "notStarted", "running", "succeeded", "failed", or "canceled"
      percentCompleted, // the progress of the operation, from 0 to 100
    } = operation;
  }
}
function listOperations(options?: ListOperationsOptions): PagedAsyncIterableIterator<OperationSummary, OperationSummary[], PageSettings>

Parâmetros

options
ListOperationsOptions

Configurações opcionais para as solicitações de operação

Devoluções

um async iterável de objetos de informações de operação que suporta paginação