Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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
- Uma assinatura do Azure. Crie um gratuitamente.
- Um recurso Azure Document Intelligence. Depois de teres a tua subscrição Azure, cria um recurso Azure de serviço único ou um recurso multiserviço Azure no portal Azure para obter a tua chave e endpoint.
- Para experimentar o serviço, use o nível de preço gratuito (F0). Você pode atualizar posteriormente para uma camada paga para produção.
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:
- Desativar a autenticação local para Foundry Tools
- Impedir a autorização de Chave Partilhada para uma conta de Armazenamento do Azure
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)
Autenticação local: acesso por ponto de extremidade e chave da API
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.
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
- Vá para Configurações do Microsoft Edge.
- Pesquise por terceiros.
- Vá para Gerenciar e excluir cookies e dados do site.
- Desative a configuração de Bloquear cookies de terceiros.
Cromado
- Aceda a Definições do Chrome.
- Procurar Terceiros.
- Em Comportamento padrão, selecione Permitir cookies de terceiros.
Firefox
- Vá para Configurações do Firefox.
- Pesquise cookies.
- Em Proteção Avançada contra Rastreamento, selecione Gerenciar exceções.
- Adicione uma exceção ou
https://documentintelligence.ai.azure.coma URL do Document Intelligence Studio do seu ambiente.
Safari
- SelecionePreferências>.
- Selecione Privacidade.
- Desmarque Bloquear todos os cookies.
Solução de problemas
| Cenário | Motivo | Resolução |
|---|---|---|
Você recebe a mensagemForm 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 mensagemPermissionDenied 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 mensagemAuthorizationPermissionMismatch 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 mensagemInteractionRequiredAuthError: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. |