Последние
Новости ИИ

Cursor Agent SDK 0.3.0 получила статус GA: как устроены агенты как код

23 октября 2026 года Cursor пометил Agent SDK 0.3.0 как GA после публичного объявления инструмента 20 октября. Разбираем, как агент описывается файлами, проверяется через evals и развёртывается в Cursor либо своей инфраструктуре, а также почему команды нужно сверять с текущей документацией.

В этом материале7 разделов
Схема Cursor Agent SDK: файлы проекта переходят через проверку и развёртывание в работающего агента.
Редакционная схема PENROUZ NEWS. SDK превращает агента в версионируемый проект, а не в разовую команду чату.PENROUZ NEWS

Сообщить об ошибке или предложить уточнение

Что изменилось к 23 октября

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Повтор одного события не создаёт второй комментарий
Минимальный набор ограничивает область и делает поведение наблюдаемым.
Ожидаемая форма ответа учебного агента
{
  "status": "needs_test",
  "changed_files": ["src/parser.ts"],
  "evidence": ["изменена ветка обработки пустой строки"],
  "missing_checks": ["нет регрессионного теста для пустой строки"],
  "write_actions": []
}

Сначала проверьте eval локально на трёх случаях: тест присутствует, тест отсутствует и diff нельзя прочитать. Затем убедитесь, что агент не пытается писать в репозиторий, если ему выдано только чтение. Лишь после этого подключайте реальный канал. Для сложного поведения полезен цикл из статьи о планировании шагов ИИ-агента.

Статус релиза и версия пакета — не одно и то же

Cursor назвал Agent SDK общедоступным 20 октября, а журнал версий документации отдельно отмечает выпуск 0.3.0 со статусом GA 23 октября. Эти даты описывают разные уровни продукта: публичное объявление инструмента и конкретную версию пакета. Поэтому перед установкой важно сверять не только дату статьи, но и changelog пакета, минимальную версию Node.js, актуальное имя npm-пакета и удалённые параметры API. Если инструкция показывает старое имя или опцию, это не делает весь разбор неверным, но команда требует обновления по текущей документации. Для воспроизводимости сохраните в проекте точную версию зависимости и отдельно зафиксируйте дату, когда проверяли команды.

Ограничения и следующий шаг

Официальные страницы подтверждают наличие SDK, структуру проекта, evals, каналы и варианты развёртывания. Они не доказывают качество конкретного агента, экономию времени или безопасность пользовательского кода. Эти выводы требуют собственного испытания на заранее заданном наборе задач. Не переносите маркетинговые примеры в гарантию результата и не давайте агенту секреты только потому, что проект проходит validate.

Перед подключением внешних данных выделите недоверенные инструкции и ограничьте инструменты; практический следующий шаг — разбор промпт-инъекции в ИИ-агенте.

Хронология

  1. ChatGPT dot получила сообщения через iMessage и RCS: кому доступна бета
  2. Gemini API CLI вышла в бета-версии: что умеет и как запустить
  3. Claude Models on Google Cloud стали общедоступны: как устроено подключение
  4. OpenAI выпустила Decisions API: для каких задач нужен новый endpoint
Прозрачность

Источники и примечания

  1. Agent SDK
  2. Agent SDK | Cursor Docs
  3. Cursor TypeScript SDK | Cursor Documentation
  4. Dynamic workflows in Copilot CLI and the Copilot app
  5. Changelog | Agent SDK | Cursor Docs

В этом материале

На этом устройстве

Сохранённые материалы