Adicionar comentários gerados por IA a objetos do Catálogo do Unity
Este artigo apresenta os comentários de objetos e colunas de tabelas gerados por IA (também conhecidos como documentação gerada por IA), explica como eles funcionam, mostra como adicioná-los e editá-los e responde a perguntas frequentes.
Objetos com suporte
Os comentários gerados por IA são compatíveis com os seguintes objetos do Catálogo do Unity:
- Catálogos
- Esquemas
- Tabelas
- Colunas da tabela
- Funções
- Modelos
- Volumes
Os comentários gerados por IA não dão suporte a exibições ou exibições materializadas.
Como funcionam os comentários gerados por IA?
Como um proprietário do objeto ou usuário com permissão para modificar um objeto, você pode usar o Gerenciador do Catálogo para exibir e adicionar um comentário gerado por IA a qualquer tabela ou coluna de tabela gerenciada pelo Catálogo do Unity. Os comentários são desenvolvidos por um LLM (modelo de linguagem grande) que leva em conta os metadados do objeto, como o esquema de tabela e os nomes das colunas.
Comentários gerados por IA fornecem uma maneira rápida de ajudar os usuários a descobrir dados gerenciados pelo Unity Catalog.
Importante
Os comentários gerados por IA destinam-se a fornecer uma descrição geral de dos objetos e colunas de tabelas com base no esquema. As descrições são ajustadas para dados em um contexto empresarial, usando esquemas de exemplo de vários conjuntos de dados abertos em vários setores. O modelo foi avaliado com centenas de amostras simuladas para verificar se evita gerar descrições prejudiciais nem inadequadas.
Os modelos de IA nem sempre são precisos e os comentários precisam ser revisados antes de salvar. O Databricks recomenda fortemente a revisão humana de comentários gerados por IA para verificar se há imprecisões. Não se deve confiar no modelo para tarefas de classificação de dados, como detectar colunas com PII.
Para exibir os comentários adicionados, você deve ter o privilégio SELECT no objeto USE SCHEMA no esquema pai e USE CATALOG no catálogo pai.
Para obter informações sobre os modelos usados para gerar sugestões de comentários, confira Perguntas frequentes sobre comentários gerados por IA.
Antes de começar
Antes de poder usar os comentários gerados por IA, o administrador do espaço de trabalho deve habilitar os recursos de assistência baseados nos serviços de IA do Azure:
- Em Configurações, vá para a guia Avançado e role para baixo até a seção Outros.
- Ative a opção Recursos assistivos de IA com base nos Serviços de IA do Azure.
Adicionar comentários gerados por IA
Você deve usar o Gerenciador do Catálogo para exibir comentários sugeridos, editá-los e adicioná-los a objetos e colunas de tabelas.
Permissões necessárias: você deve ser o proprietário do objeto ou ter o privilégio MODIFY no objeto para exibir o comentário sugerido pela IA, editá-lo e adicioná-lo.
Adicionar um comentário sugerido por IA a um objeto
No workspace do Azure Databricks, clique em
Catálogo.Pesquise ou procure o objeto e selecione-o.
No painel Sobre este
<object>, clique em Gerar com IA.
Pode demorar um pouco para a IA gerar o comentário.
Clique em Aceitar para aceitar o comentário sem alterações ou Editar para modificá-lo antes de salvá-lo.
Adicionar um comentário sugerido pela IA a uma coluna de tabela
No workspace do Azure Databricks, clique em
Catálogo.Pesquise ou procure a tabela e selecione-a.
Acima dos títulos das colunas da tabela, clique em Gerar com IA.
Um comentário é gerado para cada coluna.
Clique na marca de seleção próxima ao comentário da coluna para aceitá-lo ou fechá-lo sem salvar.
Atualizar um comentário gerado por IA
O proprietário do objeto ou usuário com o privilégio MODIFY no objeto pode atualizar comentários a qualquer momento, usando a interface do usuário do Gerenciador do Catálogo. O assistente de chat embutido ajuda a editar comentários, fornecendo opções para encurtar texto ou traduzir texto para um idioma diferente.
Você também pode usar os comandos SQL ALTER ou COMMENT ON.
Perguntas frequentes sobre comentários gerados por IA
Esta seção fornece informações gerais sobre comentários gerados por IA (também conhecidos como documentação gerada por IA) na forma de perguntas frequentes.
Quais serviços o recurso de documentação gerada por IA usa?
Os comentários gerados por IA usam um LLM (modelo de linguagem de grande escala) interno para tabelas e colunas. Eles podem usar parceiros de modelo externos para outros objetos do Catálogo do Unity e o assistente embutido. Os dados enviados a serviços externos não são usados para o treinamento do modelo. Os modelos propriamente ditos são sem estado: nenhum prompt ou conclusão é armazenado por provedores de modelo.
Em quais regiões os pontos de extremidade de serviço de modelo estão hospedados?
Para os workspaces da UE (União Europeia), os recursos assistivos de IA usarão um modelo do OpenAI do Azure hospedado na UE. Todas as outras regiões usarão um modelo hospedado nos EUA.
Como os dados são criptografados entre o Azure Databricks e os serviços de IA do Azure?
O tráfego entre o Databricks e os serviços de IA do Azure é criptografado em trânsito usando a criptografia TLS 1.2 padrão do setor.
Tudo é criptografado em repouso?
Todos os dados armazenados em um workspace do Azure Databricks são criptografados em AES 256 bits. Nossos parceiros externos não armazenam prompts ou preenchimentos enviados a eles.
Quais dados estão sendo enviados para os modelos?
O Azure Databricks envia os seguintes metadados para os modelos com cada solicitação de API:
- Catálogo (nome do catálogo, comentário atual, tipo de catálogo)
- Esquema (nome do catálogo, nome do esquema, comentário atual)
- Tabela (nome do catálogo, nome do esquema, nome da tabela, comentário atual)
- Função (nome do catálogo, nome do esquema, nome da função, comentário atual, parâmetros, definição)
- Modelo (nome do catálogo, nome do esquema, nome do modelo, comentário atual, aliases)
- Volume (nome do catálogo, nome do esquema, nome do volume, comentário atual)
- Nomes de coluna (nome da coluna, tipo, chave primária ou não, comentário da coluna atual)
Os comentários aprovados são armazenados no banco de dados do plano de controle do Azure Databricks, juntamente com o restante dos metadados do Catálogo do Unity. O banco de dados do painel de controle é criptografado em AES-256 bits.
Quais termos legais regem o uso de comentários gerados por IA?
O uso é regido pelos termos e condições existentes do Azure Databricks com os quais o cliente concordou ao usar o Azure Databricks.