Referência

Esta página fornece informações de referência sobre como trabalhar com o Snowflake Intelligence. Ela abrange os seguintes conceitos:

  • Pontos de extremidade de REST API e comandos SQL disponíveis para criar, gerenciar e interagir com Cortex Agents

  • Os modelos de AI compatíveis e a respectiva disponibilidade regional

  • Avisos legais sobre o uso do modelo e a classificação de dados

Comandos SQL e referência da API

O Snowflake oferece os seguintes métodos programáticos para criar e interagir com Cortex Agents para uso com o Snowflake Intelligence:

REST API Cortex Agent Object

A RESTAPI Cortex Agent Object fornece um conjunto abrangente de pontos de extremidade para criar aplicativos com tecnologia de AI que se integram com o Snowflake Intelligence. Você pode usar a REST API para gerenciar objetos de agente e orquestrar interações com seus dados.

Operações de gerenciamento de agentes

A REST API Agent Object é compatível com as seguintes operações para gerenciar objetos do Cortex Agent:

Operação

Ponto de extremidade

Descrição

Criar

POST /api/v2/databases/{database}/schemas/{schema}/agents

Cria um novo Cortex Agent com atributos e configuração de ferramenta especificados.

Descrever

GET /api/v2/databases/{database}/schemas/{schema}/agents/{name}

Recupera a configuração e os metadados de um agente existente.

Update

PUT /api/v2/databases/{database}/schemas/{schema}/agents/{name}

Modifica a configuração, as ferramentas ou as instruções de um agente existente.

Lista

GET /api/v2/databases/{database}/schemas/{schema}/agents

Lista todos os agentes em um banco de dados e esquema especificados, com opções de filtragem.

Delete

DELETE /api/v2/databases/{database}/schemas/{schema}/agents/{name}

Remove um agente da sua conta.

Para especificações detalhadas da API, incluindo parâmetros de solicitação, esquemas de resposta e exemplos, consulte Cortex Agents REST API.

Comandos SQL de agentes

O Snowflake fornece comandos SQL para criar e gerenciar objetos do Cortex Agents para uso com o Snowflake Intelligence.

Comandos de gerenciamento de agentes

Os seguintes comandos SQL estão disponíveis para gerenciar Cortex Agents:

Comando

Descrição

CREATE AGENT

Cria um novo Cortex Agent ou substitui um existente com atributos, configurações de perfil e uma especificação YAML especificados.

DESCRIBE AGENT

Recupera a configuração, a especificação e os metadados completos de um agente existente.

SHOW AGENTS

Lista todos os Cortex Agents para os quais você tem privilégios de acesso, com opções de filtragem e paginação.

DROP AGENT

Remove um agente do esquema atual ou especificado.

Para obter detalhes sobre a sintaxe, parâmetros e exemplos de SQL, consulte Comandos do Cortex Agent.

Modelos e regiões com suporte

O Snowflake Intelligence é compatível com os modelos listados em Modelos. Você poderá usá-los desde que a conta tenha acesso a eles. Para obter mais informações, consulte Controle o acesso ao modelo.

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.

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.

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