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.

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: na AWS, o Claude 4+ oferece a maior 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 você estiver usando o Snowflake Intelligence na região East US, poderá 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+ nesta região, desde que configure a inferência entre regiões do Cortex para aws_eu.
AWS APJ: você pode usar o Claude 4+ nesta região, desde que configure a inferência entre regiões do Cortex para aws_apj.

Configuração do Snowflake Intelligence¶

Para configurar o Snowflake Intelligence para seus usuários, faça o seguinte:

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.
Adicione agentes ao objeto Snowflake Intelligence.
Privilégios GRANT USAGE para o objeto Snowflake Intelligence.

Crie um objeto Snowflake Intelligence¶

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 Configurar a visibilidade dos agentes no Snowflake Intelligence.

Conceder privilégios ao Snowflake Intelligence¶

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.

Para conceder esse privilégio, execute o seguinte comando:
```
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.

Para conceder esse privilégio, execute o seguinte comando:
```
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.

Para configurar o Snowflake Intelligence para seus usuários, você deve configurar os privilégios do agente. Para obter informações sobre os privilégios necessários para os agentes, consulte 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 Criação de agente. For best practices when creating an agent, see Best Practices to Building Cortex Agents.

Configurar a visibilidade dos agentes no 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.

Gerenciamento de agentes com o objeto Snowflake Intelligence¶

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.

Migrating from managing agent visibility with the SNOWFLAKE_INTELLIGENCE.AGENTS schema¶

Importante

The SNOWFLAKE_INTELLIGENCE.AGENTS schema is deprecated as a mechanism for managing agent visibility. 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, as detailed in Lógica de visibilidade do agente. However, migrating to the Snowflake Intelligence object provides the following benefits:

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

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.
Ensure that a regionless-snowsight-privatelink-url is available by calling the SYSTEM$GET_PRIVATELINK_CONFIG function using the ACCOUNTADMIN system role.

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 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.

Atualizar configurações do Snowflake Intelligence¶

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.
Selecione Open settings.
Na seção General settings, você pode modificar as seguintes configurações:
- Brand display name: o nome da interface do Snowflake Intelligence que é exibida aos usuários.
- 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.
- Se estiver usando o modelo semântico antigo, a função padrão do usuário recebe o valor READ na área de preparação que armazena o arquivo do modelo semântico.
- Se você usa uma exibição semântica, a função padrão do usuário recebe o valor REFERENCES 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.

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.