Criar tarefas padrão e pro de compreensão de conteúdo no portal do Microsoft Foundry (clássico) (versão prévia)

Importante

Versões prévias da API 2024-12-01-preview e 2025-05-01-preview serão desativadas até 15 de julho de 2026. Se você ainda estiver usando uma API de visualização, atualize seu código para direcionar a versão 2025-11-01 (GA)mais recente da API.

As versões das APIs 2024-12-01-preview e 2025-05-01-preview estão em prévia pública. Essas visualizações são fornecidas sem um acordo de nível de serviço e não são recomendadas para cargas de trabalho de produção. Para obter mais informações, consulte Termos Suplementares de Uso para Microsoft Azure Previews e o Adendo de Proteção de Dados para Produtos e Serviços da Microsoft ("DPA").

Suponha que você tenha arquivos de tipos diferentes, como documentos, imagens, áudio ou vídeo, e queira extrair automaticamente informações de chave deles. Com o Content Understanding, você pode criar uma tarefa para organizar o processamento de dados, definir um esquema de campo que especifica as informações a serem extraídas ou geradas e, em seguida, criar um analisador. O analisador se torna um endpoint de API que você pode integrar em seus aplicativos ou fluxos de trabalho.

Este guia mostra como usar os modos Standard e Pro do Content Understanding no portal do Microsoft Foundry (clássico) para criar e testar um analisador personalizado que extrai informações estruturadas de seus dados.

Nota

O portal do Foundry (clássico) usa uma API de visualização (2025-05-01-preview).

Escolhendo entre os modos Standard e Pro (versão prévia)

O Content Understanding oferece dois modos para cenários diferentes:

  • Modo padrão – ideal para processar arquivos únicos com extração de campo simples. Use o modo padrão quando precisar extrair dados estruturados de documentos individuais, imagens, áudio ou arquivos de vídeo sem análise entre arquivos ou requisitos de raciocínio complexos.

  • Modo pro – projetado para cenários avançados que exigem raciocínio de várias etapas e análise entre arquivos. Use o modo pro quando precisar:

    • Processar vários arquivos de entrada em uma única solicitação
    • Aplicar o raciocínio em documentos diferentes para validar, enriquecer ou agregar dados
    • Usar dados de referência (base de dados de conhecimento) para orientar a extração e a validação
    • Executar uma análise complexa de várias etapas que vai além da extração de campo simples

Para obter diretrizes detalhadas sobre qual modo escolher para seu cenário, consulte Modos padrão e pro do Azure Content Understanding (prévia).

Nota

O modo pro é um recurso de visualização disponível somente nesta versão prévia da API (2025-05-01-preview). Para o modo Standard, você pode fazer a transição para a API ga (2025-11-01) com alterações mínimas. Consulte o guia de migração de GA.

Pré-requisitos

Para começar, verifique se você tem os seguintes recursos e permissões:

  • Uma assinatura Azure. Se você não tiver uma assinatura Azure, criar uma conta gratuita.
  • Um projeto Foundry em uma região suportada. Para obter uma lista completa de regiões com suporte, confira o suporte a idiomas e regiões. Confira as instruções abaixo para saber como criar seu primeiro projeto.

Criar seu primeiro projeto

Para começar a entender o conteúdo no portal do Foundry, siga estas etapas para criar um projeto. Um projeto permite organizar seu trabalho e salvar o estado atual durante a criação de aplicativos de IA personalizados. Todo o trabalho com o Content Understanding acontece em um projeto.

  1. Na home page do portal do Foundry, selecione Criar novo no canto superior direito.

  2. A Foundry dá suporte a dois tipos de projeto: Foundry resource e AI hub resource. Ambos os tipos de projeto funcionam com o Content Understanding. Para uma experiência mais atualizada, use o Foundry resource. Para obter mais contexto sobre os tipos de projeto, consulte Criar um projeto para o Foundry.

    • Se você estiver criando um projeto do Foundry, selecione Advanced options e escolha uma região com suporte.

    • Se você estiver criando um projeto baseado em hub, selecione ou crie um hub para continuar. Verifique se o hub está em uma região com suporte. Se você não tiver um hub ou se seu hub não estiver em uma região com suporte, selecione a opção no topo da lista suspensa para criar um novo hub e preencher as informações necessárias.

Crie sua tarefa de arquivo único utilizando o modo Padrão de Compreensão de Conteúdo

Siga estas etapas para criar uma tarefa personalizada na Foundry. Use essa tarefa para criar seu primeiro analisador.

  1. Vá para a página inicial do Foundry.
  2. Selecione seu projeto. Talvez seja necessário selecionar Exibir todos os recursos para ver seu projeto.
  3. Selecione Compreensão de Conteúdo no painel de navegação esquerdo.
  4. Selecione + Criar.
  5. Selecione para criar um Single-file task que use o modo Padrão de Compreensão de Conteúdo. Para obter mais informações sobre qual modo é o ideal para seu cenário, confira Azure Content Understanding in Foundry Tools pro e modos padrão (versão prévia).
  6. Insira um nome para sua tarefa. Opcionalmente, insira uma descrição e altere outras configurações.
  7. Selecione Criar.

Criar seu primeiro analisador

Agora que tudo está configurado, você pode criar seu primeiro analisador.

Ao criar uma tarefa de Compreensão de Conteúdo de arquivo único, você começa carregando um exemplo de seus dados e criando seu esquema de campo. O esquema é a estrutura personalizável que permite ao analisador extrair insights de seus dados. Neste exemplo, você cria o esquema para extrair dados de chave de um documento de fatura, mas pode trazer qualquer tipo de dados e as etapas permanecem as mesmas. Para obter uma lista completa de tipos de arquivo com suporte, consulte os limites de arquivo de entrada.

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

    Captura de tela da etapa de upload na experiência do usuá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 Analisador 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 documento para criar seu próprio esquema adaptado ao cenário da fatura. Ao usar seus próprios dados, selecione o modelo do analisador que melhor atenda às suas necessidades ou crie o seu próprio. Consulte modelos do Analisador para obter uma lista completa de modelos disponíveis.

  3. Selecione Criar.

    Captura de tela dos modelos do analisador.

  4. Em seguida, adicione campos ao esquema para refletir todas as saídas que você deseja gerar.

    • Especifique nomes de campo claros e simples. Alguns campos de exemplo podem incluir vendorName, itens, preço.

    • Indique o tipo de valor para cada campo (cadeias de caracteres, datas, números, listas, grupos). Para saber mais, confiraos tipos de campo com suporte.

    • [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.

      Para obter as práticas recomendadas sobre como definir o esquema de campo, consulte as práticas recomendadas para o Content Understanding. Pode levar alguns minutos para compilar seu esquema.

  5. Quando o esquema estiver pronto para teste, selecione Salvar. Você sempre pode voltar e fazer alterações, se necessário.

    Captura de tela do esquema concluído.

  6. Com o esquema concluído, o Content Understanding 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.

    Captura de tela da etapa de teste de esquema.

  7. Quando estiver satisfeito com a qualidade do resultado, selecione Build Analyzer. Essa ação cria uma ID do analisador que você pode integrar em seus próprios aplicativos, permitindo que você chame o analisador do seu código.

    Captura de tela do analisador criado.

Você criou com êxito seu primeiro analisador de Compreensão de Conteúdo e está pronto para começar a extrair insights de seus dados. Confira Início Rápido: APIs REST de entendimento de conteúdo para chamar seu analisador utilizando a API REST.

Compartilhando seu projeto

Para compartilhar o projeto criado e gerenciar o acesso, acesse o Centro de Gerenciamento. Você pode encontrá-lo na parte inferior do painel de navegação do seu projeto:

Captura de tela de onde encontrar o centro de gerenciamento.

No Centro de Gerenciamento, você pode gerenciar usuários e atribuir funções individuais:

Captura de tela da seção de usuários do projeto do centro de gerenciamento.

Próximas etapas

  • Last updated on