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.

Snowflake Intelligence uses agents, which are AI models that are connected to one or more semantic views, semantic models, Cortex search services, and tools. Agents can answer questions, provide insights, and show visualizations. Snowflake Intelligence is powered by Cortex AI Functions, Cortex Analyst, and 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.

When creating an agent, we recommend selecting Auto for the model. This lets Snowflake Intelligence automatically select the highest quality model for your account and automatically improves as new models become available.

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

The ACCOUNTADMIN role is the only role that has the CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT privilege required to create a Snowflake Intelligence object.

Create a Snowflake Intelligence object. The Snowflake Intelligence object is a single object meant to manage all agents used with Snowflake Intelligence in your account. You can only have one Snowflake Intelligence object in your account.
Add agents to the Snowflake Intelligence object.
GRANT USAGE privileges to the Snowflake Intelligence object.

Create a Snowflake Intelligence object¶

You can either use the Snowflake Intelligence UI or SQL to create a Snowflake Intelligence object.

Snowflake automatically creates the Snowflake Intelligence object when you modify the Snowflake Intelligence settings for the first time. When created using the UI, the Snowflake Intelligence object is named SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT. You can’t specify a different name.

Faça login na Snowsight.

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

Select the Snowflake Intelligence tab.

Select Open settings. The Snowflake Intelligence object is created automatically if it doesn’t already exist. You can then add agents to the object.
To create a Snowflake Intelligence object, you can use the following command:
CREATE SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT;
Copy

Add agents¶

The Snowflake Intelligence object is an account-level object that contains a list of agents. You can add or remove agents from this object to create a curated list of agents for your users. For more information about adding or removing agents, see Configure the visibility of agents in Snowflake Intelligence.

Grant Snowflake Intelligence privileges¶

The following privileges control access to Snowflake Intelligence objects:

CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT: Account-level privilege that allows creating a Snowflake Intelligence object. This privilege is granted to ACCOUNTADMIN by default.

To grant this privilege to another role, run the following command:
```
GRANT CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT TO ROLE <role_name>;
```
Copy
USAGE: Object-level privilege that allows users to view the list of agents added to the Snowflake Intelligence object and see configuration values.

To grant this privilege, run the following command:
```
GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE <role_name>;
```
Copy
ALTER: Object-level privilege that allows users to add or remove agents from the Snowflake Intelligence object and change configuration values. Account administrators have this privilege by default.

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

To make the Snowflake Intelligence object visible to all of your users, grant USAGE privileges on the object to the PUBLIC role:

GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE PUBLIC;

Copy

As an ADMIN, you also have ALTER privileges on the Snowflake Intelligence object. This allows you to add or remove agents from the object to create a curated list of agents for your users.

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¶

To get started, create an agent that users can interact with in Snowflake Intelligence. For information about creating an agent, see Create an agent. For best practices when creating an agent, see Best Practices to Building Cortex Agents.

Configure the visibility of agents in Snowflake Intelligence¶

If you haven’t created a Snowflake Intelligence object and added agents to it, users see all agents they have access to in your account.

For the optimal experience, create a curated list of agents by adding them to the Snowflake Intelligence object. This allows you to control which agents appear in the Snowflake Intelligence interface for all users.

To see whether the Snowflake Intelligence object has been created in your account, use the following command:

SHOW SNOWFLAKE INTELLIGENCES;

Copy

Nota

Only one Snowflake Intelligence object can exist in an account.

Managing agents with the Snowflake Intelligence object¶

To add agents to the Snowflake Intelligence object, use the following command:

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

Copy

To remove agents from the Snowflake Intelligence object, use the following command:

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

Copy

Nota

Any user or admin with the right database and schema privileges can create agents. However, agents are not automatically added to the Snowflake Intelligence object. Users must have the ALTER privilege on the Snowflake Intelligence object and USAGE privileges on the agent to add an agent to the Snowflake Intelligence object.

Administrators must have the USAGE privilege on the agent to add it to the Snowflake Intelligence object.

Agent visibility logic¶

Snowflake Intelligence uses the following logic to determine which agents are visible to users:

If the Snowflake Intelligence object exists and contains one or more agents, users see the individual agents from this curated list that they have access.
If the Snowflake Intelligence object exists but contains zero agents AND the SNOWFLAKE_INTELLIGENCE.AGENTS schema exists with one or more agents, users see agents from the SNOWFLAKE_INTELLIGENCE.AGENTS schema. This ensures that Snowflake Intelligence doesn’t break if you haven’t migrated your agents yet.
If the Snowflake Intelligence object doesn’t exist or contains zero agents AND the SNOWFLAKE_INTELLIGENCE.AGENTS schema doesn’t exist or contains zero agents, users see all agents that they have access to in the account.

Migrating from the deprecated SNOWFLAKE_INTELLIGENCE.AGENTS schema¶

Importante

The SNOWFLAKE_INTELLIGENCE.AGENTS schema is deprecated. If you’re currently using this schema, we recommend migrating to the Snowflake Intelligence object.

If you’re using the SNOWFLAKE_INTELLIGENCE.AGENTS schema, your agents will continue to work. However, migrating to the Snowflake Intelligence object provides the following benefits:

Flexibility: Create and manage agents anywhere in your account without needing to centralize them in a single schema.

Improved permission management: Separate the ability to create agents from the ability to publish them in Snowflake Intelligence.

Avoid naming conflicts: Eliminate potential conflicts with the SNOWFLAKE_INTELLIGENCE.AGENTS schema name.

Easier agent visibility management: Use a single object to control which agents appear to all users.

Make sure you’ve created a Snowflake Intelligence object before you migrate your agents. For information about creating a Snowflake Intelligence object, see Configuração do Snowflake Intelligence.

After you’ve created an object, use the following code to add an agent to the Snowflake Intelligence object:

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

Copy

You can rename or drop the SNOWFLAKE_INTELLIGENCE database or AGENTS schema after the migration. For more information, see ALTER SCHEMA.

Configurar Snowflake Intelligence com conectividade privada¶

O Snowflake Intelligence oferece suporte à integração com AWS Privatelink e Azure Private Link para estabelecer uma conexão privada entre sua nuvem privada virtual (VPC) ou rede virtual (VNet) e o Snowflake Intelligence. A configuração da conectividade privada requer a configuração da resolução de DNS correta para direcionar o tráfego para o serviço Snowflake Intelligence por meio dessa conectividade privada.

Observe que o AWS PrivateLink e o Azure Private Link não são serviços fornecidos pelo Snowflake. Eles são um serviço AWS e serviço Microsoft, respectivamente, para os quais o Snowflake oferece suporte para uso com sua conta Snowflake.

Pré-requisitos¶

Conclua os pré-requisitos a seguir antes da conexão do Snowflake Intelligence com a conectividade privada.

Configure o AWS PrivateLink seguindo as instruções em AWS PrivateLink e Snowflake ou o Azure Private Link seguindo as instruções em 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

O Snowflake Intelligence utiliza exclusivamente o formato de URL sem região para acesso à conectividade privada. Diferente de outros URLs de conectividade privada usados para o Snowflake, você não deve incluir um identificador de região, como us-west-2,, no nome do host. As tentativas de conexão usando um URL específico da região resultarão em falha.

Conexão ao Snowflake Intelligence¶

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

Crie um registro CNAME em sua zona DNS privada, privatelink.snowflakecomputing.com, que mapeie o URL a seguir para o nome DNS do ponto de extremidade da VPC ou VNET.
```
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.

Autenticação de usuário com conectividade privada¶

Usuários acessando o Snowflake Intelligence com conectividade privada utilizam o processo de autenticação padrão Snowflake, que exige que eles forneçam seu identificador de conta, nome de usuário e senha na página de login.

Use the Snowflake-managed MCP server to connect to your agents¶

Any agent that you create in Snowflake, or the tools that the agent is connected to, can have a managed endpoint for other systems to connect with MCP. This provides a seamless integration layer for tools like Claude Desktop, Langgraph, and other tools that integrate with MCP.

The MCP server provides a standards-based interface that allows AI agents to discover and invoke tools, such as Cortex Analyst and Cortex Search, and retrieve the data they need. For more information, see Servidor MCP gerenciado pelo Snowflake.

Update Snowflake Intelligence settings¶

You can modify settings for the Snowflake Intelligence interface that users interact with Cortex Agents through.

Faça login na Snowsight.
No menu de navegação, selecione AI & ML » Agents.
Select the Snowflake Intelligence tab.
Select Open settings.
From the General settings section, you can modify the following settings:
- Brand display name: The name of the Snowflake Intelligence interface that is displayed to users.
- Welcome message: The message that is displayed when users first open the Snowflake Intelligence interface.
- Primary domain: The domain that users use to access Snowflake Intelligence.
Selecione Save.
From the Custom appearance section, you can modify the following settings:
- Color theme: The color theme of the Snowflake Intelligence interface. You can provide a custom primary color in hexadecimal format.
- Full-length logo and Compact logo: The logos that are displayed when the navigation pane is expanded or collapsed, respectively.
- Favicon: The icon that is displayed in the browser tab.
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.

Legal notices¶

Where your configuration of Snowflake Intelligence uses a model provided on the Model and Service Flow-down Terms, your use of that model is further subject to the terms for that model on that page.

The data classification of inputs and outputs are as set forth in the following table.

Input data classification	Output data classification	Designation
Usage Data	Customer Data	Covered AI Features [1]

For additional information, refer to AI e ML Snowflake.