Skip to main content

Command Palette

Search for a command to run...

Интеграции

Slack

Интеграция Cursor со Slack позволяет использовать Cloud Agents для работы над задачами прямо в Slack: упомяните @cursor и добавьте промпт.

Быстрый старт

Установка

  1. Перейдите в интеграции Cursor

  2. Нажмите Подключить рядом со Slack или перейдите отсюда на страницу установки

  3. Вам будет предложено установить приложение Cursor для Slack в рабочем пространстве.

  4. После установки в Slack вы будете перенаправлены обратно в Cursor, чтобы завершить настройку

    1. Подключите провайдера репозиториев (если ещё не подключён) и выберите репозиторий по умолчанию
    2. Включите оплату по фактическому использованию
    3. Подтвердите настройки конфиденциальности
  5. Начните использовать Cloud Agents в Slack, упомянув @cursor

Как использовать

Упомяните @cursor и напишите промпт. Cursor определит по вашему сообщению репозиторий, модель, base-ветку или именованную инфраструктуру облачного агента. При выборе репозитория также учитывается ваша недавняя активность Agent.

Чтобы использовать именованную инфраструктуру, укажите её имя в промпте. Например: @Cursor use the Platform environment to update the shared API.

Команды

Выполните @Cursor help, чтобы получить актуальный список команд.

КомандаОписание
@Cursor [prompt]Запустить облачного агента. В тредах с существующими агентами добавляет дополнительные инструкции. Кто может добавлять дальнейшие инструкции, определяется параметром Дальнейшие действия команды, а не только владельцем.
@Cursor settingsНастроить параметры по умолчанию и репозиторий канала по умолчанию
@Cursor [options] [prompt]Задать для запуска целевой объект, модель, ветку, поведение PR, воркер или канал вывода
@Cursor agent [prompt]Принудительно создать нового агента в треде (например, @Cursor start a new agent to fix billing)
@Cursor list my agentsПоказать запущенных агентов

Параметры

Настройте поведение облачного агента с помощью следующих параметров:

ПараметрОписаниеПример на естественном языкеВстроенный пример
repoИспользовать указанный репозиторийin acme/backendrepo=acme/backend
env / environmentИспользовать именованную инфраструктуру облачного агентаuse the Platform environmentenv=Platform
branchИспользовать указанную base-веткуwork from the dev branchbranch=dev
modelИспользовать указанную модельwith opusmodel=opus
autoprВключить или отключить автоматическое создание PRТребуется встроенный параметрautopr=false
worker / machineЗапустить на указанной My MachineТребуется встроенный параметрworker=my-devbox
poolЗапустить в указанном пуле с собственными машинамиТребуется встроенный параметрpool=gpu
self_hostedЗапустить в пуле вашей команды в собственной инфраструктуреТребуется встроенный параметрself_hosted=true
channelПубликовать обновления агента в другом канале, доступном вам и CursorТребуется встроенный параметрchannel=#eng-bots

Форматы синтаксиса

Естественный:

@Cursor with opus, fix the login bug in backend-api

Встроенные:

@Cursor env=Platform branch=dev model=opus autopr=false Fix the login bug

Используйте кавычки для названий инфраструктур, содержащих пробелы:

@Cursor env="Platform Services" Update the shared API

Приоритет параметров

При сочетании параметров:

  • Явно указанные значения переопределяют значения по умолчанию
  • Значения, указанные позже, переопределяют более ранние при дублировании
  • Параметры, указанные в команде, имеют приоритет над значениями по умолчанию в окне настроек
  • env имеет приоритет над repo, если указаны оба

Бот распознаёт параметры в любом месте сообщения, позволяя формулировать команды естественным образом.

Использование контекста треда

Cloud Agents понимают и используют контекст существующих обсуждений в тредах. Это удобно, когда ваша команда обсуждает проблему и вы хотите, чтобы агент реализовал решение на основе этого диалога.

Когда использовать принудительные команды

Когда нужен @Cursor agent?

В тредах с уже запущенными агентами @Cursor [prompt] добавляет дополнительные инструкции. Кто может продолжить работу, определяется параметром Дальнейшие действия команды. Если дальнейшие действия команды отключены, продолжить работу может только владелец. Чтобы запустить отдельного агента, используйте @Cursor agent [prompt] или сформулируйте запрос на естественном языке:

@Cursor start a new agent to refactor billing

Фразы вроде "создать нового агента", "запустить нового агента" или "нового агента, пожалуйста" работают одинаково.

Когда нужно использовать Add follow-up (из контекстного меню)?

Используйте контекстное меню (⋯) для ответа агента, чтобы добавить дальнейшие инструкции. Это удобно, когда в треде несколько агентов и нужно указать, к какому из них обратиться повторно.

Обновления статуса и передача

При запуске Cloud Agent сначала доступна команда Открыть в Cursor.

После завершения работы Cloud Agent вы получите уведомление в Slack и сможете просмотреть созданный PR в GitHub.

Управление агентами

Чтобы просмотреть всех запущенных агентов, выполните @Cursor list my agents.

Управляйте Cloud Agents через контекстное меню: нажмите на три точки (⋯) в любом сообщении агента.

Доступные действия:

  • Add follow-up: Добавить инструкции существующему агенту
  • Delete: Остановить и архивировать Cloud Agent
  • View request ID: Просмотреть уникальный идентификатор запроса для устранения неполадок (укажите его при обращении в службу поддержки)
  • Give feedback: Оставить отзыв о работе агента

Конфигурация

Управляйте настройками по умолчанию и параметрами конфиденциальности в Dashboard → Cloud Agents.

Настройки

Модель по умолчанию

Используется, если в сообщении не указана модель. Доступные варианты см. в настройках.

Выбор репозитория

Cursor автоматически выбирает подходящий репозиторий на основе:

  1. Содержимого вашего сообщения — названий репозиториев или ключевых слов в промпте
  2. Недавней активности Agent — репозиториев, которые вы недавно использовали
  3. Правил маршрутизации — пользовательских сопоставлений ключевых слов с репозиториями (см. ниже)
  4. Репозитория по умолчанию — используется в качестве резервного варианта, если совпадений не найдено

Чтобы использовать конкретный репозиторий, укажите его имя в сообщении. Например: @Cursor in mobile-app, fix the login bug.

base-ветка

Ветка, от которой запускается Cloud Agent. Оставьте поле пустым, чтобы использовать ветку репозитория по умолчанию (часто main)

Настройки канала

Настройте параметры по умолчанию для канала с помощью @Cursor settings. Эти параметры действуют для всей команды и имеют приоритет над вашими личными настройками по умолчанию в этом канале.

Особенно полезно, если:

  • Разные каналы работают с разными репозиториями
  • Команды хотят использовать единые настройки для всех участников

Чтобы настроить параметры канала:

  1. Выполните @Cursor settings в нужном канале
  2. Задайте репозиторий по умолчанию для этого канала
  3. Все участники команды, использующие Cloud Agents в этом канале, будут использовать эти настройки по умолчанию

Правила маршрутизации

Правила маршрутизации позволяют задавать ключевые слова, автоматически направляющие запросы к нужной цели. Если ваше сообщение содержит ключевое слово, Cursor направляет Agent в соответствующий репозиторий или инфраструктуру облачного агента. Инфраструктура может включать несколько репозиториев, поэтому одно ключевое слово позволяет запустить Agent со всеми необходимыми репозиториями, уже настроенными.

Настройка правил маршрутизации

  1. Перейдите в Dashboard → Cloud Agents
  2. Найдите раздел Routing Rules
  3. Добавьте сопоставления ключевых слов с целями: для каждого ключевого слова укажите репозиторий или инфраструктуру

Примеры правил

Ключевое словоЦель
frontendacme/web-app
mobileacme/mobile-app
apiacme/backend-services
platformинфраструктура Platform

При такой настройке правил:

  • @Cursor fix the frontend nav bug → направляется в acme/web-app
  • @Cursor update the mobile onboarding flow → направляется в acme/mobile-app
  • @Cursor add a migration across the platform → запускается в инфраструктуре Platform со всеми доступными репозиториями

Как работает маршрутизация

Cursor анализирует ваше сообщение в следующем порядке:

  1. Содержимое сообщения — Названия репозиториев или ключевые слова в промпте
  2. Недавняя активность Agent — Репозитории, которые вы недавно использовали
  3. Правила маршрутизации — Пользовательские сопоставления ключевых слов с целевыми объектами (репозиторием или инфраструктурой)
  4. Канал по умолчанию — Репозиторий, заданный для этого канала
  5. Репозиторий по умолчанию — Резервный режим, если совпадений не найдено

Конфиденциальность

Cloud Agents поддерживают режим конфиденциальности.

Подробнее о режиме конфиденциальности или управляйте настройкам�� конфиденциальности.

Отображение сводки агента

Показывает сводки агента и изображения диффов. Может содержать пути к файлам или фрагменты кода. Можно включить или выключить.

Отображение сводок агентов во внешних каналах

При использовании Slack Connect с другими рабочими пространствами или каналами с внешними участниками, например гостями, включите отображение сводок агентов во внешних каналах.

Разрешения

Чтобы Cloud Agents могли работать в вашем рабочем пространстве, Cursor запрашивает следующие разрешения Slack:

РазрешениеОписание
app_mentions:readРаспознаёт @упоминания для запуска Cloud Agents и ответа на запросы
channels:historyЧитает предыдущие сообщения в тредах для контекста при добавлении дополнительных инструкций
channels:joinАвтоматически присоединяется к публичным каналам по приглашению или запросу
channels:readПолучает доступ к метаданным каналов (ID и названиям), чтобы публиковать ответы и обновления
chat:writeОтправляет обновления статуса, уведомления о завершении и ссылки на PR после завершения работы агентов
files:readСкачивает общие файлы (логи, скриншоты, примеры кода) для дополнительного контекста
files:writeЗагружает визуальные сводки изменений, внесённых агентами, для быстрого просмотра
groups:historyЧитает предыдущие сообщения в приватных каналах для контекста в многоэтапных диалогах
groups:readПолучает доступ к метаданным приватных каналов, чтобы публиковать ответы и поддерживать ход диалога
im:historyПолучает доступ к истории личных сообщений для контекста в продолженных диалогах
im:readЧитает метаданные личных сообщений, чтобы определять участников и корректно вести треды
im:writeИнициирует личные сообщения для приватных уведомлений или индивидуального общения
mpim:historyПолучает доступ к истории групповых личных сообщений для диалогов с несколькими участниками
mpim:readЧитает метаданные групповых личных сообщений, чтобы обращаться к участникам и обеспечивать корректную доставку
reactions:readОтслеживает реакции-эмодзи для получения обратной связи от пользователей и сигналов статуса
reactions:writeДобавляет реакции-эмодзи для обозначения статуса: ⏳ — выполняется, ✅ — завершено, ❌ — ошибка
team:readОпределяет сведения о рабочем пространстве, чтобы различать установки и применять настройки
users:readСопоставляет пользователей Slack с аккаунтами Cursor для управления правами доступа и обеспечения безопасности

Отказ от ответственности

Cursor может допускать ошибки. Пожалуйста, перепроверяйте код и ответы.

Политика конфиденциальности

Подробнее о том, как Cursor собирает, использует и защищает ваши данные, см. в нашей Политике конфиденциальности.