Criar e gerir um Agente Génio

Crie, partilhe e gere um Agente Genie, a interface de chat em linguagem natural que os utilizadores empresariais usam para colocar questões sobre os seus dados no Azure Databricks. Os analistas de dados configuram cada agente com o Unity Catalog, exemplos de consultas SQL, instruções e ativos de confiança; os utilizadores de negócio consultam-no através da interface de chat.

Requisitos técnicos e limites

Aplicam-se os seguintes requisitos e limites ao utilizar Agentes Génio:

• Catálogo Unity: Os dados do Agente Genie devem estar registados no Unity Catalog. Pode adicionar até 30 tabelas ou vistas a um Genie Agent.
• Computação: Os Genie Agents necessitam de um SQL warehouse pro ou serverless. Ao criar ou configurar um agente Genie, tem de ter, pelo menos, a permissão CAN USE no armazém selecionado. As suas credenciais de computação estão incorporadas no Agente Genie para fornecer acesso ao armazém a todos os utilizadores. O acesso aos dados é sempre avaliado usando as próprias permissões do Catálogo Unity de cada utilizador final. Veja como funciona o acesso a dados.
• Capacidade: Cada Agente Genie pode suportar até 10.000 conversas, e cada conversa pode incluir até 10.000 mensagens.

Permissões necessárias

Para criar ou editar um Agente Genie, deve ter as seguintes permissões e direitos:

• Direitos: Você deve ter o direito ao espaço de trabalho Databricks SQL. Consulte Gerenciar permissões.
• Calcular: PODE USAR o acesso em pelo menos um SQL warehouse profissional ou sem servidor.
• Acesso aos dados:SELECT privilégios sobre os dados usados no agente.
• ACLs do Genie Agent: Pelo menos permissões CAN EDIT no Genie Agent. Os criadores do Genie Agent têm automaticamente permissões CAN MANAGE nos agentes que criam. Consulte as ACLs do Genie Agent.

Gerencie o acesso ao Genie

O Genie usa recursos de IA baseados em parceiros, que devem ser habilitados nos níveis de conta e espaço de trabalho. Para saber como gerenciar esses recursos para sua conta, consulte Recursos de IA baseados em parceiros.

Criar um Agente Génio

Para criar um Agente Génio:

1. Clique em Genie Agents na barra lateral.
2. Clique Novo no canto superior direito do ecrã.
3. Escolha as fontes de dados que pretende incluir no seu Agente Genie. Em seguida, clique em Criar.

Cria um agente com o Código Génio

Quando crias um agente, o Código Génio inicia-se automaticamente. Lê os seus dados e sugere contexto que ajuda o Genie a responder a perguntas com precisão, como descrições das suas tabelas e exemplos de consultas. Revê as sugestões e aceita as que queres manter. Para preencher uma lacuna específica, descreve o contexto que queres que o Código Genie acrescente.

Create a Genie agent for our sales team that answers questions about weekly revenue, units sold, and returns by store and region. Use the sales and store tables in the retail catalog.

Também podes pedir ao Genie Code para criar um agente para ti quando ainda não souberes que tabelas usar. Descreva o seu domínio de negócio, as perguntas que quer que o agente responda e os dados que deve utilizar. O Código Génio identifica dados relevantes, confirma as fontes consigo e constrói o agente com esse mesmo contexto inicial.

Antes de partilhar o agente com os utilizadores, a Databricks recomenda adicionar exemplos de consultas SQL, instruções e configurações de armazenamento de conhecimento para melhorar a precisão das respostas. Consulte a qualidade do Tune Genie Agent.

Rever sugestões de consulta

Para aprender sobre os dados do seu agente, o Genie acede à informação do seu espaço de trabalho para compreender melhor as relações entre as tabelas e a semântica do seu negócio. Quando adiciona ativos de dados a um agente, o Genie procura automaticamente consultas relevantes e populares do espaço de trabalho associadas a esses ativos. Suas credenciais de usuário são usadas para encontrar consultas relevantes para as quais você tem pelo menos permissões CAN VIEW. Se a pesquisa retornar consultas, uma notificação será exibida na guia Dados do painel Instruções . Clique em Rever para ver as sugestões de pesquisa.

Para obter mais informações sobre permissões de acesso de consulta, consulte Consultar ACLs.

Use a caixa de diálogo Revisar consultas sugeridas para revisar, editar, aceitar ou rejeitar as consultas sugeridas. Outros utilizadores com pelo menos acesso CAN EDIT no Agente Genie podem rever consultas, desde que tenham pelo menos acesso CAN VIEW na própria consulta.

1. O texto do título é pré-preenchido com uma pergunta. Revise ou edite a pergunta digitando no campo Título .
2. O campo Código contém o texto completo da consulta SQL sugerida. Este campo não é editável. Para visualizar a consulta completa, clique em ... mais linhas.
3. Se tiveres permissões suficientes na consulta, podes clicar em Consulta SQL para abri-la na interface de histórico de consultas. Consulte Exibir histórico de consultas.
4. Depois de determinar se a proposta é relevante para o seu agente, clique em Aceitar ou Rejeitar para a adicionar ao seu agente ou rejeite a sugestão em conformidade.
5. Clique nas outras sugestões para expandir e analisar.

As consultas aceites aparecem no contexto SQL Queries para o agente. Depois de adicionadas ao agente, as perguntas sugeridas e as perguntas associadas tornam-se totalmente editáveis. Consulte Adicionar exemplos de consultas e funções SQL.

Se nenhuma consulta sugerida for retornada:

• Poderá não ter acesso suficiente a consultas relevantes.
• Pode não haver dados relevantes. Se as consultas não tiverem sido executadas nas tabelas incluídas, a pesquisa pode não retornar resultados.
• Consultas irrelevantes para o Agente Génio não são consideradas. Por exemplo, consultas que executam apenas operações básicas de gravação nos ativos incluídos não são consideradas exemplos relevantes para o Genie.
• O Genie não sugere consultas em tabelas que não sejam adicionadas ao agente. Se criou tabelas ou vistas unidas especificamente para o Agente Genie, mas as consultas SQL relevantes do Databricks normalmente correm contra uma tabela de origem diferente, o Genie não devolve essas consultas nos resultados.

Gerenciar objetos de dados

Para gerir quais os objetos de dados incluídos num Agente Genie, clique em Configurar>Dados. Clique no botão Adicionar para adicionar mais tabelas. Clique no à direita do nome da tabela para remover uma tabela do agente.

Para ver detalhes sobre um objeto de dados, clique no nome do objeto. A vista do objeto de dados mostra dois separadores:

• Visão geral: Mostra as colunas no objeto de dados, incluindo nomes de colunas, tipos de dados e descrições.
• Dados de exemplo: Mostra dados de exemplo da tabela para o ajudar a compreender o contexto e o conteúdo dos dados.

Configurar definições

Personalize o seu Genie Agent configurando definições adicionais. Clique em Configurar>configurações para acessar as seguintes configurações:

• Título: O título aparece no explorador do espaço de trabalho juntamente com outros objetos do espaço de trabalho. Escolha um título que ajude os utilizadores finais a encontrar o seu Agente Génio.
• Armazém predefinido: Este recurso de computação alimenta as instruções SQL geradas no Agente Genie. Quando guarda uma seleção de armazém, as suas credenciais de computação são incorporadas no Agente Genie para fornecer acesso ao armazém a todos os utilizadores. Estas credenciais incorporadas concedem acesso apenas ao armazém. O acesso aos dados é sempre avaliado usando as próprias permissões do Catálogo Unity de cada utilizador final. Tens de ter pelo menos permissões CAN EDIT no agente para mudar o armazém. Caso um autor diferente altere o armazém mais tarde, as credenciais de computação dele serão incorporadas em seu lugar. Um Genie Agent pode usar um warehouse SQL pro ou serverless. Para um desempenho ideal, o Databricks recomenda o uso de um SQL warehouse sem servidor.
• Etiquetas: Use etiquetas para organizar e categorizar os Agentes Genie para facilitar a gestão. Consulte Adicionar tags.
• Miniatura: Adicione uma imagem miniatura ao Genie Agent. As miniaturas aparecem na página inicial de chat do Agente Génio e no Génio Um.
• Descrição: Os utilizadores veem a descrição quando abrem o Agente Genie. Use esta área de texto para descrever o propósito do agente. O campo de descrição suporta formatação Markdown para que você possa estilizar seu texto e fornecer links para contexto e referências úteis. Para obter mais informações sobre sintaxe de markdown, consulte o Markdown Guide cheat sheet.
• Perguntas comuns: As perguntas comuns são exemplos opcionais dos tipos de perguntas que os utilizadores podem fazer. Aparecem na página de destino do chat do agente e podem ser adicionados durante a criação ou mais tarde nas Definições do agente. As perguntas comuns definidas pelo autor têm prioridade e aparecem primeiro. Quando fornece perguntas comuns suficientes para preencher a página de destino do chat, apenas as suas perguntas aparecem. Quando fornece menos, o Génio preenche os espaços restantes com perguntas geradas automaticamente.

Conte com fazer iterações ao seu Genie Agent com base nos testes e na utilização. Para orientações sobre as melhores práticas para criar e iterar um agente, consulte Curar um Agente Genie eficaz.

Adicionar tags

Deves ter pelo menos permissões CAN EDIT num Agente Genie para adicionar uma etiqueta. Para adicionar uma tag governada, você também deve ter a permissão ASSIGN na tag governada. Para obter mais informações sobre etiquetas, consulte Aplicar etiquetas a objetos seguros do Unity Catalog.

1. Clique em Definir>configurações.

2. Clique em Geral.

3. Em Tags, adicione ou atualize uma tag:

   • Se não houver tags, clique no botão Adicionar tags .
   • Se houver tags, clique no ícone Adicionar/Editar tags.

4. Selecione uma tag existente Key e Value ou insira o nome de uma nova tag.

   • As tags que são governadas estão no cabeçalho da seção Governadas e têm um ícone de cadeado.
   • As chaves de tag são obrigatórias. Se um valor de tag é necessário depende da chave da tag.

Partilhar um Agente Génio

Para restringir os dados que cada utilizador pode ver dentro do mesmo Agente Genie, aplique segurança ao nível das linhas às tabelas subjacentes no Unity Catalog. Filtros de linha e máscaras de coluna definidos no Unity Catalog são automaticamente aplicados por utilizador, independentemente de como o Agente Genie é partilhado. Consulte os filtros de linha e as máscaras de coluna.

Quando partilha um Agente Genie, os utilizadores devem ter as seguintes permissões para interagir com o agente:

• Permissões: A permissão de acesso do consumidor ao espaço de trabalho Databricks SQL. Consulte Gerenciar permissões.
• Calcular: As consultas são executadas usando as credenciais de computação incorporadas pelo autor que configurou o armazém. Os utilizadores finais não precisam de permissões diretas de armazém.
• Acesso aos dados: Pelo menos permissões de SELECT em todos os objetos de dados do Unity Catalog utilizados no agente. Os utilizadores só veem os dados a que têm permissão para aceder.
• ACLs do Genie Agent: Pelo menos, permissões CAN VIEW/CAN RUN no Genie Agent. Consulte as ACLs do Genie Agent.

Os novos Agentes Genie são guardados na tua pasta de utilizador por predefinição. Como outros objetos de espaço de trabalho, eles herdam permissões de sua pasta anexa. Você pode usar a estrutura de pastas do espaço de trabalho para compartilhá-las com outros usuários. Consulte o Navegador de espaço de trabalho.

Também pode especificar certos utilizadores ou grupos (incluindo todos os utilizadores da conta) para partilhar num determinado nível de permissões: PODE GERIR, PODE EDITAR, PODE EXECUTAR e PODE VISUALIZAR.

Para partilhar com utilizadores ou grupos específicos:

1. Clique em Share (Partilhar).
2. Introduza os utilizadores ou grupos com quem quer partilhar o agente. Em seguida, clique em Adicionar e defina os níveis de permissão apropriados. Utilizadores individuais e membros de pequenos grupos recebem uma notificação por email a confirmar que o agente foi partilhado.
3. Use o botão Copiar o link no fundo do diálogo de Partilha para obter um link partilhável para o Agente Genie. Os utilizadores privilegiados podem clicar no link para abrir o Agente Genie numa nova aba e colocar perguntas.

Para partilhar com todos os utilizadores da conta:

1. Clique em Share (Partilhar).
2. Selecionar Todos os utilizadores da conta.
3. Defina o nível de permissões apropriado.

Os utilizadores do Agente também podem partilhar conversas individuais. Veja Partilhar uma conversa.

Para partilhar um Agente Genie com utilizadores fora da sua organização usando OpenSharing, consulte Partilhar um Agente Genie usando OpenSharing.

Mais ações do agente

O O menu kebab no canto superior direito de um agente disponibiliza as seguintes ações.

Clonar um Agente Genie

Clonar um Agente Genie cria uma cópia que inclui todo o contexto de configuração e instruções. Clonar é útil quando se quer testar alterações num agente separado ou reutilizar o contexto original num novo. Depois de um agente ser clonado, o novo agente torna-se independente do original. Você pode fazer edições e ajustes sem afetar o original.

Os seguintes elementos são copiados para um Agente Génio clonado:

• Tabelas e configurações
• Instruções gerais
• Exemplo de consultas SQL
• Funções SQL

Os tópicos de chat existentes e os dados do separador Monitor não são copiados para o novo agente.

Para clonar um Agente Génio, faça o seguinte:

1. Abre o Agente Génio que queres clonar.
2. Clique no menu Kebab no canto superior direito do agente.
3. Clique em Clonar.
4. (Opcional) No diálogo Clone , especifique um novo nome e localização da pasta do workspace para o Agente Genie clonado.
5. Clica em Clone para criar o novo agente.

Exportar um Agente Genie como uma vista métrica

Podes exportar o contexto de um Agente Genie como uma vista métrica. Isto cria uma vista métrica baseada nos dados e no contexto semântico configurados no agente.

Para exportar um Genie Agent como vista métrica, faça o seguinte:

1. Abre o Agente Génio que queres exportar.
2. Clique no menu Kebab no canto superior direito do agente.
3. Selecionar Exportar para a vista métrica.
4. Selecione o caminho para a nova vista métrica.
5. (Opcional) No canto superior direito da página para abrir o Código Génio e refinar a definição da vista métrica.
6. Clique em Criar.

Atribuir certificação a um Agente Génio

Pode marcar um Agente Genie como certificado ou obsoleto para indicar o seu estado de confiança ou ciclo de vida. A certificação utiliza a etiqueta governada pelo Unity Catalog system.certification_status . Para a aplicar, tem de ter a permissão ASSIGN na etiqueta.

Para atribuir certificação a um Agente Génio, faça o seguinte:

1. Abre o Agente Génio que queres certificar.
2. Clique no Menu Kebab no canto superior direito do agente, depois selecione Atribuir certificação.
3. Selecione Certificado, Preterido ou Nenhum.
4. Clique em Salvar.

Para mais informações sobre certificação, incluindo como pesquisar por estatuto de certificação, consulte Dados de bandeira como certificados ou obsoletos.

Recursos adicionais

• Para obter orientações sobre boas práticas e ajuda na resolução de problemas, consulte Selecionar um Genie Agent eficaz.
• Para aprender a adicionar exemplos de SQL, instruções e configurar as definições, consulte Qualidade do Tune Genie Agent.
• Para aprender a testar, rever respostas e monitorizar o agente, consulte Testar e monitorizar um Agente Génio.
• Para aprender a usar registos de auditoria para acompanhar a atividade e o uso num Agente Genie, consulte eventos do Agente Genie.
• Veja Usar a API dos Agentes Genie para aprender a importar e exportar Agentes Genie programáticamente e usar a API de conversa do Genie. Veja também a referência da API do Genie.
• Para aprender a criar um sistema multi-agente usando Agentes Personalizados, veja Usar Genie em sistemas multi-agente (Model Serving).