O Agent SDK já está disponível. Com ele, você pode definir um agente como uma pasta de código, testá-lo com evals e implementá-lo no Cursor ou na sua própria infraestrutura.

Execute npx @cursor/agent-sdk init ./my-bot e depois agent-sdk dev para iniciar o bot localmente com um playground. Use --template para partir de um modelo pronto: um revisor de segurança, um aprovador baseado em política de owners, um corretor automático de PRs ou um agente de triagem para Linear ou Jira.

#Implemente agentes onde você precisar

Quando seu agente estiver pronto para entrar em uso, você pode implementá-lo no Cursor executando agent-sdk deploy no diretório do projeto. O comando faz o build do agente, atribui uma URL a ele e o inicia na nossa infraestrutura. Você pode gerenciar segredos e integrações pelo dashboard e continuar usando os mesmos logs, evals e playground disponíveis localmente.

#Agentes como código

Um agente é um projeto. instructions.md é o prompt. Cada arquivo em tools/ é uma ação tipada que o modelo pode chamar. skills/ reúne procedimentos que o modelo carrega sob demanda, mcp-connections/ adiciona ferramentas de servidores MCP e channels/ define onde o bot recebe e responde às mensagens. agent-sdk validate verifica o projeto e agent-sdk info exibe o que foi encontrado.

#Canais

Os agentes são acionados por eventos de PR, comentário e CI do GitHub, GitLab e Bitbucket; por menções e DMs no Slack; por webhooks de qualquer provedor; e por um agendamento cron. Os eventos do GitHub são obtidos pela sua conta do Cursor, então não é necessária uma URL pública de webhook. O Slack já vem com suporte completo, sem configuração adicional.

Cada conversa mantém sua própria sessão e um registro completo de todas as mensagens e chamadas de ferramenta. Perguntas complementares em um PR ou em uma conversa em thread no Slack retomam a mesma sessão.

#Evals

Uma avaliação envia uma mensagem fixa ao bot e verifica o que ele fez: quais ferramentas foram executadas, com qual entrada e qual o formato da resposta. Execute agent-sdk eval localmente ou no CI.

agent-sdk github replay <pr-url> transforma um PR real em payloads de webhook assinados e os envia ao bot, para que bots acionados pelo GitHub possam ser testados sem esperar por um push. Adicione --dry-run --fixtures-dir fixtures/ para salvar os payloads como fixtures de avaliação.

#Primeiros passos

O Agent SDK já está disponível para o público geral. Leia a documentação e comece agora mesmo.