Os conjuntos de contexto permitem embasar agentes de IA usando contêineres limitados de informações semânticas e referências de recursos de dados. Para mais informações sobre como esses contêineres funcionam, consulte Visão geral dos conjuntos de contexto.
É preciso configurar um conjunto de contexto antes de executar uma tarefa de enriquecimento. As tarefas de enriquecimento são agentes autônomos que analisam continuamente os esquemas e a documentação do conjunto de dados para gerar metadados propostos para seus recursos de dados.
É possível configurar um conjunto de contexto como um contêiner independente ou como parte de uma configuração de job de enriquecimento. Para mais informações sobre como criar um conjunto de contexto durante a configuração de uma tarefa, consulte Criar tarefas de enriquecimento.
Antes de começar
Antes de gerenciar conjuntos de contexto, verifique se você tem os papéis do IAM necessários.
Funções exigidas
Para receber as permissões necessárias para gerenciar conjuntos de contexto, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
- Para criar conjuntos de contexto: Administrador do Dataplex Catalog (
roles/dataplex.catalogAdmin) ou Proprietário de grupos de entradas do Dataplex (roles/dataplex.entryGroupOwner). Esses papéis contêm a permissãodataplex.entryGroups.setIamPolicy, que é necessária para conceder automaticamente permissões de proprietário durante a criação do conjunto de contexto. - Para editar ou excluir conjuntos de contexto: Administrador do Dataplex Catalog
(
roles/dataplex.catalogAdmin) ou Editor do Dataplex Catalog (roles/dataplex.catalogEditor).
Criar um conjunto de contextos
Para criar um conjunto de contexto vazio para armazenar os metadados enriquecidos, faça o seguinte:
Knowledge Studio
No console do Google Cloud , acesse a página Knowledge Studio.
No painel de navegação à esquerda, selecione Conjuntos de contexto.
Na página Conjuntos de contexto, clique em Criar.
No painel Criar conjunto de contexto, insira um nome no campo Nome de exibição e um ID no campo ID do conjunto de contexto.
Opcional: insira uma Descrição, selecione um Local e adicione Rótulos.
Clique em Salvar.
Tipos de metadados
No console do Google Cloud , acesse a página Tipos de metadados.
Clique em Grupos de entradas > Conjunto de contexto.
Na página Tipos de metadados, clique em Criar.
No painel Criar conjunto de contexto, insira um nome no campo Nome de exibição e um ID no campo ID do conjunto de contexto.
Opcional: insira uma Descrição, selecione um Local e adicione Rótulos.
Clique em Salvar.
Depois de criar o conjunto de contexto, você pode selecioná-lo como destino para suas tarefas de enriquecimento. A execução de enriquecimento preenche esse contêiner com os conceitos de metadados, as associações semânticas e as fórmulas propostas pela IA.
Para mais informações sobre tarefas de enriquecimento, consulte Sobre tarefas de enriquecimento.
Ver conjuntos de contexto
Para ver os conjuntos de contexto, faça o seguinte:
Knowledge Studio
No console do Google Cloud , acesse a página Knowledge Studio.
No painel de navegação à esquerda, selecione Conjuntos de contexto.
Para ver os detalhes de um conjunto de contexto específico, clique no nome dele na lista.
Tipos de metadados
No console do Google Cloud , acesse a página Tipos de metadados.
Clique em Grupos de entradas > Conjunto de contexto.
Para ver os detalhes de um conjunto de contexto específico, clique no nome dele na lista.
A página de detalhes mostra as propriedades do conjunto de contexto, como descrição, local e ID do projeto. Ele também contém uma seção Entradas de amostra que lista uma prévia das entradas de metadados enriquecidos armazenadas no conjunto de contexto e um botão para visualizar todas as entradas relacionadas na pesquisa.
Editar um conjunto de contextos
Usando o console do Google Cloud , é possível editar as propriedades do contêiner de um conjunto de contexto, que incluem o Nome de exibição, a Descrição e os Rótulos.
Para atualizar o conteúdo de metadados enriquecidos em um conjunto de contexto, execute uma tarefa de enriquecimento direcionada a esse conjunto e aprove as propostas de mudança geradas. Para mais informações sobre como aprovar propostas de mudança, consulte Gerenciar execuções de enriquecimento.
Para editar as propriedades de um conjunto de contexto, faça o seguinte:
Knowledge Studio
No console do Google Cloud , acesse a página Knowledge Studio.
No painel de navegação à esquerda, selecione Conjuntos de contexto.
Clique no nome do conjunto de contexto que você quer editar.
Na página de detalhes, clique em Editar.
Modifique os campos editáveis (Nome de exibição, Descrição ou Rótulos) e clique em Salvar.
Tipos de metadados
No console do Google Cloud , acesse a página Tipos de metadados.
Clique em Grupos de entradas > Conjunto de contexto.
Na página Tipos de metadados, clique no nome do conjunto de contexto que você quer editar.
Na página de detalhes, clique em Editar.
Modifique os campos editáveis (Nome de exibição, Descrição ou Rótulos) e clique em Salvar.
Excluir um conjunto de contexto
A exclusão de um conjunto de contexto remove as associações semânticas dele do gráfico de contexto de dados. Se você excluir um conjunto de contexto enquanto uma execução de enriquecimento estiver ativa, a execução não vai salvar os metadados propostos na conclusão porque o destino não está mais disponível. As execuções subsequentes da tarefa de enriquecimento também vão falhar até que você atualize a tarefa para gerar um conjunto de contexto válido.
Para excluir um conjunto de contexto, faça o seguinte:
Knowledge Studio
No console do Google Cloud , acesse a página Knowledge Studio.
No painel de navegação à esquerda, selecione Conjuntos de contexto.
Na lista, clique no nome do conjunto de contexto que você quer excluir.
Na página de detalhes, clique em Excluir.
Confirme a exclusão.
Tipos de metadados
No console do Google Cloud , acesse a página Tipos de metadados.
Clique em Grupos de entradas > Conjunto de contexto.
Na lista, clique no nome do conjunto de contexto que você quer excluir.
Na página de detalhes, clique em Excluir.
Confirme a exclusão.
Limitações
Para informações sobre as limitações que se aplicam durante o pré-lançamento, consulte Limites do pré-lançamento.
A seguir
Para ver mais informações, consulte os seguintes tópicos:
- Configurar pré-requisitos para tarefas de enriquecimento
- Criar tarefas de enriquecimento
- Gerenciar execuções de enriquecimento