Prepare-se para usar a API de Compreensão de Conteúdos por IA

  • 5 minutos

Sugestão

Consulte a guia Texto e imagens para obter mais detalhes!

Antes de poder usar a API Azure Content Understanding, precisa de um recurso Microsoft Foundry na sua subscrição Azure. Você pode provisionar esse recurso das seguintes maneiras:

  • Crie um recurso Microsoft Foundry no portal Azure.
  • Crie um projeto Microsoft Foundry , que inclua um recurso Microsoft Foundry por defeito.

Sugestão

Criar um projeto Microsoft Foundry permite-lhe usar ferramentas visuais para criar e gerir Azure Content Understanding esquemas e analisadores.

Depois de provisionar um recurso Microsoft Foundry, precisa das seguintes informações para se ligar à API Azure Content Understanding a partir de uma aplicação cliente:

  • O recurso Microsoft Foundry endpoint
  • Uma das chaves de API associadas ao endpoint.

Você pode obter esses valores no portal do Azure, conforme mostrado na imagem a seguir:

Captura de ecrã das definições do Microsoft Foundry no portal Azure.

Se estiver a trabalhar num projeto Microsoft Foundry, pode encontrar o endpoint e a chave para o recurso Foundry associado na página inicial do portal do projeto Foundry.

Ao trabalhar num projeto Microsoft Foundry, também pode escrever código que utilize o Microsoft Foundry SDK para se ligar ao projeto usando a autenticação Microsoft Entra ID e recuperar os detalhes de ligação do recurso Microsoft Foundry.

Instalação do SDK Python

Para usar o SDK Python para Compreensão de Conteúdo, instale o azure-ai-contentunderstanding pacote:

pip install azure-ai-contentunderstanding

Observação

O SDK de Python requer Python 3.9 ou posterior. Também pode usar a API REST diretamente a partir de qualquer linguagem que suporte pedidos HTTP.

Importante

Antes de usar a API de Compreensão de Conteúdo, deve configurar implementações de modelos padrão para o seu recurso Microsoft Foundry. A compreensão de conteúdos requer GPT-4.1, GPT-4.1-mini, e text-embedding-3-large implementações de modelos. Pode configurá-los no portal Azure ou usando a API. Para mais informações, veja Configurar implementações de modelos.

Sugestão

Para saber mais sobre programação com o Microsoft Foundry SDK, complete o módulo Develop an AI app with the Microsoft Foundry SDK.