Compartilhar Cortex Agents

Como provedor, você pode compartilhar um Cortex Agent existente com outras organizações no Snowflake, permitindo expandir a base de usuários do seu agente e levar seu valor a outros clientes do Snowflake. É possível compartilhar seus Cortex Agents no Snowflake Marketplace ou com contas designadas. Para obter mais informações sobre como se tornar provedor do Snowflake Marketplace, consulte Uso das listagens como um provedor.

Como consumidor de um Cortex Agent compartilhado, você recebe acesso a uma interface fácil de usar para obter insights dos dados estruturados ou não estruturados compartilhados. Para obter mais informações sobre como consumir Cortex Agents, consulte Uso das listagens como um consumidor e Usar e gerenciar Snowflake Native Apps como um consumidor.

Requisitos

O compartilhamento de um Cortex Agent requer o seguinte:

  • Compartilhar todos os objetos vinculados, como exibições semânticas ou Cortex Search Services. Para obter mais informações, consulte Criação e configuração de compartilhamentos e Compartilhamento de exibições semânticas.

  • Os objetos vinculados compartilhados devem estar no mesmo banco de dados que o Cortex Agent compartilhado.

  • Somente agentes que usam os seguintes tipos de ferramentas podem ser compartilhados: exibições semânticas, Cortex Search Services e funções. Agentes que usam outros tipos de ferramentas, como procedimentos, habilidades ou conectores MCP, não podem ser compartilhados.

Definir um Cortex Agent como compartilhado

Você pode compartilhar os Cortex Agents como provedor no Snowflake Marketplace por meio do Provider Studio.

Você também pode definir um agente como compartilhado com uma instrução SQL. O exemplo a seguir adiciona o agente my_agent ao compartilhamento my_share:

GRANT USAGE ON AGENT my_agent TO SHARE my_share;

Se o seu agente usa objetos vinculados, como exibições semânticas, Cortex Search Services ou funções, você também deve conceder esses objetos ao compartilhamento:

GRANT USAGE ON AGENT my_agent TO SHARE my_share;
GRANT SELECT, REFERENCES ON SEMANTIC VIEW my_sv TO SHARE my_share;
GRANT USAGE ON CORTEX SEARCH SERVICE my_css TO SHARE my_share;
GRANT USAGE ON FUNCTION my_function TO SHARE my_share;

Quando você adiciona um agente a um compartilhamento existente, o usuário consumidor que instalou o compartilhamento recebe uma notificação por e-mail para testar o agente.

Identificar agentes compartilhados no Snowsight

No menu de navegação, selecione AI & ML » Agents. A coluna Source indica se cada agente é Local ou Shared. Use essa coluna para distinguir rapidamente entre os agentes criados em sua conta e aqueles compartilhados com você de outra conta.

Consumir um Cortex Agent compartilhado

Quando você obtém uma listagem com um Cortex Agent compartilhado, pode adicionar o agente ao Snowflake Intelligence. Para fazer isso, mantenha o botão de alternância Add to Snowflake Intelligence habilitado ao obter a listagem. Isso disponibiliza o agente compartilhado como uma fonte de dados no Snowflake Intelligence.

O botão de alternância Add Agent to Snowflake Intelligence habilitado ao obter uma listagem.

Seleção do warehouse

Por padrão, um agente compartilhado é executado usando seu warehouse padrão. Você pode especificar um warehouse personalizado para consultas e execução de ferramentas para controlar os recursos e custos de computação.

Para configurar um warehouse personalizado para um agente compartilhado:

  1. Entre no Snowsight.

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

  3. Selecione um agente compartilhado. Identifique os agentes compartilhados pela coluna Source.

  4. Selecione menu de mais opções (…) ‣ Configure warehouses for tools.

  5. Selecione Custom, escolha um warehouse e selecione Save.

Depois que você configurar um warehouse personalizado, o agente compartilhado usará o warehouse especificado para executar consultas e ferramentas.

Replicação

Os Cortex Agents compartilhados oferecem suporte à replicação. O preenchimento automático da listagem replica os agentes em outras regiões, permitindo que os consumidores de regiões diferentes acessem o agente compartilhado.

Limitações

As seguintes limitações se aplicam aos Cortex Agents compartilhados:

  • Uma função de tabela SQL pode ser compartilhada, mas uma função de tabela definida pelo usuário em Python não pode.

  • Se você atualizar um agente compartilhado para usar novas ferramentas (como exibições semânticas, Cortex Search Services ou funções), também deverá conceder essas novas ferramentas ao compartilhamento. Novas ferramentas não são adicionadas automaticamente.

Considerações sobre custo

Além dos custos pagos ao provedor do Cortex Agent compartilhado, os consumidores são cobrados pelo seguinte:

  • Tokens de entrada e saída usados pela invocação do agente compartilhado feita pelo consumidor.

  • Uso do warehouse do consumidor para execução de consultas SQL e de ferramentas.

Para obter mais informações sobre os custos pagos aos provedores, consulte Pague por listagens. Para obter mais informações sobre os custos do Snowflake, consulte a Tabela de consumo de serviços do Snowflake.