Criar tarefas de compreensão do conteúdo "Standard" e "Pro" no portal Microsoft Foundry (clássico) (Prévia)

Importante

Versões de API em pré-visualização 2024-12-01-preview e 2025-05-01-preview serão descontinuadas até 15 de julho de 2026. Se ainda estiveres a usar uma API de pré-visualização, atualiza o teu código para direcionar a versão mais recente da API 2025-11-01 (GA).

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

Suponha que tem ficheiros de diferentes tipos — como documentos, imagens, áudio ou vídeo — e quer extrair automaticamente informações chave deles. Com o Content Understanding, pode criar uma tarefa para organizar o processamento dos seus dados, definir um esquema de campo que especifica a informação a extrair ou gerar, e depois construir um analisador. O analisador torna-se um endpoint API que pode integrar nas suas aplicações ou fluxos de trabalho.

Este guia mostra-lhe como usar os modos Compreensão de Conteúdo Standard e Pro no portal Microsoft Foundry (clássico) para construir e testar um analisador personalizado que extrai informação estruturada dos seus dados.

Nota

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

Escolher entre os modos Standard e Pro (Pré-visualização)

A Compreensão de Conteúdo oferece dois modos para diferentes cenários:

  • Modo padrão - Ideal para processar ficheiros individuais com extração simples de campos. Use o modo padrão quando precisar de extrair dados estruturados de documentos individuais, imagens, ficheiros de áudio ou vídeo sem necessidade de análise cruzada ou raciocínio complexo.

  • Modo Pro - Concebido para cenários avançados que requerem raciocínio em múltiplos passos e análise entre ficheiros. Usa o modo pro quando precisares:

    • Processar múltiplos ficheiros de entrada num único pedido
    • Aplicar raciocínio em diferentes documentos para validar, enriquecer ou agregar dados
    • Use dados de referência (base de conhecimento) para orientar a extração e validação
    • Realizar análises complexas em múltiplos passos que vão além da simples extração de campo

Para orientações detalhadas sobre qual modo escolher para o seu cenário, consulte Azure Content Understanding standard and pro modes (pré-visualização).

Nota

O modo Pro é uma funcionalidade de pré-visualização disponível apenas nesta versão da API de pré-visualização (2025-05-01-preview). Para o modo Standard, podes fazer a transição para a GA API (2025-11-01) com alterações mínimas. Consulte o guia de migração da GA.

Pré-requisitos

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

  • Uma subscrição do Azure. Se não tiver uma subscrição Azure, crie uma conta gratuita.
  • Um projeto de fundição numa região suportada. Para uma lista completa das regiões suportadas, consulte o apoio por línguas e regiãos. Consulte as instruções abaixo para aprender como criar o seu primeiro projeto.

Crie o seu primeiro projeto

Para começar com a Compreensão de Conteúdos no portal Foundry, siga estes passos para criar um projeto. Um projeto permite-lhe organizar o seu trabalho e guardar o estado enquanto constrói aplicações de IA personalizadas. Todo o trabalho com Compreensão de Conteúdo acontece num projeto.

  1. Na página inicial do portal Foundry, selecione Criar novo no canto superior direito.

  2. O Foundry suporta dois tipos de projetos: Foundry resource e AI hub resource. Ambos os tipos de projeto funcionam com Compreensão de Conteúdos. Para a experiência mais atualizada, use o Foundry resource. Para mais contexto sobre os tipos de projeto, consulte Criar um projeto para a Foundry.

    • Se estiver a criar um projeto Foundry, selecione Advanced options e escolha uma região suportada.

    • Se estiver a criar um projeto baseado em hubs, selecione ou crie um hub para avançar. Certifique-se de que o hub está numa região suportada. Se não tiver um hub ou o seu hub não estiver numa região suportada, selecione a opção no topo do menu suspenso para criar um novo hub e preencher as entradas necessárias.

Crie a sua tarefa em ficheiro único alimentada pelo modo Padrão de Compreensão de Conteúdo

Siga estes passos para criar uma tarefa personalizada na Foundry. Use esta tarefa para construir o seu primeiro analisador.

  1. Vá à página inicial do Foundry.
  2. Selecione o seu projeto. Pode precisar de selecionar Ver todos os recursos para ver o seu projeto.
  3. Selecione Compreensão de Conteúdo no painel de navegação esquerdo.
  4. Selecionar + Criar.
  5. Selecione para criar um Single-file task que use o modo Padrão de Compreensão de Conteúdo. Para mais informações sobre qual o modo certo para o seu cenário, consulte Azure Content Understanding no Foundry Tools pro e os modos standard (pré-visualização).
  6. Introduza um nome para a sua tarefa. Opcionalmente, introduza uma descrição e altere outras definições.
  7. Selecione Criar.

Crie o seu primeiro analisador

Agora que está tudo configurado, podes construir o teu primeiro analisador.

Quando cria uma tarefa de Compreensão de Conteúdo num único ficheiro, começa por carregar uma amostra dos seus dados e construir o seu esquema de campo. O esquema é a estrutura personalizável que permite ao analisador extrair insights dos seus dados. Neste exemplo, cria o esquema para extrair dados-chave de um documento de fatura, mas pode trazer qualquer tipo de dados e os passos mantêm-se os mesmos. Para uma lista completa dos tipos de ficheiros suportados, veja limites de ficheiros de entrada.

  1. Carrega um ficheiro exemplo de um documento de fatura ou qualquer outro dado relevante para o teu cenário.

    Captura de ecrã do passo de upload na experiência do utilizador.

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

  3. Selecione Criar.

    Captura de ecrã dos modelos de analisadores.

  4. De seguida, adiciona campos ao teu esquema para refletir todas as saídas que queres gerar.

    • Especifique nomes de campos claros e simples. Alguns campos de exemplo podem incluir Nome do Vendedor, itens, preço.

    • Indique o tipo de valor para cada campo (cadeias, datas, números, listas, grupos). Para saber mais, consulteos tipos de campos suportados.

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

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

      Para melhores práticas sobre como definir o esquema do seu campo, consulte as melhores práticas para Compreensão de Conteúdo. Pode demorar alguns minutos a construir o seu esquema.

  5. Quando o seu esquema estiver pronto para testar, selecione Guardar. Podes sempre voltar e fazer alterações se for preciso.

    Captura de ecrã do esquema concluído.

  6. Com o esquema concluído, o Content Understanding agora gera a saída a partir dos seus dados de exemplo. Neste passo, pode adicionar mais dados para testar a precisão do analisador ou fazer alterações ao esquema, se necessário.

    Captura de ecrã do passo de teste de esquema.

  7. Quando estiver satisfeito com a qualidade do seu resultado, selecione Build analyzer. Esta ação cria um ID de analisador que pode integrar nas suas próprias aplicações, permitindo-lhe chamar o analisador a partir do seu código.

    Captura de ecrã do analisador integrado.

Construiu com sucesso o seu primeiro analisador de Compreensão de Conteúdo e está pronto para começar a extrair insights dos seus dados. Consulte o Guia de Início Rápido: APIs REST para Compreensão de Conteúdo para chamar o seu analisador usando a API REST.

Partilhar o seu projeto

Para partilhar o projeto que criou e gerir o acesso, vá ao Centro de Gestão. Podes encontrá-lo no fundo do painel de navegação do teu projeto:

Captura de ecrã de onde encontrar o centro de gestão.

No Centro de Gestão, pode gerir utilizadores e atribuir funções individuais:

Captura de ecrã da secção de utilizadores do projeto no centro de gestão.

Próximos passos

  • Last updated on