Acesso do usuário e configurações para agentes¶

Personalizar a interface do Snowflake Intelligence¶

Para personalizar a interface do Snowflake Intelligence pela qual os usuários interagem com os Cortex Agents, siga estas etapas:

1. Faça login no Snowsight.

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

3. Selecione Open settings.

4. Em Snowflake Intelligence, modifique as seguintes configurações:

   • Display name: o nome da interface do Snowflake Intelligence que aparece para os usuários.

   • Welcome message: a mensagem exibida quando os usuários abrem a interface do Snowflake Intelligence pela primeira vez.

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

   • Compact logo: o ícone exibido na guia do navegador.

5. Selecione Save.

Privilégios de usuário e controle de acesso¶

Os usuários devem ter os seguintes privilégios para visualizar os agentes no Snowflake Intelligence:

Para acessar as ferramentas anexadas a um agente, os usuários devem ter os seguintes privilégios:

Limitar o acesso a funções específicas

A função CORTEX_USER oferece aos usuários acesso a todos os recursos do Cortex, incluindo os agentes. Por padrão, essa função é concedida à função PUBLIC, que é concedida automaticamente a todos os usuários e funções. Se não quiser que todos os usuários tenham esse privilégio, você pode revogá-lo da função PUBLIC e conceder acesso somente a funções específicas. Para obter mais informações, consulte Privilégios de LLM do Cortex.

Depois de revogar a função CORTEX_USER da função PUBLIC, você poderá conceder a função CORTEX_AGENT_USER. Essa função oferece aos usuários acesso apenas à API Cortex Agents, que permite que eles usem o Snowflake Intelligence, mas não os outros recursos do Cortex.

• Para fornecer acesso seletivo aos Cortex Agents para que apenas um subconjunto de usuários tenha acesso ao recurso, primeiro revogue o acesso à função PUBLIC e, depois, conceda a função CORTEX_AGENT_USER aos usuários específicos:

  GRANT DATABASE ROLE SNOWFLAKE.CORTEX_AGENT_USER TO ROLE <role_name>;
  

  Copy

Para obter mais informações, consulte Requisitos de controle de acesso.

Configurar Snowflake Intelligence com conectividade privada¶

O Snowflake Intelligence oferece suporte à integração com o AWS Privatelink e o Azure Private Link para estabelecer uma conexão privada entre sua nuvem privada virtual (Virtual Private Cloud, VPC) ou rede virtual (Virtual Network, 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.

Redirecionar usuários para seu provedor de identidade¶

Um administrador de conta pode configurar todos os URLs do usuário para redirecionar para seu provedor de identidade (IdP) quando um usuário não autenticado acessa o Snowflake Intelligence. Esse processo elimina uma etapa do fluxo de login do usuário.

• Para redirecionar usuários não autenticados dos URLs para o seu IdP, execute o seguinte comando SQL, substituindo your_security_integration pelo nome da integração de segurança configurada para o seu IdP:

  ALTER ACCOUNT SET LOGIN_IDP_REDIRECT = (SNOWFLAKE_INTELLIGENCE = <your_security_integration>);
  

  Copy

Para obter mais informações sobre como configurar sua conta Snowflake para usar um IdP, consulte os seguintes tópicos:

• Configuração do Snowflake para usar a autenticação federada

• Configuração de um provedor de identidade (IdP) para o Snowflake

Limitar o acesso de um usuário apenas ao Snowflake Intelligence¶

Para restringir o acesso de um usuário apenas ao Snowflake Intelligence e impedi-lo de acessar outras partes do Snowflake, você pode usar o comando SQL ALTER USER ou o atributo SCIM allowedInterfaces. Se um valor diferente de ALL for especificado usando um desses métodos, os usuários poderão acessar apenas a interface especificada e não poderão interagir com os dados do Snowflake fora da interface especificada.

• Para restringir o acesso de um usuário somente ao Snowflake Intelligence, use o comando SQL ALTER USER:

  ALTER USER <user_name> SET ALLOWED_INTERFACES = (SNOWFLAKE_INTELLIGENCE);
  

  Copy

• Se você estiver provisionando usuários com APIs SCIM, para definir a mesma restrição, use o atributo personalizado allowedInterfaces.

Para obter mais informações sobre os atributos personalizados de SCIM, consulte Atributos personalizados.

Objeto Snowflake Intelligence¶

O Snowflake Intelligence é um objeto no nível da conta usado para gerenciar todos os agentes no Snowflake Intelligence e as configurações de sua conta. O objeto Snowflake Intelligence oferece os seguintes benefícios:

• Flexibilidade: criar e gerenciar agentes em qualquer lugar na sua conta sem precisar centralizá-los em um único esquema.

• Gerenciamento de visibilidade do agente: usar um único objeto para controlar quais agentes aparecem para todos os usuários.

• Gerenciamento de permissão aprimorado: separar a capacidade de criar agentes da capacidade de controlar quais agentes são mostrados no Snowflake Intelligence.

Configurar a visibilidade dos agentes no Snowflake Intelligence¶

Em alguns casos, você pode querer limitar os agentes que os usuários podem ver no Snowflake Intelligence. Por exemplo, você pode mostrar apenas os agentes relevantes para um usuário ou grupo de usuários específico.

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

• Para controlar quais agentes aparecem na interface do Snowflake Intelligence para todos os usuários, crie uma lista selecionada de agentes adicionando-os ao objeto Snowflake Intelligence.

Acessar o agente¶

Depois de criar um agente, você poderá fazer perguntas a ele 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 as seguintes visualizações:

• Gráfico de barras

• Gráfico de linhas

• Gráfico de pizza

• Gráfico de dispersão

Para usar o agente, siga estas etapas:

Method 1: Access without private connectivityMethod 2: Access with private connectivityMethod 3: Access with a direct link

Para acessar o Snowflake Intelligence sem conectividade privada, navegue até o seguinte URL:

https://ai.snowflake.com

Copy

Monitorando o uso e o feedback do agente¶

Você pode exibir os logs de um agente para ver detalhes sobre as interações entre os usuários e o agente. Os logs incluem informações como os prompts que os usuários enviaram ao agente, as respostas do agente e possíveis erros que tenham ocorrido. Para obter mais informações sobre a exibição de logs dos agentes, consulte Monitoramento de solicitações de Cortex Agents.

Quando os usuários de sua organização interagem com os agentes, eles podem fornecer feedback sobre as respostas que os agentes fornecem. Esse feedback fornece insights de alto nível sobre a prazer dos usuários. Para exibir o feedback do usuário sobre os agentes, consulte Monitoramento de solicitações de Cortex Agents.