Usar o Entendimento de Conteúdo no Azure AI Foundry

O Azure AI Foundry é uma plataforma abrangente para desenvolver e implantar aplicativos e APIs de IA generativa de forma responsável. O Entendimento de Conteúdo do Azure AI é um novo Serviço de IA do Azure generativo que analisa arquivos de várias modalidades e extrai saída estruturada em um formato de campo definido pelo usuário. As fontes de entrada incluem dados de documentos, vídeos, imagens e áudio. Este guia mostra como criar e testar um analisador de Compreensão de Conteúdo no AI Foundry. Em seguida, você pode utilizar os dados extraídos em qualquer aplicativo ou processo criado usando uma simples chamada de API REST. Os analisadores de compreensão de conteúdo são totalmente personalizáveis. Você pode criar um analisador criando seu próprio esquema do zero ou usando um modelo de analisador sugerido oferecido para abordar cenários comuns em cada tipo de dados.

Pré-requisitos

Para começar, certifique-se de que tem os seguintes recursos e permissões:

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

• Um hub do Azure AI Foundry é necessário para gerenciar os recursos provisionados em seu projeto de Compreensão de Conteúdo e deve ser criado em uma das seguintes regiões com suporte: Westus, SwedenCentral ou AustraliaEast. Se você estiver criando um hub pela primeira vez, consulteComo criar e gerenciar um hub do Azure AI Foundry para saber mais. É importante observar que você precisa das permissões adequadas para criar um hub, ou seu administrador pode criar um para você.

  • Se sua função for Colaborador ou Proprietário, você poderá continuar com a criação de seu próprio hub.

  • Se sua função for Desenvolvedor de IA do Azure, o hub já deve ser criado antes que você possa concluir este início rápido. Sua função de usuário deve ser Desenvolvedor, Colaborador ou Proprietário do Azure AI no hub. Para obter mais informações, consulte hubs e funções do Azure AI.

Importante

Se sua organização exigir que você personalize a segurança dos recursos de armazenamento, o AI Foundry atualmente não expõe todos os recursos que podem ser configurados. Consulte as chaves de acesso à API de serviços de IA do Azure para criar recursos que atendam aos requisitos de suas organizações por meio do portal do Azure. A política imposta no Azure no escopo do hub se aplica a todos os projetos gerenciados sob ele. Para saber como utilizar chaves gerenciadas pelo cliente, consulte (Visualização) Armazenamento do lado do serviço de dados criptografados ao usar chaves gerenciadas pelo cliente. Volte aqui quando tiver recursos criados.

Crie seu primeiro projeto de Compreensão de Conteúdo no AI Foundry

Nota

O tipo de projeto Content Understanding é separado do tipo de projeto Generative AI, também disponível no AI Foundry.

Para experimentar o serviço de Compreensão de Conteúdo no AI Foundry, você precisa criar um projeto de Compreensão de Conteúdo. Você pode acessar o Entendimento de Conteúdo em:

• A página inicial do AI Foundry

• A página inicial dos Serviços de IA

Na página Compreensão de conteúdo, selecione Create a new Content Understanding Project:

Siga as etapas no assistente de criação de projeto e comece selecionando o hub que você já criou. Quando o hub foi criado, ele deve provisionar um recurso de Serviços de IA e um contêiner de armazenamento de blob que são selecionados por padrão. Como alternativa, você pode criar um usando o assistente ou o portal do Azure. O diagrama a seguir ilustra o papel dos hubs, recursos e projetos no AI Foundry.

Depois de concluir as etapas de configuração, selecione Create project.

Compartilhando seu projeto de compreensão de conteúdo

Para compartilhar e gerenciar o acesso ao projeto de Compreensão de Conteúdo que você criou, navegue até o Centro de Gerenciamento, localizado na parte inferior da navegação do seu projeto:

Você pode gerenciar os usuários e suas funções individuais aqui:

Crie seu primeiro analisador

Agora que tudo está configurado para começar, podemos explicar, passo a passo, como construir seu primeiro analisador, começando com a construção do esquema. O esquema é a estrutura personalizável que permite ao analisador extrair insights de seus dados. Neste exemplo, o esquema é criado para extrair dados de chave de um documento de fatura, mas você pode trazer qualquer tipo de dados e as etapas permanecem as mesmas. Para obter uma lista completa dos tipos de arquivo suportados, consulte limites de arquivos de entrada.

1. Carregue um arquivo de exemplo de um documento de fatura ou quaisquer outros dados relevantes para o seu cenário.

   

2. Em seguida, o serviço de Compreensão de Conteúdo sugere modelos de analisador com base no seu tipo de conteúdo. Confira os modelos do Analyzer oferecidos com o Content Understanding para obter uma lista completa de todos os modelos oferecidos para cada modalidade. Para este exemplo, selecione Análise de documentos para criar seu próprio esquema adaptado ao cenário de fatura. Ao usar seus próprios dados, selecione o modelo de analisador que melhor atende às suas necessidades ou crie o seu próprio. Consulte Modelos de analisador para obter uma lista completa dos modelos disponíveis.

3. Selecione Criar.

   

4. Adicione campos ao seu esquema:

   • Especifique nomes de campo claros e simples. Alguns campos de exemplo podem incluir vendorName, items, price.

   • Indique o tipo de valor para cada campo (strings, datas, números, listas, grupos). Para saber mais, consulteTipos de campo suportados.

   • [Opcional] Forneça descrições de campo para explicar o comportamento desejado, incluindo quaisquer exceções ou regras.

   • Especifique o método para gerar o valor para cada campo.

5. Selecione Guardar.

   

6. Com o esquema concluído, o Entendimento de Conteúdo agora gera a saída em seus dados de exemplo. Nesta etapa, você pode adicionar mais dados para testar a precisão do analisador ou fazer alterações no esquema, se necessário.

   

7. Quando estiver satisfeito com a qualidade da sua saída, selecione Compilar analisador. Essa ação cria um ID de analisador que você pode integrar em seus próprios aplicativos, permitindo que você chame o analisador a partir do seu código.

   

Agora você criou com sucesso seu primeiro analisador de Compreensão de Conteúdo e está pronto para começar a extrair insights de seus dados. Confira Guia de início rápido: Azure AI Content Understanding REST APIs para utilizar a API REST para chamar seu analisador.

Próximos passos

• Neste início rápido, você aprendeu como criar um analisador de Compreensão de Conteúdo usando o Azure AI Foundry. Para usar a API REST de Compreensão de Conteúdo, consulte o Guia de início rápido da API REST.