Introdução ao Knowledge Accelerators

Adicione os Knowledge Accelerators vocabulários usando IBM Knowledge Catalog a interface do usuário ou chamadas de API e, em seguida, personalize os componentes.

Antes de iniciar

  1. Certifique-se de que possui o plano necessário e as permissões de usuário:
    Plano de oferta
    O plano IBM Cloud Pak for Data Plano da empresa. Para obter mais informações, consulte IBM Knowledge Catalog service plans.
    Permissões necessárias
    • Catálogos de acesso
    • Acessar artefatos de controle
    • Gerenciar glossário
    • Gerenciar categorias de governança
Nota:

Se você deseja adicionar termos comerciais predefinidos de amostra, consulte Instalação de termos comerciais predefinidos de amostra.

Adicionando o Knowledge Accelerators com a interface do usuário

Para importar Escopos de Negócios, Vocabulário Básico de Negócios e Vocabulários Opcionais de Alinhamento Setorial, siga as etapas da interface do usuário.

  1. Vá para Administração > Configurações e definições e clique em Add industry vocabularies.
  2. Selecione o setor para o qual deseja adicionar vocabulários.

    Se você deseja adicionar termos comerciais predefinidos de amostra, consulte Instalação de termos comerciais predefinidos de amostra.

  3. Selecione para adicionar um dos seguintes itens:
    • Um vocabulário básico de negócios que inclui todos os escopos de negócios e a categoria opcional de alinhamento setorial.
    • Um escopo de negócios para o setor.
    Vocabulário básico de negócios
    Importe cada um dos vocabulários Knowledge Accelerators específicos que contêm o Vocabulário Empresarial completo e todos os Âmbitos Empresariais. Se você precisar importar um conjunto extenso de termos comerciais para abranger toda a amplitude de um setor, por exemplo, de 5.000 a 20.000 termos, selecione esta opção.

    Opcionalmente, você também pode importar um vocabulário de Alinhamento da Indústria.

    Âmbito de atividade
    Você pode importar separadamente um escopo Knowledge Accelerators de negócios, por exemplo, Data Privacy ou outro escopo específico do setor. Se um ou mais desses escopos de negócios existirem para uma área de seu interesse e se você preferir começar com um número relativamente pequeno de termos comerciais, por exemplo, de 200 a 500 termos, instale esses escopos separados. Cada escopo de negócios é importado separadamente.
    Para obter uma lista detalhada de todos os artefatos disponíveis para cada setor, incluindo uma definição, os identificadores e mais informações, consulte os links a seguir.
  4. Opcional: se você selecionou o vocabulário básico de negócios, pode selecionar um vocabulário de alinhamento do setor para importar.
  5. Definir opções de mesclagem para a importação.

    Para obter mais informações, consulte Métodos para mesclar artefatos importados e existentes.

    Por padrão, os seguintes itens são importados:
    • Artefatos especificados que você selecionou: o vocabulário básico do negócio, o vocabulário de alinhamento do setor ou um escopo de negócios.
    • Artefatos considerados obrigatórios para o vocabulário ou escopo de negócios especificado.
  6. Clique em Add para iniciar a importação.

    Ao ver uma mensagem de notificação de que a importação está começando, você pode fechar a janela.

    Não é possível iniciar vários trabalhos de importação simultaneamente.

    Nota:
    • Se você importar vários escopos de negócios, algumas relações de artefatos compartilhados, como políticas e regras para termos de vocabulário, podem ser substituídas por uma importação subsequente do escopo de negócios.
    • Se você importar Knowledge Accelerators para vários setores, as relações de artefatos compartilhados, como políticas e regras para termos de vocabulário, podem não ser mescladas para a importação subsequente — os mapeamentos dos artefatos KA importados inicialmente são mantidos. É possível ignorar as mensagens (GIM00010E ou GIM00015E) no log de importação relacionado às políticas e regras de controle...

    Dependendo do número e do tamanho dos artefatos importados, a importação pode demorar algum tempo.

  7. Opcional: Clique no View details botão para ver o progresso da importação ou clique no View log botão para ver os detalhes da importação.

Próximas etapas

Após a conclusão da importação, você precisa adicionar colaboradores às Knowledge Accelerators categorias, caso contrário, apenas a pessoa que importar o acelerador poderá usar os artefatos. Consulte Gerenciando o acesso a uma categoria para obter detalhes sobre como fazer isso.

Adição da função Knowledge Accelerators com API

Você pode encontrar descrições dos pontos finais da API para o Knowledge Accelerators na documentação da API.

  1. Opcional: verifique quais Knowledge Accelerators itens já foram importados chamando o endpoint da API Get what Knowledge Accelerator items are imported into glossary (Obter quais itens do Knowledge Accelerator foram importados para o glossário).
  2. Opcional: Verifique quais itens você pode importar:
  3. Autentique-se com Cloud Pak for Data gerando um token IBM Cloud IAM:
    1. Obtenha sua chave API conforme descrito em Criando uma chave API no console.
    2. Gere um token IAM usando sua chave API, conforme descrito em Gerando um token IAM IBM Cloud usando uma chave API.
  4. Chame o ponto final da API Importar itens especificados do Knowledge Accelerator para o glossário.
  5. Escolha os artefatos que deseja instalar.
    Nota:
    • Se você importar vários escopos de negócios KA, algumas relações de artefatos compartilhados, como políticas e regras para termos de vocabulário, poderão ser substituídas por uma importação de escopo de negócios subsequente.
    • Se você importar Knowledge Accelerators para vários setores, as relações de artefatos compartilhados, como políticas e regras para termos de vocabulário, podem não ser mescladas para a importação subsequente — os mapeamentos dos artefatos KA importados inicialmente são mantidos. É possível ignorar as mensagens (GIM00010E ou GIM00015E) no log de importação relacionado às políticas e regras de controle...
    Amostra
    Os dados IBMKnowledge Accelerators pessoais de amostra incluem uma categoria com 100 termos comerciais predefinidos.
    Vocabulário básico de negócios
    Importe cada um dos vocabulários Knowledge Accelerators específicos que contêm o Vocabulário Empresarial completo e todos os Âmbitos Empresariais. Se você precisar importar um conjunto extenso de termos comerciais para abranger toda a amplitude de um setor, por exemplo, de 5.000 a 20.000 termos, selecione esta opção.

    Opcionalmente, você também pode importar um vocabulário de Alinhamento da Indústria.

    Âmbito de atividade
    Você pode importar separadamente um escopo Knowledge Accelerators de negócios, por exemplo, Data Privacy ou outro escopo específico do setor. Se um ou mais desses escopos de negócios existirem para uma área de seu interesse e se você preferir começar com um número relativamente pequeno de termos comerciais, por exemplo, de 200 a 500 termos, instale esses escopos separados. Cada escopo de negócios é importado separadamente.
    Para obter uma lista detalhada de todos os artefatos disponíveis para cada setor, incluindo uma definição, os identificadores e mais informações, consulte os links a seguir.
  6. Insira valores para os seguintes parâmetros.
    Por exemplo:
    Parâmetro Descrição Exemplo
    ka_id O ID para uma indústria kafs20
    IDs O ID de um ou mais itens do Knowledge Accelerator que você deseja importar separados por uma vírgula Observe que é possível importar apenas um escopo por vez core-bpi,ccpa,fhir, gdpr
    opção de mesclagem A opção de mesclagem a ser usada ao importar no IBM Knowledge Catalog. all
    dependências Indica quais dependências dos IDs de item especificados também devem ser importadas necessary
    importar
    • Selecione false para verificar os parâmetros e descobrir quais serão importados.
    • Selecione true para importar..
    false
  7. Opcional: Dependendo do número e tamanho dos itens importados, a importação pode demorar algum tempo. Verifique o status manualmente, pois você não será notificado quando a importação for concluída:
    1. Observe o process_id valor na notificação
    2. Verifique o status da importação chamando o endpoint da API de status de importação de ativos, onde {process_id} é o valor obtido na etapa 4 da adição dos Knowledge Accelerators com a API.

    O status de importação permanece "IN_PROGRESS" até todos os artefatos serem importados.

Próximas etapas

Após a conclusão da importação, você precisa adicionar colaboradores às Knowledge Accelerators categorias, caso contrário, apenas a pessoa que importar o acelerador poderá usar os artefatos. Consulte Gerenciando o acesso a uma categoria para obter detalhes sobre como fazer isso.

Incluindo colaboradores

É necessário incluir colaboradores nas categorias Knowledge Accelerators , caso contrário, somente a pessoa que importa o acelerador poderá usar os artefatos Consulte Gerenciando o acesso a uma categoria para obter detalhes sobre como fazer isto