Visão geral de Snowflake Intelligence¶

Modelos e regiões com suporte¶

O Snowflake Intelligence oferece suporte aos modelos a seguir. Você poderá usá-los desde que a conta tenha acesso a eles. Para obter mais informações, consulte Controle o acesso ao modelo.

• Claude 4.0

• Claude 3.7

• Claude 3.5

• GPT 4.1

Os modelos listados podem não estar disponíveis em todas as regiões, mas você pode usar o Snowflake Intelligence em qualquer nuvem ou região por meio da inferência entre regiões do Cortex. Isso inclui nuvens e regiões onde os modelos não estão disponíveis. Para obter mais informações sobre como configurar a inferência entre regiões do Cortex, consulte Inferência entre regiões.

• AWS US: na AWS, o Claude 4 oferece a mais alta qualidade e o melhor desempenho de velocidade. Recomendamos que você configure a inferência entre regiões do Cortex para aws_us para usar o Claude 4 com o melhor desempenho. Sem a inferência entre regiões do Cortex, você fica restrito a usar o Claude 3.5 na região aws_us.

• Azure US: se a sua região do Snowflake Intelligence é EAST US, você pode usar o GPT 4.1 sem a inferência entre regiões do Cortex. Outras combinações de região e modelo exigem a configuração da inferência entre regiões do Cortex para azure_us.

• AWS EU: você pode usar o Claude 4 nessa região, desde que configure a inferência entre regiões do Cortex para aws_eu.

Configuração do Snowflake Intelligence¶

Para configurar o Snowflake Intelligence para os usuários, você deve configurar privilégios de agentes.

1. Crie um banco de dados. Ele armazena o objeto de configuração e os outros objetos usados para oferecer suporte ao Snowflake Intelligence.

   CREATE DATABASE IF NOT EXISTS snowflake_intelligence;
   GRANT USAGE ON DATABASE snowflake_intelligence TO ROLE PUBLIC;
   

   Copy

2. Depois que você configurar o banco de dados snowflake_intelligence, use os comandos SQL a seguir para criar um esquema de armazenamento de agentes e torná-los detectáveis a todos.

   CREATE SCHEMA IF NOT EXISTS snowflake_intelligence.agents;
   GRANT USAGE ON SCHEMA snowflake_intelligence.agents TO ROLE PUBLIC;
   

   Copy

3. Conceda o privilégio CREATE AGENT no esquema agents a qualquer função que tenha que criar agentes do Snowflake Intelligence.

   GRANT CREATE AGENT ON SCHEMA snowflake_intelligence.agents TO ROLE <role>;
   

   Copy

Criação de agente¶

Crie um agente na página de administração de agentes na Snowsight UI para responder a perguntas e fornecer insights. O agente usa uma exibição semântica, um modelo semântico, um Cortex Search Service ou uma combinação deles para fornecer as respostas. Você pode criar um agente básico que não usa nenhuma dessas ferramentas, mas ele usa exclusivamente o modelo base para as respostas. Como resultado, o agente não tem acesso aos dados da sua conta Snowflake e tem contexto limitado para as respostas.

A exibição ou o modelo semântico é usado para tabelas e dados estruturados no Snowflake. Esses dados podem estar em qualquer tabela, desde que ela possa ser consultada pelo Snowflake. O Cortex Search é útil para indexar e pesquisar partes de dados com muito texto, como documentos, conversas e transcrições.

Adição de ferramentas personalizadas ao agente¶

Ao adicionar ferramentas personalizadas, você estende a funcionalidade dos agentes. Com ferramentas personalizadas, o agente pode chamar procedimentos armazenados e funções que você definiu para executar ações ou fazer cálculos. Para obter informações sobre procedimentos e funções, consulte Como estender o Snowflake com funções e procedimentos.

Para adicionar uma ferramenta personalizada, siga estas etapas:

1. Faça login no Snowsight.

2. Selecione AI & ML na navegação à esquerda.

3. Selecione Agents.

4. Selecione o agente na lista de agentes.

5. Selecione Edit.

6. Selecione Tools.

7. Localize o Custom tools e selecione o respectivo botão + Add.

8. Em Name, insira um nome para a ferramenta personalizada.

9. Em Resource type, selecione se a ferramenta personalizada é uma função ou um procedimento. Para obter informações de quando usar uma função ou um procedimento, consulte Escolha se deseja escrever um procedimento armazenado ou uma função definida pelo usuário.

10. Em Custom tool identifier, selecione a função ou o procedimento existente que você quer adicionar como uma ferramenta personalizada.

11. Os parâmetros relacionados à função ou ao procedimento aparecem automaticamente. Você pode adicionar manualmente os parâmetros para a ferramenta personalizada inserindo nome, tipo, descrição e indicando se o parâmetro é obrigatório. Você também pode modificar os parâmetros que são preenchidos automaticamente.

12. Em Warehouse, selecione o warehouse que o agente usa para executar a ferramenta personalizada. Você deve selecionar um warehouse manualmente.

13. Em Description, descreva a ferramenta personalizada e como usá-la.

Depois de criar a ferramenta personalizada, certifique-se de que os usuários recebam os privilégios USAGE para a função ou o procedimento que você adicionou como uma ferramenta personalizada. Ao utilizar procedimentos armazenados, o Snowflake Intelligence preserva se o procedimento é executado com direitos do proprietário ou do autor da chamada. Para obter informações sobre direitos do proprietário e do autor da chamada, consulte Procedimentos armazenados com direitos do chamador e direitos do proprietário.

Uso do agente¶

Depois de criar um agente, você poderá fazer perguntas para receber insights dos seus dados. O agente pode responder a perguntas como estas:

• Qual é o valor médio das vendas no último trimestre?

• Que produto vendeu mais unidades no mês passado?

• Você pode me mostrar a tendência de vendas do último ano?

Ele também pode apresentar visualizações como estas:

• Gráfico de barras

• Gráfico de linhas

• Gráfico de pizza

Para usar o agente, siga estas etapas:

1. Na navegação à esquerda, selecione AI & ML ou navegue até a página de destino do Snowflake Intelligence.

2. Selecione Snowflake Intelligence. A navegação muda o foco para o Snowflake Intelligence. Recomendamos abrir uma nova guia do navegador especificamente para o Snowsight durante o uso do aplicativo Snowflake Intelligence. Ao usar guias diferentes do navegador, você pode alternar entre a interface do Snowsight e o aplicativo Snowflake Intelligence.

3. Na janela de bate-papo, selecione o agente no menu suspenso.

4. Selecione a fonte de dados que o agente usará.

5. Faça uma pergunta ao agente ou peça que ele apresente uma visualização dos seus dados.

Modificação de agente existente¶

Para modificar a configuração de um agente existente, conclua as seguintes etapas:

1. Na navegação à esquerda, selecione AI & ML.

2. Selecione Agents.

3. Na lista de agentes, selecione o agente que quer modificar. Isso abre um painel que inclui todos os detalhes de configuração do agente.

4. Selecione Edit.

5. Modifique os detalhes de configuração desejados.

6. Selecione Save.

Tutorial – Criação de agente que usa documentação do Snowflake¶

Este tutorial mostra como criar um agente que usa a documentação do Snowflake como base de conhecimento. O agente pode responder a perguntas sobre os recursos e as melhores práticas do Snowflake.

1. Instale a Cortex Knowledge Extension for Snowflake Documentation do Snowflake Marketplace selecionando Get.

   • No prompt de instalação, anote o nome do banco de dados em que a Cortex Knowledge Extension está instalada. Ele será usado mais adiante para criar o agente.

2. Adicione privilégios para o banco de dados recém-criado à função que está criando o agente. Esses privilégios são necessários para acessar o banco de dados.

   GRANT IMPORTED PRIVILEGES ON DATABASE <database_name> TO ROLE <role>;
   

   Copy

3. Crie um agente seguindo as etapas em Criação de agente que usa o Cortex Search Service com a seguinte modificação:

   • Ao adicionar um Cortex Search Service, selecione o banco de dados recém-criado e o esquema SHARED.

   • Em Search service, adicione o serviço de pesquisa CKE_SNOWFLAKE_DOCS_SERVICE.

   • Selecione Add.

4. Salve o agente.

5. Navegue até a página de destino do Snowflake Intelligence.

6. Selecione o agente que você criou e a Cortex Knowledge Extension for Snowflake Documentation como a fonte.

7. Faça perguntas ao agente sobre a documentação do Snowflake.

Configuração do Snowflake Intelligence com AWS PrivateLink¶

O Snowflake Intelligence oferece suporte à integração com o AWS PrivateLink para estabelecer uma conexão privada entre sua nuvem virtual privada (VPC) e o Snowflake Intelligence. A configuração do AWS PrivateLink requer a configuração da resolução DNS correta para direcionar o tráfego ao serviço Snowflake Intelligence por meio dessa conexão privada.

Observe que o AWS PrivateLink não é um serviço oferecido pela Snowflake. É um serviço AWS ao qual o Snowflake oferece suporte para uso com sua conta Snowflake.

Solução de problemas¶

Se você encontrar erros como table / search service / stage does not exist, talvez haja problemas de privilégio. Verifique se os seguintes privilégios estão definidos corretamente:

• Para cada modelo semântico:

  • A função padrão do usuário recebe USAGE no banco de dados e no esquema da área de preparação ou exibição do modelo semântico e da tabela.

  • A função padrão do usuário recebe READ na área de preparação que armazena o arquivo do modelo semântico.

  • Se você usa uma exibição, a função padrão do usuário recebe REFERENCES com base na exibição semântica.

  • A função padrão do usuário recebe SELECT para cada tabela definida no modelo ou exibição semânticos.

• Para cada Cortex Search Service:

  • A função padrão do usuário recebe USAGE no banco de dados e no esquema do Cortex Search Service.

  • O usuário recebe USAGE no Cortex Search Service.