Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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:
- Desativar a autenticação local para Foundry Tools
- Impedir a autorização de Chave Partilhada para uma conta Armazenamento do Azure
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)
Autenticação local: Acesso por endpoint API e chave
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.
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
- Vai a Settings para Microsoft Edge.
- Procure por terceiros.
- Vá a Gerir e apague cookies e dados do site.
- Desligue a opção de Bloquear cookies de terceiros.
Chrome
- Vai às Definições do Chrome.
- Pesquisa por Terceiros.
- Em Comportamento Padrão, selecione Permitir cookies de terceiros.
Firefox
- Vai às Definições do Firefox.
- Procurar cookies.
- Em Proteção de Rastreamento Reforçada, selecione Gerir Exceções.
- Adicione uma exceção para
https://documentintelligence.ai.azure.comou a URL do Document Intelligence Studio do seu ambiente.
Safari
- Selecioneas Preferências>.
- Selecione Privacidade.
- 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 mensagemPermissionDenied 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 mensagemAuthorizationPermissionMismatch 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 mensagemInteractionRequiredAuthError: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. |