Partilhar via


Destino SDK: API REST 2022–08–31 (GA)

! [Marca de verificação de inteligência documental].. /media/yes-icon.png) API REST versão 2022–08–31 (GA)

O Azure AI Document Intelligence é um serviço de nuvem que usa aprendizado de máquina para analisar texto e dados estruturados de documentos. O Document Intelligence software development kit (SDK) é um conjunto de bibliotecas e ferramentas que permitem integrar facilmente modelos e recursos de Document Intelligence em seus aplicativos. O Document Intelligence SDK está disponível em plataformas nas linguagens de programação C#/.NET, Java, JavaScript e Python.

Linguagens de programação suportadas

O SDK do Document Intelligence suporta os seguintes idiomas e plataformas:

Versão do SDK de Language → Document Intelligence Pacote Versão da API suportada Suporte da plataforma
.NET/C# → 4.0.0 (GA) NuGet v3,0 Windows, macOS, Linux, Docker
Java → 4.0.6 (GA) Repositório Maven v3,0 Windows, macOS, Linux
JavaScript → 4.0.0 (GA) npm v3,0 Navegador, Windows, macOS, Linux
Python → 3.2.0 (GA) PyPI v3,0 Windows, macOS, Linux

Para obter mais informações sobre outras versões do SDK, consulte:

Clientes suportados

Idioma Versão do SDK Versão da API Clientes suportados
JavaScript Java .NET/C#


4.0.0 (GA) v3.0:2022-08-31 (padrão) DocumentAnalysisClient
DocumentModelAdministrationClient
JavaScript Java .NET/C#


3.1.x v2.1 (padrão)
v2.0
FormRecognizerClient
FormTrainingClient
JavaScript Java .NET/C#


3.0.x v2.0 FormRecognizerClient
FormTrainingClient
Python 3.2.x (GA) v3.0:2022-08-31 (padrão) DocumentAnalysisClient
DocumentModelAdministrationClient
Python 3.1.x v2.1 (padrão)
v2.0
FormRecognizerClient
FormTrainingClient
Python 3.0.0 v2.0 FormRecognizerClient
FormTrainingClient

Use o SDK de inteligência de documentos em seus aplicativos

O SDK de Inteligência Documental permite o uso e o gerenciamento do serviço de Inteligência Documental em seu aplicativo. O SDK se baseia na API REST subjacente do Document Intelligence, permitindo que você use facilmente essas APIs dentro do seu paradigma de linguagem de programação. Veja como você usa o SDK de Inteligência Documental para seu idioma preferido:

1. Instale a biblioteca de cliente SDK

dotnet add package Azure.AI.FormRecognizer --version 4.0.0
Install-Package Azure.AI.FormRecognizer -Version 4.0.0

2. Importe a biblioteca de cliente SDK para seu aplicativo

using Azure;
using Azure.AI.FormRecognizer.DocumentAnalysis;

3. Configurar a autenticação

Há dois métodos suportados para autenticação:

Use sua chave de API

Veja onde encontrar sua chave de API de Inteligência Documental no portal do Azure:

Captura de ecrã das chaves e da localização do ponto de extremidade no portal do Azure.

Importante

Recomendamos a autenticação do Microsoft Entra ID com identidades gerenciadas para recursos do Azure para evitar o armazenamento de credenciais com seus aplicativos executados na nuvem.

Se você usar uma chave de API, armazene-a com segurança em outro lugar, como no Cofre de Chaves do Azure. Não inclua a chave da API diretamente no seu código e nunca a publique publicamente.

Para obter mais informações sobre segurança de serviços de IA, consulte Autenticar solicitações para serviços de IA do Azure.


//set `<your-endpoint>` and `<your-key>` variables with the values from the Azure portal to create your `AzureKeyCredential` and `DocumentAnalysisClient` instance
string key = "<your-key>";
string endpoint = "<your-endpoint>";
AzureKeyCredential credential = new AzureKeyCredential(key);
DocumentAnalysisClient client = new DocumentAnalysisClient(new Uri(endpoint), credential);

Usar uma credencial de token do Microsoft Entra

Nota

Os pontos de extremidade regionais não oferecem suporte à autenticação do Microsoft Entra. Crie um subdomínio personalizado para seu recurso para usar esse tipo de autenticação.

A autorização é mais fácil usando o DefaultAzureCredential. Ele fornece uma credencial de token padrão, com base no ambiente em execução, capaz de lidar com a maioria dos cenários de autenticação do Azure.

Veja como adquirir e usar o DefaultAzureCredential para aplicativos .NET:

  1. Instale a biblioteca de Identidades do Azure para .NET:

        dotnet add package Azure.Identity
    
        Install-Package Azure.Identity
    
  2. Registre um aplicativo Microsoft Entra e crie uma nova entidade de serviço.

  3. Conceda acesso ao Document Intelligence atribuindo a Cognitive Services User função à sua entidade de serviço.

  4. Defina os valores da ID do cliente, da ID do locatário e do segredo do cliente no aplicativo Microsoft Entra como variáveis de ambiente: AZURE_CLIENT_ID, AZURE_TENANT_IDe AZURE_CLIENT_SECRET, respectivamente.

  5. Crie sua DocumentAnalysisClient instância, incluindo o DefaultAzureCredential:

    string endpoint = "<your-endpoint>";
    var client = new DocumentAnalysisClient(new Uri(endpoint), new DefaultAzureCredential());
    

Para obter mais informações, consulte Autenticar o cliente.

4. Crie a sua aplicação

Crie um objeto de cliente para interagir com o SDK do Document Intelligence e, em seguida, chame métodos nesse objeto de cliente para interagir com o serviço. Os SDKs fornecem métodos síncronos e assíncronos. Para obter mais informações, experimente um início rápido em um idioma de sua escolha.

Opções de ajuda

Os fóruns Microsoft Q & A e Stack Overflow estão disponíveis para a comunidade de desenvolvedores fazer e responder perguntas sobre o Azure AI Document Intelligence e outros serviços. A Microsoft monitoriza os fóruns e responde a perguntas que a comunidade ainda não respondeu. Para se certificar de que vemos a sua pergunta, marque-a com azure-form-recognizer.

Próximos passos