Comece: Estúdio de Inteligência Documental

Azure Document Intelligence in Foundry Tools Studio é uma ferramenta online que pode usar para explorar visualmente, compreender e integrar funcionalidades do serviço de Inteligência de Documentos nas suas aplicações. Pode começar por explorar os modelos pré-treinados usando exemplos ou os seus próprios documentos. Também pode criar projetos para construir modelos personalizados e referenciar os modelos nas suas aplicações.

Pré-requisitos

  • Uma subscrição do Azure. Crie um gratuitamente.
  • Um recurso Azure Document Intelligence. Depois de teres a tua subscrição Azure, cria um recurso single-service ou multiservice Azure no portal Azure para obter a tua chave e endpoint.
  • Para experimentar o serviço, utilize o escalão de preços gratuito (F0). Podes fazer upgrade mais tarde para um tier pago para produção.

Dica

Crie um recurso Microsoft Foundry se planeia aceder a várias Foundry Tools num único endpoint/chave. Para acesso apenas à Inteligência Documental, crie um recurso de Inteligência Documental. Precisa de um recurso de serviço único se pretende usar autenticação Microsoft Entra.

O Document Intelligence suporta agora autenticação por token Microsoft Entra ID, além da autenticação local (baseada em chaves) quando acede a recursos e contas de armazenamento Document Intelligence. Siga as instruções para configurar as funções de acesso corretas, especialmente caso a política DisableLocalAuth seja aplicada aos seus recursos.

Existem pré-requisitos adicionais para usar modelos personalizados no Document Intelligence Studio. Para orientações passo a passo, consulte projetos personalizados do Document Intelligence Studio.

Políticas de autorização

A sua organização pode optar por desativar a autenticação local e impor a autenticação Microsoft Entra (anteriormente Azure Active Directory) para recursos de Document Intelligence e Armazenamento de Blobs do Azure.

  • A autenticação Microsoft Entra requer a autorização baseada em chave para ser desativada. Após o acesso às chaves ser desativado, o Microsoft Entra ID é o único método de autorização disponível.
  • O Microsoft Entra permite conceder privilégios mínimos e controlo granular para recursos do Azure.

Para mais informações, consulte as seguintes orientações:

Se a autenticação local (baseada em chaves) estiver desativada para o seu recurso de serviço de Inteligência Documental, certifique-se de obter o papel de Utilizador de Serviços Cognitivos e o seu token Microsoft Entra ID para autenticar pedidos no Document Intelligence Studio. O papel de Contribuinte permite listar apenas chaves, mas não lhe dá permissão para usar o recurso quando o acesso às chaves está desativado.

Designar atribuições de funções

O acesso básico do Document Intelligence Studio requer o papel de Utilizador de Serviços Cognitivos . Para mais informações, consulte atribuições de funções em Inteligência Documental.

  • Certifique-se de que tem o papel de Utilizador de Serviços Cognitivos e não o de Contribuidor de Serviços Cognitivos quando configurar a autenticação Microsoft Entra ID:

    • Utilizador de Serviços Cognitivos: Precisa deste papel para o recurso de Inteligência de Documentos ou Microsoft Foundry para entrar na página de análise.
    • Contribuidor: É necessário o este papel para criar um grupo de recursos, um serviço de Inteligência de Documentos ou um recurso Microsoft Foundry.
  • No contexto do Azure, o papel de Contribuinte só pode realizar ações para controlar e gerir o próprio recurso, incluindo a listagem das chaves de acesso.

  • Contas de utilizador com um papel de Contribuinte só podem aceder ao serviço de Inteligência de Documentos ligando com chaves de acesso. Quando configuras o acesso com o Microsoft Entra ID, o acesso à chave fica desativado e o papel de Utilizador de Serviços Cognitivos é obrigatório para que uma conta possa usar os recursos.

Autenticação no Document Intelligence Studio

Vai ao Estúdio de Inteligência Documental. Se for a sua primeira vez a iniciar sessão, é solicitado a configurar o seu recurso de serviço. De acordo com a política da sua organização, tem as seguintes opções:

  • Autenticação Microsoft Entra: Acesso por recurso (recomendado)

    1. Selecione a sua subscrição existente.

    2. Selecione um grupo de recursos existente dentro da sua subscrição ou crie um novo.

    3. Selecione o seu recurso atual de Inteligência Documental ou Microsoft Foundry.

      Captura de ecrã que mostra a configuração de um recurso de serviço no Document Intelligence Studio.

  • Autenticação local: Acesso por endpoint API e chave

    1. Recupere o seu endpoint e a chave do portal Azure.

    2. Vai à página de visão geral do teu recurso e, no painel esquerdo, seleciona Keys e Endpoint.

    3. Introduza valores nos campos apropriados.

      Captura de ecrã que mostra a página de Chaves e Endpoint no portal Azure.

  • Depois de validar o cenário no Document Intelligence Studio, utilize as bibliotecas clientes C#, Java, JavaScript, ou Python ou a API REST para incorporar modelos de Document Intelligence nas suas próprias aplicações.

Experimente um modelo de Inteligência Documental

Para saber mais sobre os modelos de Inteligência de Documentos disponíveis, consulte o suporte ao modelo de Inteligência de Documentos.

  • Experimente os diferentes modelos que o Document Intelligence Studio oferece depois de configurar o seu recurso. Selecione qualquer modelo de Inteligência de Documentos para o usar com uma abordagem sem código.
  • Teste qualquer análise de documentos ou modelos pré-construídos. Selecione o modelo e use um dos documentos de exemplo ou carregue o seu próprio documento para analisar. O resultado da análise aparece no painel à direita que mostra o código do conteúdo-resultado.
  • Treina os modelos personalizados nos teus documentos. Para uma visão geral dos modelos personalizados, consulte Visão geral dos modelos personalizados.
  • Valide o cenário no Document Intelligence Studio. Depois usa as bibliotecas clientes C#, Java, JavaScript, ou Python ou a API REST para incorporar modelos de Inteligência de Documentos nas tuas próprias aplicações.

Ver detalhes de recursos

Para visualizar detalhes de recursos, como nome e nível de preços, selecione o ícone de Definições no canto superior direito da página inicial do Document Intelligence Studio e depois selecione o separador Recursos . Se tiveres acesso a outros recursos, também podes trocar de recursos.

Captura de ecrã que mostra o separador de Recursos da página de Definições.

Com a Inteligência de Documentos, pode automatizar rapidamente o processamento de dados em aplicações e fluxos de trabalho, melhorar facilmente estratégias baseadas em dados e enriquecer habilmente as capacidades de pesquisa de documentos.

Gerir definições não-Microsoft para acesso ao Document Intelligence Studio

Microsoft Edge
  1. Vai a Settings para Microsoft Edge.
  2. Procure por terceiros.
  3. Vá a Gerir e apague cookies e dados do site.
  4. Desligue a opção de Bloquear cookies de terceiros.
Chrome
  1. Vai às Definições do Chrome.
  2. Pesquisa por Terceiros.
  3. Em Comportamento Padrão, selecione Permitir cookies de terceiros.
Firefox
  1. Vai às Definições do Firefox.
  2. Procurar cookies.
  3. Em Proteção de Rastreamento Reforçada, selecione Gerir Exceções.
  4. Adicione uma exceção para https://documentintelligence.ai.azure.com ou a URL do Document Intelligence Studio do seu ambiente.
Safari
  1. Selecioneas Preferências>.
  2. Selecione Privacidade.
  3. Limpar Bloquear todos os cookies.

Resolução de problemas

Cenário Causa Resolução
Recebes a mensagem de erro
Reconhecedor de Formulários Not Found quando abres um projeto personalizado.
O seu recurso de Inteligência Documental, que está associado ao projeto personalizado, foi eliminado ou movido para outro grupo de recursos. Existem duas formas de resolver este problema:
• Recriar o recurso de Inteligência Documental sob a mesma subscrição e grupo de recursos com o mesmo nome.
• Recriar um projeto personalizado com o recurso de Inteligência de Documentos migrado e especificar a mesma conta de armazenamento.
Recebes a mensagem
PermissionDenied de erro quando usas aplicações pré-construídas ou abres um projeto personalizado.
A entidade principal não tem acesso à API ou operação quando analisa modelos pré-construídos ou abre um projeto personalizado. É provável que a autenticação local (baseada em chaves) esteja desativada para o seu recurso de Inteligência Documental e que não tenha permissão suficiente para aceder ao recurso. Para configurar as suas funções de acesso, veja Atribuições de função do Azure.
Recebes a mensagem
AuthorizationPermissionMismatch de erro quando abres um projeto personalizado.
O pedido não está autorizado a realizar a operação usando a permissão designada. É provável que a autenticação local (baseada em chaves) esteja desativada para a sua conta de armazenamento e que não tenha a permissão concedida para aceder aos dados do blob. Para configurar as suas funções de acesso, veja Atribuições de função do Azure.
Não pode iniciar sessão no Document Intelligence Studio e receber a mensagem
InteractionRequiredAuthError:login_required:AADSTS50058:A silent sign-request was sent but no user is signed in de erro.
É provável que o seu navegador esteja a bloquear cookies que não sejam da Microsoft, por isso não consegue iniciar sessão com sucesso. Para resolver este problema, veja Gerir definições não-Microsoft para o seu navegador.