Introdução: Document Intelligence Studio

Azure Document Intelligence no Foundry Tools Studio é uma ferramenta online que você pode usar para explorar, entender e integrar visualmente recursos do serviço de Inteligência de Documento em seus aplicativos. Você pode começar explorando os modelos pré-treinados com exemplos ou seus próprios documentos. Você também pode criar projetos para criar modelos de modelo personalizados e referenciar os modelos em seus aplicativos.

Pré-requisitos

  • Uma assinatura Azure. Crie um gratuitamente.
  • Um recurso de Inteligência de Documento Azure. Depois de ter sua assinatura do Azure, crie um recurso de serviço único ou multisserviço do Azure no portal do Azure para obter sua chave e ponto de extremidade.
  • Para experimentar o serviço, use o tipo de preço gratuito (F0). Você pode atualizar mais tarde para uma camada paga para produção.

Dica

Crie um recurso Microsoft Foundry se você planeja acessar várias Ferramentas Foundry em um único endpoint/chave. Para acesso apenas ao Document Intelligence, crie um recurso do Document Intelligence. Você precisará de um recurso singular de serviço se pretende usar a autenticação do Microsoft Entra.

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

Há pré-requisitos adicionados para usar modelos personalizados no Document Intelligence Studio. Para obter diretrizes 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 Active Directory) para recursos do Document Intelligence e para o Armazenamento de Blobs do Azure.

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

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

Se a autenticação local (baseada em chave) estiver desabilitada para o recurso de serviço do Document Intelligence, obtenha a função de Usuário dos Serviços Cognitivos e seu token Microsoft Entra ID para autenticar solicitações no Document Intelligence Studio. A função Colaborador permite que você liste apenas chaves, mas não lhe dá permissão para usar o recurso quando o acesso à chave estiver desabilitado.

Designar atribuições de função

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

  • Verifique se você tem a função de Usuário dos Serviços Cognitivos e não a função de Colaborador dos Serviços Cognitivos ao configurar Microsoft Entra ID autenticação:

    • Usuário dos Serviços Cognitivos: você precisa dessa função para acessar a página de análise do recurso Inteligência de Documento ou Microsoft Foundry.
    • Contributor: você precisa dessa função para criar um grupo de recursos, um serviço Document Intelligence ou até mesmo um recurso Microsoft Foundry.
  • Em Azure contexto, a função Colaborador pode executar ações apenas para controlar e gerenciar o próprio recurso, incluindo a listagem das chaves de acesso.

  • As contas de usuário com uma função colaborador podem acessar o serviço da Informação de Documentos apenas chamando com chaves de acesso. Quando você configura o acesso com Microsoft Entra ID, o acesso à chave é desabilitado, e a função Usuário dos Serviços Cognitivos é exigida para que uma conta utilize os recursos.

Autenticação no Document Intelligence Studio

Vá para o Document Intelligence Studio. Se for a primeira vez que você entra, será solicitado que você configure seu recurso de serviço. De acordo com a política da sua organização, você tem as seguintes opções:

  • autenticação Microsoft Entra: acesso por recurso (recomendado)

    1. Selecione sua assinatura existente.

    2. Selecione um grupo de recursos existente em sua assinatura ou crie um novo.

    3. Selecione seu recurso existente do Document Intelligence 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 endpoint e chave de API

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

    2. Acesse a página de visão geral do recurso e, no painel esquerdo, selecione Chaves e Ponto de Extremidade.

    3. Insira valores nos campos apropriados.

      Captura de tela 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 o C#, Java, JavaScript ou Python bibliotecas de clientes ou a API REST para incorporar modelos do Document Intelligence em seus próprios aplicativos.

Experimentar um modelo do Document Intelligence

Para saber mais sobre os modelos disponíveis do Document Intelligence, consulte o suporte ao modelo do Document Intelligence.

  • Experimente os diferentes modelos que o Document Intelligence Studio tem a oferecer depois que você configurar seu recurso. Selecione qualquer modelo do Document Intelligence para usá-lo com uma abordagem sem código.
  • Teste qualquer um dos modelos predefinidos ou de análise de documento. 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 de resultado do conteúdo.
  • Treine os modelos personalizados em seus documentos. Para obter uma visão geral dos modelos personalizados, consulte a visão geral dos modelos personalizados.
  • Valide o cenário no Document Intelligence Studio. Em seguida, use o C#, Java, JavaScript ou Python bibliotecas de clientes ou a API REST para incorporar modelos do Document Intelligence em seus próprios aplicativos.

Exibir detalhes do recurso

Para exibir detalhes do recurso, como nome e tipo 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 você tiver acesso a outros recursos, também poderá alternar os recursos.

Captura de tela que mostra a guia Recurso da página Configurações.

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

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

Microsoft Edge
  1. Vá para Settings para Microsoft Edge.
  2. Pesquise terceiros.
  3. Vá para Gerenciar e excluir cookies e dados do site.
  4. Desative a configuração de Bloquear cookies de terceiros.
Chrome
  1. Vá para Configurações para Chrome.
  2. Pesquise 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 de Controle Avançado, selecione Gerenciar Exceções.
  4. Adicione uma exceção para https://documentintelligence.ai.azure.com ou para a URL do Document Intelligence Studio do seu ambiente.
Safari
  1. SelecionePreferências>.
  2. Selecione Privacidade.
  3. Limpar Bloquear todos os cookies.

Solucionando problemas

Cenário Causa Resolução
Você recebe a mensagem de erro
Reconhecimento de Formulários Not Found ao abrir um projeto personalizado.
Seu recurso de Inteligência de Documento, que está associado ao projeto personalizado, foi excluído ou movido para outro grupo de recursos. Há duas maneiras de resolver esse problema:
• Recriar o recurso do Document Intelligence na mesma assinatura e grupo de recursos com o mesmo nome.
• Crie novamente um projeto personalizado com o recurso migrado do Document Intelligence e especifique a mesma conta de armazenamento.
Você recebe a mensagem
PermissionDenied de erro quando usa aplicativos predefinidos ou abre um projeto personalizado.
A entidade de segurança não tem acesso à API ou à operação quando analisa em modelos predefinidos ou abre um projeto personalizado. É provável que a autenticação local (baseada em chave) esteja desabilitada para o recurso do Document Intelligence e você não tenha permissão suficiente para acessar o recurso. Para configurar suas funções de acesso, consulte Azure atribuições de função.
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 desabilitada 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 Azure atribuições de função.
Você não pode entrar 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 seu navegador esteja bloqueando cookies não Microsoft, portanto, você não pode entrar com êxito. Para resolver esse problema, consulte Configurações não Microsoft para seu navegador.