Azure.AI.DocumentIntelligence (.NET)

Extraia texto, tabelas e dados estruturados de documentos usando modelos pré-criados e personalizados.

Instalação

dotnet add package Azure.AI.DocumentIntelligence
dotnet add package Azure.Identity

Versão Atual: v1.0.0 (GA)

Variáveis de Ambiente

DOCUMENT_INTELLIGENCE_ENDPOINT=https://<resource-name>.cognitiveservices.azure.com/
DOCUMENT_INTELLIGENCE_API_KEY=<your-api-key>
BLOB_CONTAINER_SAS_URL=https://<storage>.blob.core.windows.net/<container>?<sas-token>

Autenticação

Microsoft Entra ID (Recomendado)

using Azure.Identity;
using Azure.AI.DocumentIntelligence;

string endpoint = Environment.GetEnvironmentVariable("DOCUMENT_INTELLIGENCE_ENDPOINT");
var credential = new DefaultAzureCredential();
var client = new DocumentIntelligenceClient(new Uri(endpoint), credential);

Observação: O Entra ID requer um subdomínio personalizado (por exemplo, https://<resource-name>.cognitiveservices.azure.com/), não um endpoint regional.

Chave de API

string endpoint = Environment.GetEnvironmentVariable("DOCUMENT_INTELLIGENCE_ENDPOINT");
string apiKey = Environment.GetEnvironmentVariable("DOCUMENT_INTELLIGENCE_API_KEY");
var client = new DocumentIntelligenceClient(new Uri(endpoint), new AzureKeyCredential(apiKey));

Tipos de Cliente

Modelos Pré-criados

Fluxos de Trabalho Principais

1. Analisar Fatura

using Azure.AI.DocumentIntelligence;

Uri invoiceUri = new Uri("https://example.com/invoice.pdf");

Operation<AnalyzeResult> operation = await client.AnalyzeDocumentAsync(
    WaitUntil.Completed, 
    "prebuilt-invoice", 
    invoiceUri);

AnalyzeResult result = operation.Value;

foreach (AnalyzedDocument document in result.Documents)
{
    if (document.Fields.TryGetValue("VendorName", out DocumentField vendorNameField)
        && vendorNameField.FieldType == DocumentFieldType.String)
    {
        string vendorName = vendorNameField.ValueString;
        Console.WriteLine($"Vendor Name: '{vendorName}', confidence: {vendorNameField.Confidence}");
    }

    if (document.Fields.TryGetValue("InvoiceTotal", out DocumentField invoiceTotalField)
        && invoiceTotalField.FieldType == DocumentFieldType.Currency)
    {
        CurrencyValue invoiceTotal = invoiceTotalField.ValueCurrency;
        Console.WriteLine($"Invoice Total: '{invoiceTotal.CurrencySymbol}{invoiceTotal.Amount}'");
    }
    
    // Extract line items
    if (document.Fields.TryGetValue("Items", out DocumentField itemsField)
        && itemsField.FieldType == DocumentFieldType.List)
    {
        foreach (DocumentField item in itemsField.ValueList)
        {
            var itemFields = item.ValueDictionary;
            if (itemFields.TryGetValue("Description", out DocumentField descField))
                Console.WriteLine($"  Item: {descField.ValueString}");
        }
    }
}

2. Extrair Layout (Texto, Tabelas, Estrutura)

Uri fileUri = new Uri("https://example.com/document.pdf");

Operation<AnalyzeResult> operation = await client.AnalyzeDocumentAsync(
    WaitUntil.Completed, 
    "prebuilt-layout", 
    fileUri);

AnalyzeResult result = operation.Value;

// Extrair texto por página
foreach (DocumentPage page in result.Pages)
{
    Console.WriteLine($"Página {page.PageNumber}: {page.Lines.Count} linhas, {page.Words.Count} palavras");
    
    foreach (DocumentLine line in page.Lines)
    {
        Console.WriteLine($"  Linha: '{line.Content}'");
    }
}

// Extrair tabelas
foreach (DocumentTable table in result.Tables)
{
    Console.WriteLine($"Tabela: {table.RowCount} linhas x {table.ColumnCount} colunas");
    foreach (DocumentTableCell cell in table.Cells)
    {

…