Cursor Agent SDK 0.3.0 получила статус GA: как устроены агенты как код
23 октября 2026 года Cursor пометил Agent SDK 0.3.0 как GA после публичного объявления инструмента 20 октября. Разбираем, как агент описывается файлами, проверяется через evals и развёртывается в Cursor либо своей инфраструктуре, а также почему команды нужно сверять с текущей документацией.
20 октября 2026 года Cursor объявил Agent SDK общедоступным. По официальному описанию, SDK позволяет задать агента как папку с кодом и инструкциями, проверять его через evals и развёртывать в инфраструктуре Cursor либо на собственной площадке. Это релиз инструментария для разработчиков, а не новой языковой модели и не обещание, что любой созданный агент будет работать без настройки и контроля.
Событие важно тем, что агент перестаёт быть только диалогом внутри редактора. Его инструкции, инструменты, каналы и тесты становятся файлами, которые можно читать, версионировать и обсуждать в pull request. Но сам SDK не отменяет обычную инженерную приёмку: права, секреты, внешние действия и критерии успеха всё равно задаёт команда проекта.
Если нужен только патч в существующем проекте, сначала полезно пройти практический цикл из гайда про ИИ для работы с кодом.
Как устроен проект агента
В релизной заметке Cursor описывает агента как проект: файл instructions.md содержит основные инструкции, папка tools — типизированные действия, skills — подключаемые процедуры, mcp-connections — инструменты MCP, а channels — источники событий и ответов. Агент может просыпаться от pull request, комментария, сообщения Slack, webhook или расписания. Для каждого диалога сохраняется отдельная сессия с историей сообщений и вызовов инструментов.
Evals в Agent SDK предназначены для воспроизводимой проверки: фиксированное сообщение подаётся агенту, после чего проверяется, какие инструменты он вызвал, с какими параметрами и какой формы вернул ответ. Это полезнее субъективного впечатления от одного удачного диалога. Отдельная команда replay позволяет воспроизвести событие pull request на подписанном webhook-пакете, не дожидаясь нового изменения в репозитории.
Перед созданием такого проекта стоит отделить динамический выбор действий от обычного диалога; границы объясняет разбор о том, чем ИИ-агент отличается от чат-бота.
Важное изменение: команда из релиза и текущая документация различаются
На странице релиза от 20 октября приведена команда npx @cursor/agent-sdk init ./my-bot. Текущая документация Cursor уже предлагает установить пакет @grok/agent-sdk и отдельно сообщает, что раньше он назывался @cursor/bdk. Поэтому старую команду нельзя механически копировать как неизменное руководство. Для нового проекта следует открыть актуальный раздел Get started и использовать имя пакета и требования к Node.js, показанные там на момент установки.
Безопасная последовательность старта по текущей документации
1. Откройте https://cursor.com/docs/agent-sdk и проверьте актуальное имя пакета.
2. Убедитесь, что версия Node.js соответствует указанному минимуму.
3. Создайте пустой учебный проект без рабочих секретов.
4. Выполните init, затем validate и один локальный run.
5. Добавьте один eval с ожидаемым инструментом и формой ответа.
6. Развёртывайте только после ручной проверки прав и журналов.
Эта последовательность — план проверки документации, а не результат запуска SDK редакцией. Имя пакета и команды способны меняться после релиза, поэтому первичным источником для установки остаётся текущая документация, а релизная заметка подтверждает дату и первоначальный состав объявления.
Чем Agent SDK отличается от агента Cursor и TypeScript SDK
Три способа использовать агентные возможности Cursor
Инструмент
Что задаёт разработчик
Подходящая задача
Что проверять
Агент в Cursor
Цель в диалоге и доступный проект
Разовая правка, разбор или серия действий в репозитории
Diff, команды, тесты и права
Cursor TypeScript SDK
Вызов агентного рантайма из своего TypeScript-кода
Скрипт, CI-процесс или встроенная функция приложения
Обработку ошибок, сессии, разрешения и среду выполнения
Agent SDK
Версионируемый проект из инструкций, инструментов, каналов и evals
Постоянный бот или агент, реагирующий на события
Evals, схемы инструментов, секреты, триггеры и развёртывание
Сопоставление основано на документации, а не на проведённом сравнительном тесте.
Agent SDK имеет смысл, когда поведение должно жить дольше одного диалога, реагировать на события и проходить повторяемые проверки. Для единичной правки он может быть избыточен. TypeScript SDK ближе к программному вызову уже готового агентного рантайма, тогда как Agent SDK описывает целый проект: его структуру, инструменты, каналы и evals.
GitHub описывает близкую, но отдельную идею динамических workflow: код задаёт воспроизводимые стадии, а агенты выполняют части, требующие анализа. Это не доказательство возможностей Cursor, но полезная внешняя рамка для выбора: если порядок полностью известен, фиксированный workflow обычно проще; Agent SDK нужен там, где агенту действительно приходится выбирать действия в заданных границах.
Практический пример: агент для проверки pull request
Учебный сценарий: агент получает событие нового pull request, читает diff, проверяет наличие тестов для изменённой ветки и возвращает структурированный комментарий. Данные вымышлены; пример показывает форму задания, а не проведённый запуск Cursor.
Минимальная спецификация учебного агента
Часть
Пример
Критерий проверки
instructions.md
Проверять только изменённые файлы и не публиковать исправления
Ответ не содержит действий записи
tools/read_diff.ts
Читает diff и список файлов
Схема запрещает произвольный путь
tools/read_tests.ts
Ищет тесты, относящиеся к изменённому модулю
Пустой результат остаётся неизвестным, а не успехом
evals/missing-test.ts
Передаёт diff без теста
Агент вызывает оба инструмента и возвращает status=needs_test
channel
Событие pull request
Повтор одного события не создаёт второй комментарий
Минимальный набор ограничивает область и делает поведение наблюдаемым.
Сначала проверьте eval локально на трёх случаях: тест присутствует, тест отсутствует и diff нельзя прочитать. Затем убедитесь, что агент не пытается писать в репозиторий, если ему выдано только чтение. Лишь после этого подключайте реальный канал. Для сложного поведения полезен цикл из статьи о планировании шагов ИИ-агента.
Статус релиза и версия пакета — не одно и то же
Cursor назвал Agent SDK общедоступным 20 октября, а журнал версий документации отдельно отмечает выпуск 0.3.0 со статусом GA 23 октября. Эти даты описывают разные уровни продукта: публичное объявление инструмента и конкретную версию пакета. Поэтому перед установкой важно сверять не только дату статьи, но и changelog пакета, минимальную версию Node.js, актуальное имя npm-пакета и удалённые параметры API. Если инструкция показывает старое имя или опцию, это не делает весь разбор неверным, но команда требует обновления по текущей документации. Для воспроизводимости сохраните в проекте точную версию зависимости и отдельно зафиксируйте дату, когда проверяли команды.
Ограничения и следующий шаг
Официальные страницы подтверждают наличие SDK, структуру проекта, evals, каналы и варианты развёртывания. Они не доказывают качество конкретного агента, экономию времени или безопасность пользовательского кода. Эти выводы требуют собственного испытания на заранее заданном наборе задач. Не переносите маркетинговые примеры в гарантию результата и не давайте агенту секреты только потому, что проект проходит validate.
Перед подключением внешних данных выделите недоверенные инструкции и ограничьте инструменты; практический следующий шаг — разбор промпт-инъекции в ИИ-агенте.