Cortex Agent SDK para Python e TypeScript no Snowflake

Para que serve

Imagine que você tem uma aplicação customizada e precisa integrar inteligência artificial para consultar dados corporativos com segurança, manter o histórico de conversas e executar tarefas longas em segundo plano. Com o SDK, você pode:

• Consultar dados governados usando Cortex Analyst e Cortex Search.
• Manter conversas multi-turn persistentes.
• Executar tarefas em background e reconectar por ID.
• Integrar o Cortex Code para fluxos de desenvolvimento com agentes.

Como usar

Instale o pacote TypeScript:

npm install "@snowflake/cortex-agent-sdk@>=0.0.2"

Inicie uma conversa e envie uma mensagem:

import {
  CortexAgentClient,
  type AgentResponse,
  type Conversation,
  type Turn,
} from "@snowflake/cortex-agent-sdk";

const client: CortexAgentClient = new CortexAgentClient({
  account: process.env.SNOWFLAKE_ACCOUNT!,
  auth: process.env.SNOWFLAKE_PAT!,
});

const conversation: Conversation = await client.conversations.create({
  thread: { origin_application: "my-app" },
  agent: {
    type: "inline",
    spec: { models: { orchestration: "claude-sonnet-4-5" } },
  },
});

const turn: Turn = await conversation.send("Explain Snowflake micro-partitions in three sentences.");
const answer: AgentResponse = await turn.result();
console.log(answer.text);

O que acontece nesse código:

1. Inicializa o cliente do Cortex Agent usando as variáveis de ambiente de conta e token.
2. Cria uma nova conversa associada a um agente embutido.
3. Envia uma instrução para o agente processar.
4. Aguarda o resultado e imprime a resposta retornada.

Instale o pacote Python:

pip install "snowflake-cortex-agent-sdk>=0.0.2"

Execute a chamada básica em Python:

from cortex_agent_sdk import AgentResponse, Conversation, CortexAgentClient, Turn

client: CortexAgentClient = CortexAgentClient(account="my_account", auth="<token>")
conversation: Conversation = client.conversations.create(
    origin_application="cortex_agent_sdk",
    agent={"type": "inline", "spec": {}},
)
turn: Turn = conversation.send("What can Cortex Agent do?")
answer: AgentResponse = turn.result()
print(answer.text)

O que acontece nesse código:

1. Cria uma instância do cliente passando a conta e o token de autenticação.
2. Configura uma nova sessão de conversa com um agente inline.
3. Envia uma pergunta ao agente.
4. Coleta e exibe o texto da resposta gerada.

Limitações e requisitos

• Estágio: Public Preview.
• O SDK Python requer Python 3.10 ou superior.
• O SDK TypeScript requer Node.js 22.22 ou superior.
• Requer uma conta Snowflake com suporte a Cortex Agents e credenciais válidas (PAT, OAuth, JWT de par de chaves ou token de sessão).