· Changelog

Construa agentes programáveis com o SDK do Cursor

Estamos lançando o SDK do Cursor para que você possa criar agentes com o mesmo tempo de execução, harness e modelos que impulsionam o Cursor.

Os agentes que executam no app para desktop do Cursor, na CLI e no app web agora podem ser acessados com algumas linhas de TypeScript. Execute-o na sua máquina ou na nuvem do Cursor, em uma VM dedicada, com qualquer modelo de ponta.

Execute npm install @cursor/sdk para dar os primeiros passos e use o plugin do SDK do Cursor para que o Cursor ajude você a construir.

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

Desenvolvemos alguns projetos de exemplo que você pode acessar a partir de um repo público. Faça um fork deles e expanda-os para o seu caso de uso.

O SDK do Cursor agora está disponível para todos os usuários em beta pública e segue o modelo de preços padrão com base no consumo de tokens. Saiba mais em nosso anúncio e na documentação.

  • Reformulamos a API em torno de agentes duráveis e execuções por prompt, para que continuações, status, streaming e cancelamento agora passem a ter escopo por execução.
  • Adicionamos suporte nativo a streaming de execução com eventos SSE, suporte a reconexão via Last-Event-ID e estados finais mais claros.
  • Adicionamos controles explícitos do ciclo de vida do agente, com ações de arquivar, desarquivar e excluir permanentemente.
  • Padronizamos os formatos de resposta e erro da v1, incluindo códigos de erro estruturados, respostas de lista items e objetos agent / run separados.