Slack
Интеграция Cursor со Slack позволяет использовать Cloud Agents для работы над задачами прямо в Slack: упомяните @cursor и добавьте промпт.
Быстрый старт
Установка
-
Перейдите в интеграции Cursor
-
Нажмите Подключить рядом со Slack или перейдите отсюда на страницу установки
-
Вам будет предложено установить приложение Cursor для Slack в рабочем пространстве.
-
После установки в Slack вы будете перенаправлены обратно в Cursor, чтобы завершить настройку
- Подключите провайдера репозиториев (если ещё не подключён) и выберите репозиторий по умолчанию
- Включите оплату по фактическому использованию
- Подтвердите настройки конфиденциальности
-
Начните использовать 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/backend | repo=acme/backend |
env / environment | Использовать именованную инфраструктуру облачного агента | use the Platform environment | env=Platform |
branch | Использовать указанную base-ветку | work from the dev branch | branch=dev |
model | Использовать указанную модель | with opus | model=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 понимают и используют контекст существующих обсуждений в тредах. Это удобно, когда ваша команда обсуждает проблему и вы хотите, чтобы агент реализовал решение на основе этого диалога.
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 автоматически выбирает подходящий репозиторий на основе:
- Содержимого вашего сообщения — названий репозиториев или ключевых слов в промпте
- Недавней активности Agent — репозиториев, которые вы недавно использовали
- Правил маршрутизации — пользовательских сопоставлений ключевых слов с репозиториями (см. ниже)
- Репозитория по умолчанию — используется в качестве резервного варианта, если совпадений не найдено
Чтобы использовать конкретный репозиторий, укажите его имя в сообщении. Например: @Cursor in mobile-app, fix the login bug.
base-ветка
Ветка, от которой запускается Cloud Agent. Оставьте поле пустым, чтобы использовать ветку репозитория по умолчанию (часто main)
Настройки канала
Настройте параметры по умолчанию для канала с помощью @Cursor settings. Эти параметры действуют для всей команды и имеют приоритет над вашими личными настройками по умолчанию в этом канале.
Настройки канала применяются только к публичным каналам.
Особенно полезно, если:
- Разные каналы работают с разными репозиториями
- Команды хотят использовать единые настройки для всех участников
Чтобы настроить параметры канала:
- Выполните
@Cursor settingsв нужном канале - Задайте репозиторий по умолчанию для этого канала
- Все участники команды, использующие Cloud Agents в этом канале, будут использовать эти настройки по умолчанию
Настройки канала имеют приоритет над личными настройками по умолчанию, но их можно переопределить, указав конкретный репозиторий в сообщении.
Правила маршрутизации
Правила маршрутизации позволяют задавать ключевые слова, автоматически направляющие запросы к нужной цели. Если ваше сообщение содержит ключевое слово, Cursor направляет Agent в соответствующий репозиторий или инфраструктуру облачного агента. Инфраструктура может включать несколько репозиториев, поэтому одно ключевое слово позволяет запустить Agent со всеми необходимыми репозиториями, уже настроенными.
Настройка правил маршрутизации
- Перейдите в Dashboard → Cloud Agents
- Найдите раздел Routing Rules
- Добавьте сопоставления ключевых слов с целями: для каждого ключевого слова укажите репозиторий или инфраструктуру
Примеры правил
| Ключевое слово | Цель |
|---|---|
frontend | acme/web-app |
mobile | acme/mobile-app |
api | acme/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 анализирует ваше сообщение в следующем порядке:
- Содержимое сообщения — Названия репозиториев или ключевые слова в промпте
- Недавняя активность Agent — Репозитории, которые вы недавно использовали
- Правила маршрутизации — Пользовательские сопоставления ключевых слов с целевыми объектами (репозиторием или инфраструктурой)
- Канал по умолчанию — Репозиторий, заданный для этого канала
- Репозиторий по умолчанию — Резервный режим, если совпадений не найдено
Конфиденциальность
Cloud Agents поддерживают режим конфиденциальности.
Подробнее о режиме конфиденциальности или управляйте настройкам�� конфиденциальности.
Режим конфиденциальности (устаревшая версия) не поддерживается. 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 собирает, использует и защищает ваши данные, см. в нашей Политике конфиденциальности.