Use respostas certificadas nos espaços do Genie

Visualização

Este recurso está em visualização pública.

Este artigo define respostas certificadas e explica como usá-las para aumentar a confiança nas respostas fornecidas em um espaço genie.

Quais são as respostas certificadas?

As respostas certificadas permitem que o senhor defina explicitamente consultas SQL validadas e parametrizadas como receitas para responder a perguntas comuns. Eles podem reduzir a probabilidade de usuários não técnicos receberem respostas enganosas, incorretas ou difíceis de interpretar. As respostas certificadas ajudam o espaço genie a fornecer respostas precisas a perguntas comuns e permitem que os usuários saibam quando a resposta recebida foi verificada.

Resposta de resposta certificada

Observação

As respostas certificadas não substituem todas as outras instruções. A Databricks recomenda o uso de respostas certificadas somente para perguntas recorrentes e bem estabelecidas. Eles fornecem respostas exatas a perguntas específicas e não são reutilizados pelo Assistente para abordar perguntas adjacentes.

Por que criar respostas certificadas?

genie Os espaços retornam o resultado de uma consulta gerada no site SQL para responder às perguntas dos usuários. Os usuários corporativos podem incluir jargões que são difíceis de analisar para o modelo de linguagem ampla (LLM) que gera consultas. Suponha que um usuário comercial forneça um prompt do tipo: "Mostre-me o pipeline aberto em nossa região APAC". Se open pipeline não corresponder diretamente a um campo em uma das tabelas do seu espaço genie, o usuário poderá obter um conjunto de resultados vazio acompanhado de uma consulta gerada em SQL, como na resposta a seguir:

Resposta de resultado vazia

Para a maioria dos usuários corporativos, é difícil interpretar ou solucionar problemas dessa resposta. genie Os autores do espaço podem definir respostas certificadas para fornecer respostas confiáveis a perguntas como essa.

Definir uma resposta certificada

Para definir uma resposta certificada, identifique a pergunta que o senhor espera que os usuários façam. Em seguida, faça o seguinte:

  1. Definir e testar uma consulta SQL que responda à pergunta.

    A seguir, um exemplo de consulta criada para responder à pergunta do exemplo anterior. A tabela que essa consulta retorna inclui resultados de todas as regiões nos dados.

    SELECT
    o.id AS `OppId`,
    a.region__c AS `Region`,
    o.name AS `Opportunity Name`,
    o.forecastcategory AS `Forecast Category`,
    o.stagename,
    o.closedate AS `Close Date`,
    o.amount AS `Opp Amount`
    FROM
    users.user_name.opportunity o
    JOIN catalog.schema.accounts a ON o.accountid = a.id
    
    WHERE
    o.forecastcategory = 'Pipeline' AND
    o.stagename NOT LIKE '%closed%';
    
  2. Definir uma função do Unity Catalog.

    Sua função do Unity Catalog deve parametrizar a consulta e produzir resultados que correspondam às condições específicas que um usuário possa consultar.

    Consulte Criar uma função de tabela SQL para saber como definir uma função do Unity Catalog.

    A função a seguir recebe uma lista de regiões e retorna uma tabela. Os comentários fornecidos nas definições de função são essenciais para instruir o espaço genie sobre quando e como invocar essa função. Esse exemplo inclui comentários na definição do parâmetro da função e comentários definidos na função da tabela SQL que explicam o que a função faz.

    • Comentários de parâmetros: A função open_opps_in_region espera um array de strings como parâmetro. O comentário inclui um exemplo da entrada esperada. Se nenhum parâmetro for fornecido, o valor de default será NULL.

    • Comentários de função: O comentário na função da tabela SQL explica o que a função faz.

    A consulta SQL associada foi ajustada para incluir a função Unity Catalog na cláusula WHERE.

    CREATE OR REPLACE FUNCTION users.user_name.open_opps_in_region (
    regions ARRAY<STRING> COMMENT 'List of regions.  Example: ["APAC", "EMEA"]' DEFAULT NULL
    ) RETURNS TABLE
    COMMENT 'Addresses questions about the pipeline in a region by returning a list of all the open opportunities.'
    RETURN
    
    SELECT
        o.id AS `OppId`,
        a.region__c AS `Region`,
        o.name AS `Opportunity Name`,
        o.forecastcategory AS `Forecast Category`,
        o.stagename,
        o.closedate AS `Close Date`,
        o.amount AS `Opp Amount`
    FROM
        catalog.schema.accounts.opportunity o
        JOIN catalog.schema.accounts a ON o.accountid = a.id
    WHERE
        o.forecastcategory = 'Pipeline' AND
        o.stagename NOT LIKE '%closed%' AND
        isnull(open_opps_in_region.regions) OR array_contains(open_opps_in_region.regions, region__c);
    

    Quando o senhor executa o código para criar uma função, ela é registrada no esquema ativo no momento pelo site default. Consulte Funções SQL personalizadas no Unity Catalog.

  3. Adicionar resposta certificada.

    Depois de ser publicada como uma função Unity Catalog, um usuário com pelo menos CAN EDIT permissão no espaço genie pode adicioná-la nas Instruções tab do espaço genie.

    Botão Adicionar resposta certificada

Permissões necessárias

genie Os autores de espaço com pelo menos a permissão CAN EDIT em um espaço genie podem adicionar ou remover respostas certificadas.

genie os usuários do espaço devem ter permissão CAN USE no catálogo e no esquema que contém a função. Para invocar uma resposta certificada, o senhor deve ter permissão EXECUTE na função no Unity Catalog. Os objetos protegíveis do Unity Catalog herdam as permissões de seus contêineres principais. Consulte Objetos securizáveis no Unity Catalog.

Para simplificar o compartilhamento em um espaço genie, o Databricks recomenda a criação de um esquema dedicado para conter todas as funções que o senhor deseja usar no espaço genie.