Agentes de dados automáticos para listagens e compartilhamentos

Os Agentes de dados automáticos geram instantaneamente agentes e exibições semânticas baseados em AI para suas listagens de dados e compartilhamentos, transformando dados estáticos em experiências inteligentes de conversação que permitem aos usuários finais consultar seus dados usando linguagem natural, sem necessidade de experiência técnica.

Entender os Agentes de dados automáticos

Em geral, as listagens e os compartilhamentos do Snowflake exigem que os consumidores entendam o esquema subjacente e escrevam consultas SQL para extrair os dados. Os Agentes de dados automáticos resolvem essa dificuldade analisando os metadados e os esquemas de dados das listagens para construir automaticamente os seguintes objetos:

  • Uma exibição semântica: uma representação de dados amigável e compatível com o Cortex Analyst.

  • Um Cortex Agent: uma camada de orquestração de AI que entende o domínio e o contexto específicos dos dados.

Como provedor, essa automação reduz significativamente o tempo necessário para criar uma listagem ou compartilhar um objeto «pronto para Cortex AI», permitindo que você ofereça experiências de dados de conversação sem engenharia manual. Depois que esses objetos forem criados, tudo o que você precisa fazer é anexá-los à sua listagem ou seu compartilhamento; depois disso, os clientes e consumidores finais poderão interagir facilmente com seus dados usando os produtos e recursos do Cortex AI.

Dica

Ao criar listagens prontas para Cortex AI, adicione a categoria Cortex AI ready à sua listagem. Essa categoria facilita que os consumidores encontrem sua listagem.

Principais recursos dos Agentes de dados automáticos

  • A geração com um clique cria automaticamente os objetos de agente e de exibição semântica com base nos metadados e nas estruturas de tabela existentes.

  • A seleção de tabelas e exibições permite que você escolha quais tabelas e exibições incluir ao gerar a exibição semântica, dando a você controle sobre quais dados são expostos pelo agente.

  • A modelagem semântica baseada em AI usa o Semantic View Autopilot para identificar relacionamentos, métricas e dimensões de tabelas.

  • As instruções do agente dinâmico geram personas sensíveis ao contexto e instruções de orquestração derivadas dos metadados da listagem. (Para compartilhamentos diretos, são usadas instruções estáticas.)

  • Os testes integrados permitem que os provedores validem as respostas do agente antes de publicá-las para os consumidores.

  • A publicação contínua anexa os ativos gerados diretamente ao compartilhamento seguro existente, tornando-os instantaneamente disponíveis para os consumidores.

Considerações

Use os Agentes de dados automáticos quando quiser habilitar rapidamente recursos de AI para listagens ou compartilhamentos novos ou existentes que contêm tabelas ou exibições.

Esse recurso é ideal para listagens e compartilhamentos que atendem aos seguintes critérios:

  • A estrutura de dados está bem definida nas tabelas ou exibições.

  • Para listagens, a descrição delas explica claramente o domínio dos dados. (Isso melhora as instruções geradas por AI.)

  • Você não tem exibições semânticas ou agentes existentes anexados manualmente ao compartilhamento.

Limitações

  • Nova geração: gerar um agente novamente substitui os objetos de agente e exibição semântica existentes; as versões anteriores não são preservadas.

  • Local do objeto: os agentes e as exibições semânticas gerados devem ser armazenados no mesmo banco de dados que o conteúdo compartilhado.

  • Geração exclusiva: não será possível usar este recurso se o compartilhamento já contiver agentes, exibições semânticas ou serviços do Cortex Search Service.

  • Tempo de geração: o processo pode levar até 10 minutos, dependendo da complexidade e do tamanho dos esquemas compartilhados.

Trabalhar com Agentes de dados automáticos como provedor

Os Agents de dados automáticos permitem que você configure, teste e gerencie agentes de AI para suas listagens e compartilhamentos diretamente no Provider Studio (para listagens públicas e privadas do Snowflake Marketplace), no Internal Sharing (para listagens do Internal Marketplace) ou na página External sharing (para compartilhamentos diretos sem uma listagem).

Privilégios obrigatórios

Para criar, editar e gerenciar Agentes de dados automáticos, você precisa dos seguintes privilégios:

Privilégios necessários para criar objetos (geração de agente)

Privilégio

Objeto

Objetivo

CORTEX_USER

Banco de dados

Inclui os privilégios que permitem aos usuários chamar as funções de AI do Snowflake e usar LLMs para gerar exibições semânticas. Por padrão, a função CORTEX_USER é concedida à função PUBLIC.

CREATE SEMANTIC VIEW

Esquema

Necessário para criar uma nova exibição semântica

CREATE AGENT

Esquema

Necessário para criar o Cortex Agent

SELECT

Tabelas/exibições no compartilhamento

Necessário em qualquer tabela ou exibição usada na definição da exibição semântica

USAGE

Banco de dados

Necessário para acessar o banco de dados que contém seus objetos compartilhados

USAGE

Esquema

Necessário para acessar o esquema de destino em que os objetos serão criados

Nota

O privilégio SELECT em tabelas é necessário durante a criação da exibição semântica. Entretanto, para consultar uma exibição semântica posteriormente, você só precisa do privilégio SELECT na própria exibição semântica.

Privilégios necessários para adicionar objetos a um compartilhamento (publicação)

Privilégio

Objeto

Objetivo

OWNERSHIP

Compartilhamento

Necessário para conceder privilégios em objetos ao compartilhamento

OWNERSHIP ou MODIFY

Listagem

Necessário para modificar a listagem e enviá-la para aprovação (somente aplicável ao usar listagens)

Quando você adiciona objetos a um compartilhamento, as seguintes concessões são feitas automaticamente:

  • GRANT USAGE ON AGENT ... TO SHARE

  • GRANT SELECT ON SEMANTIC VIEW ... TO SHARE

  • GRANT REFERENCES ON SEMANTIC VIEW ... TO SHARE

Privilégios necessários para gerenciar objetos (gerar novamente/excluir)

Privilégio

Objeto

Objetivo

OWNERSHIP

Agente

Necessário para descartar ou substituir o agente (concedido automaticamente ao criador)

OWNERSHIP

Exibição semântica

Necessário para descartar ou substituir a exibição semântica (concedido automaticamente ao criador)

Fluxo de trabalho dos Agentes de dados automáticos

  1. Iniciar Agentes de dados automáticos.

  2. Use SQL para verificar os objetos criados.

  3. Testar o agente de dados.

  4. Opcional: gerencie o agente de dados.

  5. Anexar o Agente de dados automático à sua listagem ou compartilhamento.

Iniciar Agentes de dados automáticos

Para provedores, o processo de configuração dos Agentes de dados automáticos analisa sua listagem ou seu compartilhamento e gera os objetos necessários do Cortex AI. Você pode usar os Agentes de dados automáticos com listagens do Snowflake Marketplace, listagens do Internal Marketplace (organizacionais) ou compartilhamentos diretos. Você deve fornecer todas as informações necessárias antes de começar a usar os Agentes de dados automáticos.

Os exemplos abaixo descrevem como configurar os Agentes de dados automáticos em uma listagem do Snowflake Marketplace, uma listagem do Internal Marketplace ou um compartilhamento direto. Selecione a opção apropriada.

Nota

O assistente de geração automática está disponível apenas no Snowsight.

Opção 1. Iniciar os Agentes de dados automáticos em uma listagem do Snowflake Marketplace

Para as etapas abaixo, consideramos que você já criou uma listagem do Snowflake Marketplace e anexou um produto de dados a ela. Para obter mais informações, consulte Criação e gerenciamento de uma listagem.

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Marketplace » Provider Studio.

  3. Na guia Listings, selecione a listagem pública que você deseja configurar.

  4. Na guia Secure share da listagem, no banner Add an Agent to your listing, selecione Get started.

    Uma imagem do banner de integração do agente.

    Nota

    A listagem deve ter um compartilhamento anexado. Caso contrário, a guia Secure share não estará disponível. A listagem também deve incluir todas as informações necessárias. Caso contrário, o botão Get started estará desabilitado.

  5. Na caixa de diálogo de configuração, insira os seguintes valores:

    • Agent Display Name: digite um nome para o agente (o padrão é o título da listagem).

    • Location: selecione o esquema de destino para os objetos gerados.

    • Tables/Views: selecione as tabelas e exibições a serem incluídas na exibição semântica. Você pode escolher um subconjunto das tabelas e exibições disponíveis no compartilhamento para controlar quais dados o agente pode acessar.

      Nota

      Este esquema deve estar no mesmo banco de dados que os dados compartilhados.

  6. Selecione Create.

O processo de geração começa imediatamente. Você pode visualizar o status de cada etapa, incluindo recuperação dos metadados, geração da exibição semântica e criação do agente. Esse processo pode levar vários minutos.

Uma imagem do progresso do processo de geração.

Opção 2. Iniciar os Agentes de dados automáticos em uma listagem do Internal Marketplace

Para as etapas abaixo, consideramos que você já criou uma listagem do Internal Marketplace e anexou um produto de dados a ela. Para obter mais informações, consulte Criação de uma listagem organizacional.

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data sharing » Internal sharing.

  3. Na página Internal sharing, selecione a listagem que você deseja configurar.

  4. Na guia Secure share da listagem, no banner Add an Agent to your listing, selecione Get started.

    Uma imagem do banner de integração do agente.

    Nota

    A listagem deve ter um compartilhamento anexado. Caso contrário, a guia Secure share não estará disponível. A listagem também deve incluir todas as informações necessárias. Caso contrário, o botão Get started estará desabilitado.

  5. Na caixa de diálogo de configuração, insira os seguintes valores:

    • Agent Display Name: digite um nome para o agente (o padrão é o título da listagem).

    • Location: selecione o esquema de destino para os objetos gerados.

    • Tables/Views: selecione as tabelas e exibições a serem incluídas na exibição semântica. Você pode escolher um subconjunto das tabelas e exibições disponíveis no compartilhamento para controlar quais dados o agente pode acessar.

      Nota

      Este esquema deve estar no mesmo banco de dados que os dados compartilhados.

  6. Selecione Create.

O processo de geração começa imediatamente. Você pode visualizar o status de cada etapa, incluindo recuperação dos metadados, geração da exibição semântica e criação do agente. Esse processo pode levar vários minutos.

Uma imagem do progresso do processo de geração.

Opção 3. Iniciar os Agentes de dados automáticos em um compartilhamento direto

Você também pode gerar um Agente de dados automático em um compartilhamento direto que não esteja associado a uma listagem.

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data sharing » External sharing.

  3. Na guia Shared by your account, selecione o compartilhamento que você deseja configurar.

  4. No banner Add an Agent to your share, selecione Get started.

  5. Na caixa de diálogo de configuração, insira os seguintes valores:

    • Agent Display Name: digite um nome para o agente.

    • Location: selecione o esquema de destino para os objetos gerados.

    • Tables/Views: selecione as tabelas e exibições a serem incluídas na exibição semântica. Você pode escolher um subconjunto das tabelas e exibições disponíveis no compartilhamento para controlar quais dados o agente pode acessar.

      Nota

      Este esquema deve estar no mesmo banco de dados que os dados compartilhados.

  6. Selecione Create.

O processo de geração começa imediatamente. Você pode visualizar o status de cada etapa, incluindo recuperação dos metadados, geração da exibição semântica e criação do agente. Esse processo pode levar vários minutos.

Verificar os objetos criados usando SQL

Você pode usar SQL para verificar os objetos criados.

-- Verify the agent was created
SHOW AGENTS IN SCHEMA my_database.my_schema;

-- Verify the semantic view was created
SHOW SEMANTIC VIEWS IN SCHEMA my_database.my_schema;

Testar o agente de dados

Antes de publicar, verifique se o agente responde com precisão às perguntas sobre seus dados.

  1. Na seção Agent da sua listagem ou compartilhamento, localize o agente gerado.

  2. Selecione um dos botões Try disponíveis para abrir o Cortex Studio.

    Você pode testar a resposta do agente ou validar a exibição semântica.

  3. Insira consultas em linguagem natural relacionadas aos seus dados, por exemplo, «Qual foi o volume médio de vendas no mês passado?».

  4. Revise o SQL gerado e a resposta textual para verificar a precisão.

  5. Se forem necessários ajustes, edite a exibição semântica manualmente ou atualize a descrição da sua listagem e, em seguida, gere novamente o agente.

Gerenciar agentes de dados

Gerar novamente um agente

Se o seu esquema de dados for alterado ou se você atualizar a descrição da listagem para melhorar o contexto do agente, você poderá gerar novamente o agente.

Cuidado

A nova geração descarta o agente e a exibição semântica existentes e cria novas versões. Todas as edições manuais feitas na exibição semântica anterior são perdidas.

  1. Na seção Agent, no menu More actions (…), selecione Regenerate agent.

  2. Confirme a ação para iniciar o processo.

Descartar um agente

Você pode descartar agentes que não estão anexados a compartilhamentos. Se o agente que você deseja descartar estiver anexado a um compartilhamento, será necessário removê-lo do compartilhamento antes de descartá-lo.

  1. Na seção Agent, selecione o menu More actions (…).

  2. Selecione Drop agent.

  3. Confirme a remoção do agente e da exibição semântica de sua conta.

Anexar o Agente de dados automático à sua listagem ou compartilhamento

Para disponibilizar o agente aos consumidores, anexe-o ao compartilhamento seguro.

  1. Navegue até a guia Secure share da sua listagem, ou até a página de detalhes do compartilhamento para um compartilhamento direto.

  2. Na seção Agent, selecione Add to secure share.

    Uma imagem do botão para adicionar ao compartilhamento seguro.

  3. Revise a caixa de diálogo de confirmação, que indica que o agente e a exibição semântica serão concedidos ao compartilhamento.

  4. Clique em Add.

    Depois que o agente for adicionado, as atualizações feitas nesses objetos em sua conta ficarão imediatamente disponíveis para os consumidores que tiverem acesso à listagem ou ao compartilhamento.

Usar Agentes de dados automáticos como consumidor

Como consumidor, você pode usar o Agente de dados automático para consultar seus dados em linguagem natural.

Para listagens do Snowflake Marketplace, siga estas etapas:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Marketplace » Snowflake Marketplace.

  3. Selecione a listagem pronta para Cortex AI que você deseja acessar e Get a listagem, caso ainda não tenha feito isso.

  4. Selecione Open e, depois, o nome do agente para testá-lo.

Para listagens do Internal Marketplace, siga estas etapas:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Catalog » Internal Marketplace.

  3. Selecione a listagem pronta para Cortex AI que você deseja acessar e Get a listagem, caso ainda não tenha feito isso.

  4. Selecione Open e, depois, o nome do agente para testá-lo.

Para listagens compartilhadas de modo privado, siga estas etapas:

  1. Faça login no Snowsight.

  2. No menu de navegação, selecione Data sharing » External sharing.

  3. Na guia Shared with you, selecione a listagem ou o compartilhamento pronto para Cortex AI que você deseja acessar e execute Get nele, caso ainda não tenha feito isso.

  4. Selecione Open e, depois, o nome do agente para testá-lo.