Gerenciar enriquecimentos
Aplique enriquecimentos em campos em seus documentos para tornar as informações significativas mais fáceis de encontrar e retornar em pesquisas.
Você geralmente aplica enriquecimentos em campos no momento em que você cria o enriquecimento. No entanto, você pode aplicar enriquecimentos em campos depois. Você pode desejar aplicar um enriquecimento existente em um novo campo personalizado que você cria usando a ferramenta SDU, por exemplo. Você pode remover enriquecimentos que você aplicou em campos também.
Para obter mais informações sobre os enriquecimentos disponíveis, consulte os tópicos a seguir:
Para aplicar enriquecimentos a um projeto do Content Mining, você deve usar o aplicativo Content Mining em vez de usar a interface com o usuário do Discovery. Ao usar o aplicativo Content Mining, ele assegura que os enriquecimentos sejam aceitos no projeto Content Mining. Para obter mais informações sobre como aplicar enriquecimentos, como uma impressão de dicionário ou frase em um projeto de Mineração de Conteúdo, consulte Enriquecer sua coleção.
Para gerenciar os enriquecimentos, conclua as etapas a seguir:
-
A partir da pane de navegação, abra a página Gerenciar coleções e, em seguida, clique em uma coleção para abri-la.
-
Clique na guia Enriquecimentos.
É exibida uma lista de enriquecimentos disponíveis.
Você pode identificar enriquecimentos embutidos porque eles são categorizados como tipo
System. A lista também inclui quaisquer enriquecimentos personalizados que foram criados em qualquer um dos projetos em sua instância de serviço. -
Encontre o enriquecimento que você deseja aplicar ou remover.
-
Clique no twistie no campo associado para expandir uma lista de campos.
-
Execute um dos procedimentos a seguir:
-
Para aplicar um enriquecimento em documentos, selecione o campo ou os campos que deseja enriquecer. Você pode aplicar enriquecimentos aos campos
textehtml, e a campos personalizados que foram adicionados a partir de arquivos JSON ou CSV carregados ou a partir da ferramenta Smart Document Understanding (SDU).Se o campo que você escolher vem de um arquivo JSON, depois de aplicar o enriquecimento, o tipo de dados de campo é convertido em uma matriz. O campo é convertido em uma matriz mesmo que ele contenha um valor único. Por exemplo,
"field1": "Discovery"se torna"field1": ["Discovery"]. Apenas os primeiros 50.000 caracteres de um campo personalizado a partir de um arquivo JSON são enriquecidos. -
Para remover um enriquecimento, limpe as caixas de entrada para campos que você deseja remover o enriquecimento.
-
-
Clique em Aplicar alterações e reprocessar para aplicar suas alterações na coleção.
Excluindo um enriquecimento
Você pode excluir um enriquecimento personalizado que você construiu para ensinar Discovery sobre o seu serviço. Os enriquecimentos personalizados incluem dicionários, expressões regulares, padrões, entre outros. Para obter mais informações, consulte Adicionando recursos específicos de domínio.
Não é possível excluir um enriquecimento pré-construído. Os enriquecimentos pré-construídos incluem os enriquecimentos Natural Language Understanding, como o enriquecimento de Entidades, que são embutidos no produto. Para determinar quais enriquecimentos
são construídos em, confira a coluna Tipo da página Enrichments para uma coleção. Os enriquecimentos pré-construídos têm o tipo System.
Para excluir um enriquecimento personalizado, conclua as etapas a seguir:
-
Abra um projeto que usa o enriquecimento personalizado.
-
Clique em Gerenciar coleçõese, em seguida, abra uma coleção onde o enriquecimento está em uso.
-
A partir da página Enrichments de uma coleção, remova o enriquecimento de quaisquer campos onde ele é aplicado.
-
Clique em Aplicar alterações e reprocesso e, em seguida, aguarde o sistema para processar os documentos em sua coleção sem o enriquecimento.
-
Repita o passo anterior para cada coleção em cada projeto onde o enriquecimento é usado.
Lembre-se, um enriquecimento personalizado pode ser usado por qualquer coleta em qualquer projeto dentro de uma única instância de serviço Discovery.
-
A partir de qualquer uma das coleções que utilizaram o enriquecimento, abra a página Enrichments e, em seguida, clique no ícone de exclusão para excluir o enriquecimento.
O enriquecimento personalizado é removido da lista Enrichments em todos os lugares nesta instância de serviço.
Usando a API para gerenciar enriquecimentos
Para aplicar um enriquecimento em dados usando a API, complete as seguintes etapas:
- Primeiro, você deve saber o ID exclusivo do enriquecimento que você deseja aplicar. Para obter mais informações, consulte IDs de Enriquecimento.
- Use os métodos Criar coleção ou Coleção de atualização para aplicar um enriquecimento nos documentos em uma coleção. Para obter mais informações, consulte Aplicar enriquecimento usando a API
IDs de enriquecimento
Se você deseja aplicar um enriquecimento personalizado que criou para uma coleção para outra coleção, você deve conhecer o ID exclusivo que foi gerado para o enriquecimento quando ele foi criado. Use a API para listar enriquecimentos a partir do projeto em que o enriquecimento personalizado está em uso. A lista que é retornada inclui informações de ID de enriquecimento.
Para os enriquecimentos pré-construídos, os IDs exclusivos não mudam. A tabela a seguir relaciona os IDs que estão associados a cada tipo de enriquecimento pré-construído e identifica as linguagens de coleta para as quais o enriquecimento é suportado. Um enriquecimento não pode ser aplicado a uma coleção, a menos que a linguagem de coleta seja apoiada pelo enriquecimento.
| Nome | ID de enriquecimento | Idiomas suportados |
|---|---|---|
| Contratos | 701db916-fc83-57ab-0000-000000000014 | pt |
| Entidades | 701db916-fc83-57ab-0000-00000000001e | ar, de, en, es, fr, it, ja, ko, nl, pt, zh-CN |
| Palavras-chave | 701db916-fc83-57ab-0000-000000000018 | ar, de, en, es, fr, it, ja, ko, nl, pt, zh-CN |
| Parte do discurso | 701db916-fc83-57ab-0000-000000000002 | Todos os idiomas suportados |
| Sentimento de Documento | 701db916-fc83-57ab-0000-000000000016 | ar, de, en, es, fr, it, ja, ko, nl, pt, zh-CN |
| Table Understanding | 701db916-fc83-57ab-0000-000000000012 | Todos os idiomas suportados |
Para obter mais informações sobre todos os idiomas suportados, consulte Suporte ao Idioma.
Aplicar enriquecimentos usando a API
Para aplicar um enriquecimento usando a API, conclua as etapas a seguir:
-
Determine a base URL para o endpoint e o token ou a chave de API para sua implantação.
Para obter mais informações, consulte Construindo aplicativos personalizados com a API.
-
Obtem o ID do projeto para o seu projeto.
A partir da interface do usuário do produto, acesse a página Integrar e Impletar > Visualizar informações da API e, em seguida, copiar o ID do projeto.
-
Se você não souber o ID da coleção que deseja aplicar o enriquecimento para, obtenha uma lista de suas coleções para localizá-lo.
Por exemplo:
GET $authentication $url/v2/projects/$project_id/collections?version=2019-11-22O
collection_idé retornado. -
Envie uma solicitação GET para retornar a configuração da coleção que lista os enriquecimentos aplicados.
Por exemplo:
GET $authentication $url/v2/projects/$project_id/collections/$collection_id?version=2019-11-22Para os IDs de enriquecimento para os enriquecimentos pré-construídos, consulte IDs de Enriquecimento.
-
Adicio o enriquecimento que você deseja aplicar.
Por exemplo, para incluir o enriquecimento Palavras-chave, é possível incluir o enriquecimento na lista de enriquecimentos. Primeiro, obtenha seu ID da tabela.
O ID de enriquecimento de Palavras-chave é
701db916-fc83-57ab-0000-000000000018Para indicar que você deseja aplicar o enriquecimento de Palavras-chave ao conteúdo no campotextdos documentos na coleta, é possível representá-lo no formato JSON da seguinte forma:{ "enrichment_id" : "701db916-fc83-57ab-0000-000000000018", "fields" : [ "text" ] }Quaisquer enriquecimentos que você especificar substituem os enriquecimentos inadimplentes. Portanto, se você deseja manter um enriquecimento padrão, não se esqueça de incluê-lo na lista de enriquecimentos que você aplica à coleção. Para obter uma lista de enriquecimentos inadimplentes por tipo de projeto, consulte enriquecimentos padrão por tipo de projeto.
Por exemplo, para reter o enriquecimento Entities e incluir o enriquecimento Keywords, é possível especificar o seguinte no corpo da solicitação:
"enrichments": [ { "enrichment_id": "701db916-fc83-57ab-0000-00000000001e", "fields": [ "text" ] }, { "enrichment_id": "701db916-fc83-57ab-0000-000000000018", "fields": [ "text" ] } ] -
Envie o corpo de solicitação JSON atualizado com o método update collection para aplicar o enriquecimento em sua coleção.
Por exemplo:
POST $authentication -d '$requestBody' $url/v2/projects/$project_id/collections/$collection_id?version=2019-11-22
Enriquecimentos padrão por tipo de projeto
Alguns enriquecimentos pré-construídos são aplicados automaticamente em coleções em um projeto baseado no tipo de projeto. A tabela a seguir mostra os enriquecimentos inadimplentes que são aplicados a cada tipo de projeto.
| Enriquecimento | Document Retrieval | Recuperação de Documentos para Contratos | Conversational Search | Mineração de conteúdo |
|---|---|---|---|---|
| Contratos | ||||
| Entidades | ||||
| Palavras-chave | ||||
| Parte do discurso | ||||
| Sentimento de Documento | ||||
| Table Understanding |