Visão geral de Snowflake Intelligence¶

Use o Snowflake Intelligence para receber insights e tomar medidas com base nos dados em sua organização. Com o Snowflake Intelligence, você pode:

Criar gráficos e receber respostas instantâneas usando a linguagem natural. Descubra tendências e analise dados sem precisar de conhecimento técnico nem esperar por painéis personalizados.
Acessar e analisar milhares de fontes de dados, incluindo dados estruturados e não estruturados juntos. Conecte insights de planilhas, documentos, imagens e bancos de dados simultaneamente.

O Snowflake Intelligence usa agentes, que são modelos de AI conectados a uma ou mais exibições semânticas, modelos semânticos, Cortex Search Services e ferramentas. Os agentes podem responder a perguntas, fornecer insights e apresentar visualizações. O Snowflake Intelligence é baseado no Cortex AISQL, Cortex Analyst e Cortex Search.

Consulte as seções a seguir para configurar o Snowflake Intelligence e começar a usá-lo para obter valor dos seus dados. Para acessar um guia de início rápido sobre o Snowflake Intelligence, consulte Introdução ao 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.5
Claude 4.0
Claude 3.7
Claude 3.5
GPT 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.

Ao criar um agente, recomendamos selecionar Auto para o modelo. Isso permite que o Snowflake Intelligence selecione automaticamente o modelo de maior qualidade para sua conta e o aprimore de maneira automática à medida que novos modelos se tornam disponíveis.

AWS US - In AWS, Claude 4+ offers the highest quality and best speed performance. We recommend that you set up Cortex Cross-region inference for aws_us to use Claude 4 and get the best performance. Without Cortex Cross-region inference, you are restricted to using Claude 3.5 in aws_us.
Azure US - If you are using Snowflake Intelligence in East US, you can use GPT 4.1+ without Cortex Cross-region inference. Other region and model combinations require Cortex Cross-region inference setup for azure_us.
AWS EU - You can use Claude 4+ in this region as long as you configure Cortex Cross-region inference for aws_eu.
AWS APJ - You can use Claude 4+ in this region as long as you configure Cortex Cross-region inference for aws_apj.

Configuração do Snowflake Intelligence¶

To set up Snowflake Intelligence for your users, do the following:

Nota

A função ACCOUNTADMIN é a única função que tem o privilégio CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT necessário para criar um objeto Snowflake Intelligence.

Crie um objeto Snowflake Intelligence. O objeto Snowflake Intelligence é um objeto único destinado a gerenciar todos os agentes utilizados com o Snowflake Intelligence em sua conta. Você só pode ter um objeto Snowflake Intelligence em sua conta.
Add agents to the Snowflake Intelligence object.
Privilégios GRANT USAGE para o objeto Snowflake Intelligence.

Create a Snowflake Intelligence object¶

Você pode usar a UI do Snowflake Intelligence ou o SQL para criar um objeto Snowflake Intelligence.

O Snowflake cria automaticamente o objeto Snowflake Intelligence quando você modifica as configurações do Snowflake Intelligence pela primeira vez. Quando criado com o uso da UI, o objeto Snowflake Intelligence é nomeado SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT. Você não pode especificar um nome diferente.

Faça login na Snowsight.

No menu de navegação, selecione AI & ML » Agents.

Selecione a guia Snowflake Intelligence.

Selecione Open settings. O objeto Snowflake Intelligence será criado automaticamente se ainda não existir. É possível então adicionar agentes ao objeto.
Para criar um objeto Snowflake Intelligence, você pode usar o seguinte comando:
CREATE SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT;
Copy

Adicionar agentes¶

O objeto Snowflake Intelligence é um objeto de nível de conta que contém uma lista de agentes. Você pode adicionar ou remover agentes desse objeto para criar uma lista personalizada de agentes para seus usuários. Para obter mais informações sobre como adicionar ou remover agentes, consulte Configure the visibility of agents in Snowflake Intelligence.

Grant Snowflake Intelligence privileges¶

Os seguintes privilégios controlam o acesso a objetos Snowflake Intelligence:

CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT: privilégio em nível de conta que permite criar um objeto Snowflake Intelligence. Esse privilégio é concedido a ACCOUNTADMIN por padrão.

Para conceder esse privilégio a outra função, execute o seguinte comando:
```
GRANT CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT TO ROLE <role_name>;
```
Copy
USAGE: privilégio em nível de objeto que permite aos usuários visualizar a lista de agentes adicionados ao objeto Snowflake Intelligence e ver os valores de configuração.

To grant this privilege, run the following command:
```
GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE <role_name>;
```
Copy
ALTER: privilégio em nível de objeto que permite aos usuários adicionar ou remover agentes do objeto Snowflake Intelligence e alterar os valores de configuração. Os administradores da conta têm esse privilégio por padrão.

To grant this privilege, run the following command:
```
GRANT MODIFY ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE <role_name>;
```
Copy

Para tornar o objeto Snowflake Intelligence visível para todos os seus usuários, conceda privilégios USAGE no objeto à função PUBLIC:

GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE PUBLIC;

Copy

Como ADMIN, você também tem privilégios ALTER no objeto Snowflake Intelligence. Isso permite adicionar ou remover agentes do objeto para criar uma lista selecionada de agentes para seus usuários.

To set up Snowflake Intelligence for your users, you must configure agent privileges. For information about the privileges required for agents, see Requisitos de controle de acesso.

Importante

Por padrão, o Snowflake Intelligence usa a função e o warehouse padrão do usuário. Quando você convida outras pessoas para usar o Snowflake Intelligence, certifique-se de que elas tenham definido uma função e um warehouse padrão.

Nota

Todas as consultas do Snowflake Intelligence usam as credenciais do usuário. Todas as políticas de controle de acesso e mascaramento de dados baseadas em função associadas ao usuário são automaticamente aplicadas a todas as interações e conversas com o agente.

Criação de agente¶

Para começar, crie um agente com o qual os usuários possam interagir no Snowflake Intelligence. Para obter informações sobre como criar um agente, consulte Criação de agente.

Configure the visibility of agents in Snowflake Intelligence¶

Se você não criou um objeto Snowflake Intelligence e adicionou agentes a ele, os usuários verão todos os agentes aos quais têm acesso em sua conta.

Para garantir uma experiência ideal, crie uma lista personalizada de agentes adicionando-os ao objeto Snowflake Intelligence. Isso permite que você controle quais agentes aparecem na interface do Snowflake Intelligence para todos os usuários.

Para verificar se o objeto Snowflake Intelligence foi criado em sua conta, use o seguinte comando:

SHOW SNOWFLAKE INTELLIGENCES;

Copy

Nota

Apenas um objeto Snowflake Intelligence pode existir em uma conta.

Managing agents with the Snowflake Intelligence object¶

Para adicionar agentes ao objeto Snowflake Intelligence, use o seguinte comando:

ALTER SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT ADD AGENT <db.schema.agent_name>;

Copy

Para remover agentes do objeto Snowflake Intelligence, use o seguinte comando:

ALTER SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT DROP AGENT <db.schema.agent_name>;

Copy

Nota

Qualquer usuário ou administrador com os privilégios corretos de banco de dados e esquema pode criar agentes. No entanto, os agentes não são adicionados automaticamente ao objeto Snowflake Intelligence. Os usuários devem ter o privilégio ALTER no objeto Snowflake Intelligence e os privilégios USAGE no agente para adicionar um agente ao objeto Snowflake Intelligence.

Os administradores devem ter o privilégio USAGE no agente para adicioná-lo ao objeto Snowflake Intelligence.

Lógica de visibilidade do agente¶

O Snowflake Intelligence usa a seguinte lógica para determinar quais agentes são visíveis para os usuários:

Se o objeto Snowflake Intelligence existir e contiver um ou mais agentes, os usuários verão os agentes individuais dessa lista selecionada aos quais têm acesso.
Se o objeto Snowflake Intelligence existir, mas não contiver nenhum agente AND e o esquema SNOWFLAKE_INTELLIGENCE.AGENTS existir com um ou mais agentes, os usuários verão os agentes do esquema SNOWFLAKE_INTELLIGENCE.AGENTS. Isso garante que o Snowflake Intelligence não apresente problemas caso você ainda não tenha migrado seus agentes.
Se o objeto Snowflake Intelligence não existir ou não contiver nenhum agente AND e o esquema SNOWFLAKE_INTELLIGENCE.AGENTS não existir ou não contiver nenhum agente, os usuários verão todos os agentes aos quais têm acesso na conta.

Migração do esquema SNOWFLAKE_INTELLIGENCE.AGENTS obsoleto¶

Importante

O esquema SNOWFLAKE_INTELLIGENCE.AGENTS está obsoleto. Se você estiver usando esse esquema atualmente, recomendamos migrar para o objeto Snowflake Intelligence.

Se você estiver usando o esquema SNOWFLAKE_INTELLIGENCE.AGENTS, seus agentes continuarão funcionando. No entanto, a migração para o objeto Snowflake Intelligence oferece os seguintes benefícios:

Flexibilidade: crie e gerencie agentes em qualquer lugar da sua conta sem precisar centralizá-los em um único esquema.

Gerenciamento de permissões aprimorado: separe a capacidade de criar agentes da capacidade de publicá-los no Snowflake Intelligence.

Evite conflitos de nome**: elimine possíveis conflitos com o nome do esquema SNOWFLAKE_INTELLIGENCE.AGENTS.

Gerenciamento de visibilidade de agentes mais fácil: use um único objeto para controlar quais agentes aparecem para todos os usuários.

Certifique-se de ter criado um objeto Snowflake Intelligence antes de migrar seus agentes. Para obter informações sobre como criar um objeto Snowflake Intelligence, consulte Configuração do Snowflake Intelligence.

Depois de criar um objeto, use o seguinte código para adicionar um agente ao objeto Snowflake Intelligence:

ALTER SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT ADD AGENT SNOWFLAKE_INTELLIGENCE.AGENTS.<agent_name>;

Copy

Você pode renomear ou descartar o banco de dados SNOWFLAKE_INTELLIGENCE ou o esquema AGENTS após a migração. Para obter mais informações, consulte ALTER SCHEMA.

Configure Snowflake Intelligence with private connectivity¶

Snowflake Intelligence supports integration with AWS Privatelink and Azure Private Link to establish a private connection between your Virtual Private Cloud (VPC) or virtual network (VNet) and Snowflake Intelligence. Configuring private connectivity requires setting up the correct DNS resolution to direct traffic to the Snowflake Intelligence service through this private connection.

Note that AWS PrivateLink and Azure Private Link are not services provided by Snowflake. They are an AWS service and Microsoft service, respectively, that Snowflake supports to use with your Snowflake account.

Pré-requisitos¶

Complete the following prerequisites before connecting to Snowflake Intelligence with private connectivity.

Set up AWS PrivateLink by following the instructions in AWS PrivateLink e Snowflake or Azure Private Link by following the instructions in Azure Private Link e Snowflake.
Certifique-se de que um :code: regionless-snowsight-privatelink-url esteja disponível chamando a função SYSTEM$GET_PRIVATELINK_CONFIG por meio da função do sistema ACCOUNTADMIN.

Importante

Snowflake Intelligence exclusively uses the regionless URL format for private connectivity access. Unlike other private connectivity URLs used for Snowflake, you should not include a region identifier, such as us-west-2, in the hostname. Any attempts to connect using a region-specific URL will result in a failure.

Conexão ao Snowflake Intelligence¶

Conecte-se ao Snowflake Intelligence configurando o DNS para que o Snowflake Intelligence use o subdomínio.

Create a CNAME record in your private DNS zone, privatelink.snowflakecomputing.com, that maps the following URL to the DNS name of your VPC or VNET endpoint.
```
si-<org-acct>.privatelink.snowflakecomputing.com
```
Copy

Após a conclusão da configuração, os usuários da sua rede poderão acessar o Snowflake Intelligence navegando até o seguinte URL:

https://si-<org-acct>.privatelink.snowflakecomputing.com

Copy

A conexão é roteada com segurança pela conexão privada.

User authentication with private connectivity¶

Users accessing Snowflake Intelligence with private connectivity use the standard Snowflake authentication process, which requires them to provide their account identifier, username, and password on the login page.

Use o servidor MCP gerenciado pelo Snowflake para conectar-se aos seus agentes.¶

Qualquer agente que você criar no Snowflake, ou as ferramentas às quais o agente está conectado, pode ter um ponto de extremidade gerenciado para que outros sistemas se conectem ao MCP. Isso proporciona uma camada de integração perfeita para ferramentas como Claude Desktop, Langgraph e outras que se integram ao MCP.

O servidor MCP fornece uma interface baseada em padrões que permite que os agentes de AI descubram e invoquem ferramentas, como Cortex Analyst e Cortex Search, e recuperem os dados de que precisam. Para obter mais informações, consulte Servidor MCP gerenciado pelo Snowflake.

Update Snowflake Intelligence settings¶

Você pode modificar as configurações da interface do Snowflake Intelligence por meio da qual os usuários interagem com os Cortex Agents.

Faça login na Snowsight.
No menu de navegação, selecione AI & ML » Agents.
Selecione a guia Snowflake Intelligence.
Select Open settings.
Na seção General settings, você pode modificar as seguintes configurações:
- Brand display name: The name of the Snowflake Intelligence interface that is displayed to users.
- Welcome message: a mensagem exibida quando os usuários abrem a interface do Snowflake Intelligence pela primeira vez.
- Primary domain: o domínio que os usuários usam para acessar o Snowflake Intelligence.
Selecione Save.
Na seção Custom appearance, você pode modificar as seguintes configurações:
- Color theme: o tema de cores da interface do Snowflake Intelligence. Você pode fornecer uma cor primária personalizada em formato hexadecimal.
- Full-length logo e Compact logo: os logotipos exibidos quando o painel de navegação é expandido ou recolhido, respectivamente.
- Favicon: o ícone exibido na guia do navegador.
Selecione Save.

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.
- If using the older semantic model, the user’s default role is granted READ on the stage that stores the semantic model file.
- If using a semantic view, the user’s default role is granted REFERENCES on the semantic view.
- 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.

Avisos legais¶

Nos locais onde sua configuração do Snowflake Intelligence usa um modelo fornecido sob a Cláusula de vínculo aos termos do modelo e serviço, o seu uso desse modelo também está sujeito aos termos do modelo nessa página.

A classificação dos dados de entradas e saídas é definido na tabela a seguir.

Classificação de dados de entrada	Classificação de dados de saída	Designação
Usage Data	Dados de cliente	Covered AI Features [1]

Para obter informações adicionais, consulte AI e ML Snowflake.