DataWorks:Criar uma base de conhecimento

Visão geral

O Context Graph (base de conhecimento) é o módulo de gerenciamento unificado de conhecimento do DataWorks. Ele fornece uma base unificada para aplicações inteligentes, como Data Agent e AI Assistant. O sistema organiza informações dispersas em metadados de workspace, fontes de dados e documentos de negócios em um conhecimento navegável, pesquisável e controlado por autorização. Isso permite que as aplicações inteligentes mantenham um contexto de negócios consistente durante sessões de perguntas e respostas, recuperação de dados e análises.

As bases de conhecimento são gerenciadas como instâncias independentes. Uma única base pode ser reutilizada por várias aplicações inteligentes, eliminando a necessidade de construção redundante em cada aplicação.

Pré-requisitos

Conclua as seguintes preparações antes de usar uma base de conhecimento:

1. Ative o DataWorks e acesse o tenant onde deseja criar a base de conhecimento.

2. Para compilar conhecimento a partir de workspaces, certifique-se de que a conta atual possui permissões de leitura nos workspaces a serem coletados e nos ativos de dados relacionados.

3. Prepare um grupo de recursos serverless e seu workspace associado capazes de executar tarefas de compilação de conhecimento. O grupo de recursos selecionado precisa ter conectividade de rede e permissões de acesso às fontes de dados ou services cloud necessários para a compilação, além de reservar pelo menos 4 CUs de capacidade disponível.

Conceitos principais

Etapa 1: Criar uma base de conhecimento

Etapa 2: Configurar fontes

Etapa 3: Compilar conhecimento

Acesse a base de conhecimento de destino e clique em Knowledge Building na parte superior da página de detalhes. Primeiro, selecione um método de compilação. O sistema oferece três métodos:

• Compilar por workspace: Selecione um workspace para criar diretamente uma nova tarefa de compilação de conhecimento.

• Compilar por fonte de dados: Selecione uma fonte de dados para compilar conhecimento com seleção refinada do escopo de tabelas.

• Envio manual: Envie diretamente arquivos locais e crie uma tarefa de compilação de conhecimento.

O método de acionamento é um atributo configurado durante a criação da tarefa. Tarefas de compilação por workspace e por fonte de dados podem ser acionadas manualmente ou executadas periodicamente. Tarefas de envio manual iniciam a compilação imediatamente após o envio e não suportam execuções periódicas.

Etapa 4: Gerenciamento de compilação

Após iniciar uma compilação de conhecimento, visualize as tarefas de compilação no gerenciamento de compilação. Na página de detalhes da base de conhecimento, clique na aba Build Management para gerenciar definições de tarefas e instâncias de execução. Cada execução de tarefa gera uma instância de execução.

• Definições de tarefa

  Cada definição de tarefa contém o nome da tarefa, tipo de tarefa, escopo de compilação, método de acionamento, grupo de recursos e status da tarefa. Pesquise por nome da tarefa, filtre por tipo de tarefa, método de acionamento e status de ativação, além de atualizar as definições de tarefa.

  Operações disponíveis:

  • Run Now: Aciona manualmente uma compilação.

  • Edit: Modifica o nome da tarefa, método de acionamento e outras configurações.

  • Enable / Disable: Controla o acionamento automático de tarefas agendadas.

  • Delete: Remove uma definição de tarefa. Não é possível excluir uma tarefa enquanto ela estiver em execução.

• Instâncias de execução

  A lista de instâncias exibe o nome da tarefa, tipo, método de acionamento, status de execução, horário de início e ações disponíveis para cada execução. Filtre por status de execução, tipo de tarefa e método de acionamento. Ações disponíveis:

  Importante

  O tempo necessário para a execução da instância depende do tamanho do conteúdo de conhecimento a ser compilado. Isso pode levar algum tempo.

  • View: Abre os detalhes da instância.

  • Source File: Visualize os arquivos de entrada usados nesta compilação.

  • Cancel: Cancela instâncias que ainda podem ser encerradas.

  • Retry: Reinicia a execução para instâncias falhas ou encerradas que permitem reexecução.

• Detalhes da instância

  Quando o status de uma instância for Failed, execute as seguintes etapas:

  1. Identifique o problema: Na lista de instâncias, clique em View para a tarefa falha. Na página de detalhes, localize a etapa falha vermelha no gráfico de execução.

  2. Analise os logs: Abra o log da etapa falha e solucione o problema com base na mensagem de erro, consultando a tabela a seguir.

  3. Corrija e tente novamente: Após corrigir o problema, volte para a página de definição da tarefa e clique em Run Now.

Após corrigir o problema, clique em Run Now novamente na definição da tarefa.

Etapa 5: Usar a base de conhecimento

Configuração e permissões

Após configurar uma base de conhecimento, adicione vários administradores para o gerenciamento diário. Compartilhe a base de conhecimento com usuários, instâncias do AI Assistant ou instâncias do Data Agent para fornecer capacidades de raciocínio de conhecimento para o contexto do Agent.

Idioma do conteúdo

O conteúdo da base de conhecimento suporta chinês simplificado e inglês. Cada base de conhecimento mantém apenas um idioma de conteúdo.

• Durante a primeira compilação, o sistema determina o idioma do conteúdo da base de conhecimento com base na configuração de idioma no canto superior direito do console do DataWorks. [A confirmar: se a regra de que o idioma é bloqueado na primeira compilação e não pode ser alterado permanece inalterada]

• Após a determinação do idioma, todas as compilações subsequentes usam o mesmo idioma. Alternar o idioma do console altera apenas a exibição da interface e não muda o idioma do conhecimento existente.

• Não é possível modificar diretamente o idioma do conteúdo de uma base de conhecimento existente. Para usar um idioma diferente, crie uma nova base de conhecimento e inicie a primeira compilação com o idioma de página desejado.

• Nomes físicos de tabelas, nomes de campos, SQL, códigos, IDs, tags originais e evidências de citação não são traduzidos. Portanto, uma base de conhecimento em inglês ainda pode conter texto em chinês proveniente dos dados de source.

Bases de conhecimento locais (para usuários existentes do AI Assistant)

A base de conhecimento foi separada do AI Assistant em um módulo independente. Para usuários existentes do AI Assistant, as bases de conhecimento criadas anteriormente no AI Assistant são exibidas como bases de conhecimento locais na interface e permanecem funcionais. Quando o módulo de base de conhecimento é incorporado ao AI Assistant, as bases de conhecimento locais aparecem na seção de base de conhecimento pessoal da lista de bases de conhecimento. Clique em uma base de conhecimento local para ir à página de gerenciamento de base de conhecimento no AI Assistant.

• Operações suportadas para bases de conhecimento locais: Os recursos existentes de bases de conhecimento locais permanecem disponíveis, incluindo regeneração, exportação e limpeza.

• Diferenças em relação ao módulo de base de conhecimento

  Item	Base de conhecimento local (existente)	Módulo de base de conhecimento
  Ponto de entrada	A aba Knowledge Base na página de detalhes da instância do AI Assistant	Knowledge Base no painel de navegação à esquerda do console
  Suporte à criação	Não é mais gerada para novas instâncias do AI Assistant	Suportado
  Propriedade	Pertence a uma única instância do AI Assistant	Instância independente que pode ser reutilizada por múltiplas aplicações inteligentes
  Tipo de base de conhecimento	Sem distinção de tipo	Suporta bases de conhecimento pessoais e empresariais
  Método de compartilhamento	Disponível apenas dentro da instância atual	Suporta autorização através de Share para usuários, Data Agent ou AI Assistant

• Diferenças em relação a novas instâncias do AI Assistant: Novas instâncias do AI Assistant não geram mais bases de conhecimento locais. Isso significa que não é mais possível criar bases de conhecimento no AI Assistant. Para criar uma base de conhecimento, acesse o módulo de base de conhecimento para criação e gerenciamento unificados e utilize a base de conhecimento no AI Assistant ou Data Agent conforme necessário.

FAQ

• P: Por que as opções de gerenciamento de fontes ou compilação de conhecimento não são clicáveis?

  R: Você pode ter apenas permissões de somente leitura ou de uso compartilhado. Entre em contato com o proprietário ou administrador da base de conhecimento para verificar suas permissões.

• P: Por que não consigo ver todas as seções no gerenciamento de configuração?

  R: O sistema exibe apenas as seções que você tem permissão para manter. Por exemplo, ter permissão para editar informações básicas não significa necessariamente que você possa gerenciar o escopo de compartilhamento.

• P: Por que não há workspaces ou fontes de dados disponíveis na página de compilação?

  R: A source não foi adicionada à base de conhecimento. Adicione-a no gerenciamento de fontes e retorne à página. As opções disponíveis serão atualizadas.

• P: Por que a exclusão da tarefa falhou?

  R: A tarefa pode estar em execução, sendo excluída ou tendo dependências de outras tarefas. Pare as instâncias ativas, remova as dependências e tente excluir novamente.

• P: Por que não consigo criar uma base de conhecimento no AI Assistant?

  R: As bases de conhecimento foram separadas em um módulo independente para gerenciamento unificado. Novas instâncias do AI Assistant Service não suportam mais a criação de bases de conhecimento locais. Crie uma base de conhecimento no módulo Context Graph (base de conhecimento). Após a criação, a base de conhecimento pode ser usada no AI Assistant e no Data Agent.

• P: As bases de conhecimento locais existentes ainda podem ser usadas?

  R: Sim. Bases de conhecimento criadas anteriormente no AI Assistant são exibidas como bases de conhecimento locais na interface para usuários existentes. Você ainda pode regenerá-las, exportá-las e limpá-las. Seu uso existente não é afetado.

• P: Qual é a diferença entre administrador e autorização de compartilhamento?

  R: Administradores podem configurar, enviar e compilar uma base de conhecimento. Usuários, Data Agents ou instâncias do AI Assistant Service autorizados através de compartilhamento podem apenas usar o conhecimento para pesquisa ou perguntas e respostas, e não podem modificar a base de conhecimento.

Melhores práticas

• Planeje o escopo das fontes antes da primeira compilação para evitar a varredura de workspaces irrelevantes.

• Atribua um proprietário claro para a base de conhecimento e configure um administrador reserva.

• Ative o perfil de dados para bases de conhecimento que exigem alta qualidade semântica e monitore a amostragem SQL e o consumo de tokens.

• Após uma compilação bem-sucedida, verifique conjuntamente as instâncias de execução, a cobertura do grafo de conhecimento e os resultados da pesquisa de conhecimento para validar a disponibilidade.

• Versões não publicadas de modelos semânticos não substituem automaticamente a versão publicada atual. Revise-as antes de publicar.

• Desativar uma tarefa pausa acionamentos subsequentes, enquanto excluir uma tarefa remove a definição da tarefa. Não confunda as duas operações.

• Melhore a qualidade da compilação automática enriquecendo comentários de tabelas e campos de source, padrões de dados, proprietários, linhagem e regras de qualidade. Revise manualmente métricas principais, campos sensíveis e consultas-chave.

• Limpe regularmente documentos expirados e ativos de teste para reduzir ruído nas pesquisas.

• Siga o princípio do menor privilégio e revogue prontamente a autorização quando o acesso à base de conhecimento não for mais necessário.