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:

  1. 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.

  2. 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.

  3. Encontre o enriquecimento que você deseja aplicar ou remover.

  4. Clique no twistie no campo associado para expandir uma lista de campos.

  5. 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 text e html, 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.

  6. 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:

  1. Abra um projeto que usa o enriquecimento personalizado.

  2. Clique em Gerenciar coleçõese, em seguida, abra uma coleção onde o enriquecimento está em uso.

  3. A partir da página Enrichments de uma coleção, remova o enriquecimento de quaisquer campos onde ele é aplicado.

  4. Clique em Aplicar alterações e reprocesso e, em seguida, aguarde o sistema para processar os documentos em sua coleção sem o enriquecimento.

  5. 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.

  6. 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:

  1. Primeiro, você deve saber o ID exclusivo do enriquecimento que você deseja aplicar. Para obter mais informações, consulte IDs de Enriquecimento.
  2. 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.

IDs de enriquecimento Preconstruídos
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:

  1. 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.

  2. 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.

  3. 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-22
    

    O collection_id é retornado.

  4. 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-22
    

    Para os IDs de enriquecimento para os enriquecimentos pré-construídos, consulte IDs de Enriquecimento.

  5. 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-000000000018 Para indicar que você deseja aplicar o enriquecimento de Palavras-chave ao conteúdo no campo text dos 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"
        ]
      }
    ]
    
  6. 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.

enriquecimentos padrão por tipo de projeto
Esta tabela tem cabeçalhos de linha e coluna. Os cabeçalhos de linha identificam os tipos de projeto. Os cabeçalhos da coluna identificam diferentes enriquecimentos. Para entender quais enriquecimentos são aplicados em um tipo de projeto por padrão, vá para a linha que descreve os enriquecimentos, e encontre as colunas para o tipo de projeto que você está interessado.
Enriquecimento Document Retrieval Recuperação de Documentos para Contratos Conversational Search Mineração de conteúdo
Contratos Ícone de visto
Entidades Ícone de visto Ícone de visto
Palavras-chave
Parte do discurso Ícone de visto
Sentimento de Documento
Table Understanding Ícone de visto