Partilhar via


Introdução: Document Intelligence Studio

O Azure Document Intelligence no 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. Você pode começar explorando os modelos pré-treinados com amostras ou seus próprios documentos. Você também pode criar projetos para criar modelos de modelo personalizados e fazer referência aos modelos em seus aplicativos.

Pré-requisitos

Sugestão

Crie um recurso Microsoft Foundry se planeia aceder a várias ferramentas Foundry sob um único endpoint/chave. Apenas para acesso ao Document Intelligence, crie um recurso de Document Intelligence. Você precisa de um recurso de serviço único se pretende usar a autenticação do Microsoft Entra.

O Document Intelligence agora dá suporte à autenticação de token do Azure Ative Directory, além da autenticação local (baseada em chave) quando você acessa recursos e contas de armazenamento do Document Intelligence. Siga as instruções para configurar funções de acesso corretas, especialmente se seus recursos forem aplicados com a DisableLocalAuth política.

Há pré-requisitos adicionados para usar modelos personalizados no Document Intelligence Studio. Para obter orientação passo a passo, consulte Projetos personalizados do Document Intelligence Studio.

Políticas de autorização

Sua organização pode optar por desabilitar a autenticação local e impor a autenticação do Microsoft Entra (anteriormente Azure Ative Directory) para recursos de Document Intelligence e Armazenamento de Blob do Azure.

  • A autenticação do Microsoft Entra requer autorização baseada em chave para ser desativada. Depois que o acesso à chave é desabilitado, o Microsoft Entra ID é o único método de autorização disponível.
  • O Microsoft Entra permite conceder privilégios mínimos e controle granular para recursos do Azure.

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

Se a autenticação local (baseada em chave) estiver desabilitada para seu recurso de serviço de Inteligência de Documentos, certifique-se de obter a função Usuário dos Serviços Cognitivos e seu token do Azure Ative Directory para autenticar solicitações no Document Intelligence Studio. A função de Colaborador permite listar apenas chaves, mas não lhe dá permissão para usar o recurso quando o acesso à chave está desativado.

Designar atribuições de função

O acesso básico ao Document Intelligence Studio requer a função Usuário de Serviços Cognitivos . Para obter mais informações, consulte Atribuições de função do Document Intelligence.

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

    • Utilizador de Serviços Cognitivos: Precisa deste papel para que o recurso Document Intelligence ou Microsoft Foundry entre na página de análise.
    • Contribuidor: Precisa deste papel para criar um grupo de recursos, serviço de Inteligência Documental ou recurso Microsoft Foundry.
  • No contexto do Azure, a função de Colaborador pode executar ações apenas para controlar e gerenciar o próprio recurso, incluindo listar as chaves de acesso.

  • As contas de usuário com uma função de Colaborador podem acessar o serviço de Inteligência de Documentos somente chamando com chaves de acesso. Quando você configura o acesso com o Microsoft Entra ID, o acesso à chave é desabilitado e a função Usuário dos Serviços Cognitivos é necessária para que uma conta use os recursos.

Autenticação no Document Intelligence Studio

Vá para Document Intelligence Studio. Se for a primeira vez que inicia sessão, ser-lhe-á pedido para configurar o recurso de serviço. De acordo com a política da sua organização, você tem as seguintes opções:

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

    1. Selecione a sua subscrição existente.

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

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

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

  • Autenticação local: acesso por ponto de extremidade e chave da API

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

    2. Vá para a página de visão geral do seu recurso e, no painel esquerdo, selecione Chaves e Ponto de extremidade.

    3. Insira valores nos campos apropriados.

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

  • Depois de validar o cenário no Document Intelligence Studio, use as bibliotecas de cliente C#, Java, JavaScript ou Python ou a API REST para incorporar modelos de Document Intelligence em seus próprios aplicativos.

Experimente um modelo de Document Intelligence

Para saber mais sobre os modelos de Document Intelligence disponíveis, consulte Suporte a modelos de Document Intelligence.

  • Experimente os diferentes modelos que o Document Intelligence Studio tem para oferecer depois de configurar o recurso. Selecione qualquer modelo de Document Intelligence para usá-lo com uma abordagem sem código.
  • Teste qualquer uma das análises de documentos ou modelos pré-construídos. Selecione o modelo e use um dos documentos de exemplo ou carregue seu próprio documento para analisar. O resultado da análise aparece no painel à direita que mostra o código do resultado do conteúdo.
  • Treine os modelos personalizados em seus documentos. Para obter uma visão geral dos modelos personalizados, consulte Visão geral dos modelos personalizados.
  • Valide o cenário no Document Intelligence Studio. Em seguida, use as bibliotecas de cliente C#, Java, JavaScript ou Python ou a API REST para incorporar modelos de Document Intelligence em seus próprios aplicativos.

Ver detalhes do recurso

Para exibir detalhes do recurso, como nome e nível de preço, selecione o ícone Configurações no canto superior direito da home page do Document Intelligence Studio e selecione a guia Recurso . Se tiver acesso a outros recursos, também pode mudar de recursos.

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

Com o Document Intelligence, você pode automatizar rapidamente o processamento de dados em aplicativos e fluxos de trabalho, aprimorar facilmente estratégias orientadas por dados e enriquecer habilmente os recursos de pesquisa de documentos.

Gerenciar configurações que não sejam da Microsoft para acesso ao Document Intelligence Studio

Borda da Microsoft
  1. Vá para Configurações do Microsoft Edge.
  2. Pesquise por terceiros.
  3. Vá para Gerenciar e excluir cookies e dados do site.
  4. Desative a configuração de Bloquear cookies de terceiros.
Cromado
  1. Aceda a Definições do Chrome.
  2. Procurar Terceiros.
  3. Em Comportamento padrão, selecione Permitir cookies de terceiros.
Firefox
  1. Vá para Configurações do Firefox.
  2. Pesquise cookies.
  3. Em Proteção Avançada contra Rastreamento, selecione Gerenciar exceções.
  4. Adicione uma exceção ou https://documentintelligence.ai.azure.com a URL do Document Intelligence Studio do seu ambiente.
Safari
  1. SelecionePreferências>.
  2. Selecione Privacidade.
  3. Desmarque Bloquear todos os cookies.

Solução de problemas

Cenário Motivo Resolução
Você recebe a mensagem
Form Recognizer Not Found de erro quando abre um projeto personalizado.
Seu recurso de Document Intelligence, que está vinculado ao projeto personalizado, foi excluído ou movido para outro grupo de recursos. Há duas maneiras de resolver esse problema:
• Recrie o recurso Document Intelligence sob a mesma assinatura e grupo de recursos com o mesmo nome.
• Recrie um projeto personalizado com o recurso de Document Intelligence migrado e especifique a mesma conta de armazenamento.
Você recebe a mensagem
PermissionDenied de erro quando usa aplicativos pré-criados ou abre um projeto personalizado.
O 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 chave) esteja desabilitada para seu recurso de Document Intelligence e você não tenha permissão suficiente para acessar o recurso. Para configurar suas funções de acesso, consulte Atribuições de função do Azure.
Você recebe a mensagem
AuthorizationPermissionMismatch de erro quando abre um projeto personalizado.
A solicitação não está autorizada a executar a operação usando a permissão designada. É provável que a autenticação local (baseada em chave) esteja desativada para sua conta de armazenamento e você não tenha a permissão concedida para acessar os dados de blob. Para configurar suas funções de acesso, consulte Atribuições de função do Azure.
Não é possível 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 browser esteja a bloquear cookies que não sejam da Microsoft, pelo que não consegue iniciar sessão com êxito. Para resolver esse problema, consulte Gerenciar configurações que não sejam da Microsoft para seu navegador.