Cursor
Облачные агенты Cursor по репозиториям GitHub в процессах Pailot
Cursor — редактор с облачными агентами, которые работают в репозиториях GitHub (хостинг git-репозиториев). Блок запускает агента по ключу API (Application Programming Interface — программный интерфейс), смотрит статус и диалог, добавляет follow-up.
С Cursor в Pailot вы можете:
- Запускать облачного агента по URL репозитория и инструкции
- Смотреть список агентов, статус, ветку/PR (pull request — запрос на слияние) и историю диалога
- Добавлять follow-up, останавливать и удалять агента
- Просить автоматически создать PR и открыть его от имени Cursor GitHub App
Нужен ключ API Cursor. Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Ключ — в переменных окружения рабочего пространства.
Список облачных агентов текущего пользователя с постраничным выводом. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Cursor |
limit | number | Нет | Сколько агентов вернуть (по умолчанию 20, максимум 100) |
cursor | string | Нет | Курсор следующей страницы из прошлого ответа |
| Параметр | Тип | Описание |
|---|
agents | array | Массив агентов |
nextCursor | string | Курсор следующей страницы |
Статус и результат облачного агента. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Cursor |
agentId | string | Да | ID облачного агента (например, bc_abc123) |
| Параметр | Тип | Описание |
|---|
id | string | ID агента |
name | string | Имя агента |
status | string | Статус агента |
source | json | Исходный репозиторий |
target | json | Целевая ветка или PR |
summary | string | Краткий итог работы |
createdAt | string | Когда агента создали |
История диалога облачного агента: промпты и ответы. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Cursor |
agentId | string | Да | ID облачного агента (например, bc_abc123) |
| Параметр | Тип | Описание |
|---|
id | string | ID агента |
messages | array | Сообщения диалога |
Запустить облачного агента в репозитории GitHub. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Cursor |
repository | string | Да | URL репозитория GitHub (например, https://github.com/your-org/your-repo) |
ref | string | Нет | Ветка, тег или коммит (по умолчанию основная ветка) |
promptText | string | Да | Инструкция для агента |
promptImages | string | Нет | JSON-массив картинок: base64 и размеры |
model | string | Нет | Модель (пусто — выбор автоматически) |
branchName | string | Нет | Имя ветки для агента |
autoCreatePr | boolean | Нет | Создать PR, когда агент закончит |
openAsCursorGithubApp | boolean | Нет | Открыть PR от имени Cursor GitHub App |
skipReviewerRequest | boolean | Нет | Не запрашивать ревьюеров в PR |
| Параметр | Тип | Описание |
|---|
id | string | ID агента |
url | string | URL агента |
Добавить follow-up (дополнительную инструкцию) к существующему агенту. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Cursor |
agentId | string | Да | ID облачного агента (например, bc_abc123) |
followupPromptText | string | Да | Текст дополнительной инструкции |
promptImages | string | Нет | JSON-массив картинок: base64 и размеры (максимум 5) |
| Параметр | Тип | Описание |
|---|
id | string | ID агента |
Остановить выполняющегося облачного агента. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Cursor |
agentId | string | Да | ID облачного агента (например, bc_abc123) |
| Параметр | Тип | Описание |
|---|
id | string | ID агента |
Удалить облачного агента навсегда. Поля совпадают с API.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | Ключ API Cursor |
agentId | string | Да | ID облачного агента (например, bc_abc123) |
| Параметр | Тип | Описание |
|---|
id | string | ID агента |
