Preparar-se para usar a API de Compreensão de Conteúdo de IA
Dica
Consulte a guia Texto e imagens para obter mais detalhes!
Antes de usar a API de Compreensão de Conteúdo do Azure, você precisa de um recurso do Microsoft Foundry em sua assinatura do Azure. Você pode provisionar esse recurso das seguintes maneiras:
- Crie um recurso do Microsoft Foundry no portal do Azure.
- Crie um projeto do Microsoft Foundry , que inclui um recurso do Microsoft Foundry por padrão.
Dica
A criação de um projeto do Microsoft Foundry permite que você use ferramentas visuais para criar e gerenciar esquemas e analisadores do Azure Content Understanding.
Depois de provisionar um recurso do Microsoft Foundry, você precisará das seguintes informações para se conectar à API de Reconhecimento de Conteúdo do Azure de um aplicativo cliente:
- O endpoint do recurso Microsoft Foundry
- Uma das chaves de API associadas ao endpoint.
Você pode obter esses valores no portal do Azure, conforme mostrado na imagem a seguir:
Se você estiver trabalhando em um projeto do Microsoft Foundry, poderá encontrar o endpoint e a chave do recurso Foundry associado na página inicial do projeto no portal do Foundry.
Ao trabalhar em um projeto do Microsoft Foundry, você também pode escrever um código que usa o SDK do Microsoft Foundry para se conectar ao projeto usando a autenticação da ID do Microsoft Entra e recuperar os detalhes da conexão para o recurso Microsoft Foundry.
Instalando o SDK do Python
Para usar o SDK do Python para o Content Understanding, instale o azure-ai-contentunderstanding pacote:
pip install azure-ai-contentunderstanding
Observação
O SDK do Python requer Python 3.9 ou posterior. Você também pode usar a API REST diretamente de qualquer idioma que dê suporte a solicitações HTTP.
Importante
Antes de usar a API de Compreensão de Conteúdo, você deve configurar implantações de modelo padrão para o recurso Microsoft Foundry. A compreensão de conteúdo requer implantações de modelo de GPT-4.1, de GPT-4.1-mini e de text-embedding-3-large. Você pode configurá-las no portal do Azure ou usando a API. Para obter mais informações, consulte Configurar implantações de modelo.
Dica
Para saber mais sobre programação com o SDK do Microsoft Foundry, conclua o aplicativo Desenvolver uma IA com o módulo SDK do Microsoft Foundry .