Skip to main content

Command Palette

Search for a command to run...

Integraciones

Slack

Con la integración de Cursor para Slack, puedes usar agentes en la nube para trabajar en tus tareas directamente desde Slack mencionando @cursor con una instrucción.

Primeros pasos

Instalación

  1. Ve a Cursor integrations

  2. Haz clic en Connect junto a Slack o ve a la página de instalación

  3. Se te pedirá que instales la app de Cursor para Slack en tu espacio de trabajo.

  4. Después de instalarla en Slack, volverás a Cursor para finalizar la configuración

    1. Conecta un proveedor de repositorios (si aún no lo has hecho) y elige un repositorio predeterminado
    2. Activa los precios basados en consumo
    3. Confirma los ajustes de privacidad
  5. Empieza a usar agentes en la nube en Slack mencionando @cursor

Cómo usarlo

Menciona @cursor e indica tu instrucción. Cursor intenta detectar un repositorio, un modelo, una rama base o un entorno de agente en la nube con nombre a partir de tu mensaje. También usa tu actividad reciente con agentes al seleccionar un repositorio.

Para un entorno con nombre, incluye su nombre en la instrucción. Por ejemplo: @Cursor use the Platform environment to update the shared API.

Comandos

Ejecuta @Cursor help para ver la lista de comandos actualizada.

ComandoDescripción
@Cursor [prompt]Inicia un agente en la nube. En hilos con agentes existentes, añade instrucciones adicionales. Quién puede hacer seguimiento se controla mediante los seguimientos del equipo, no solo por la titularidad.
@Cursor settingsConfigura los valores predeterminados y el repositorio predeterminado del canal. También muestra el pool predeterminado del equipo y el pool predeterminado del canal
@Cursor [options] [prompt]Establece el destino, el modelo, la rama, el comportamiento de PR, el worker o el canal de salida de una ejecución
@Cursor agent [prompt]Fuerza la creación de un nuevo agente en un hilo (p. ej., @Cursor start a new agent to fix billing)
@Cursor list my agentsMuestra tus agentes en ejecución
@Cursor poolMuestra el pool predeterminado del equipo y el pool predeterminado de este canal para los lanzamientos desde Slack
@Cursor pool set <name>Establece el pool predeterminado del equipo (administradores de equipo)
@Cursor pool unsetElimina el pool predeterminado del equipo (administradores de equipo)
@Cursor pool set <name> channelEstablece el pool predeterminado de este canal (cualquier miembro del equipo)
@Cursor pool unset channelElimina el pool predeterminado de este canal (cualquier miembro del equipo)

Opciones

Personaliza el comportamiento del agente en la nube con estas opciones:

OpciónDescripciónEjemplo en lenguaje naturalEjemplo inline
repoUsa un repositorio específicoen acme/backendrepo=acme/backend
env / environmentUsa un entorno de agente en la nube con nombreusa el entorno Platformenv=Platform
branchUsa una rama base específicatrabaja desde la rama devbranch=dev
modelUsa un modelo específicocon Opusmodel=opus
autoprActiva o desactiva la creación automática de PROpción inline obligatoriaautopr=false
worker / machineEjecuta en una Mi máquina con nombreOpción inline obligatoriaworker=my-devbox
poolEjecuta en un pool del equipo con nombre. Opcional cuando el canal tiene un pool predeterminado del canal o tu equipo tiene un pool predeterminado del equipoOpción inline obligatoriapool=my-pool
self_hosted / shEjecuta en uno de los pools del equipo. Usa el pool predeterminado del canal o el pool predeterminado del equipo cuando hay uno establecido, y self_hosted=false omite ambos. Acepta true/t/1 o false/f/0Opción inline obligatoriaself_hosted=true o sh=1
channelPublica las actualizaciones del agente en otro canal al que tú y Cursor tengan accesoOpción inline obligatoriachannel=#eng-bots

Formatos de sintaxis

Natural:

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

En línea:

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

Usa comillas en los nombres de entorno que contengan espacios:

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

Prioridad de las opciones

Al combinar opciones:

  • Los valores explícitos anulan los valores predeterminados
  • Los valores posteriores anulan los anteriores si están duplicados
  • Las opciones inline tienen prioridad sobre los valores predeterminados del cuadro de diálogo de ajustes
  • env tiene prioridad sobre repo cuando ambos están presentes
  • pool, worker, machine y self_hosted=false (o sh=0) tienen prioridad sobre el pool predeterminado del canal y el pool predeterminado del equipo

El bot analiza las opciones en cualquier parte del mensaje, lo que permite escribir comandos de forma natural.

Cursor ignora las opciones key=value dentro de bloques de código delimitados por triples comillas invertidas, aunque ocupen una sola línea, y conserva el código tal cual en tu instrucción. En este mensaje, pool=None está dentro del bloque de código, así que no se selecciona ningún pool:

@Cursor why does this crash? ```engine = create_engine(db_url, pool=None)```

Uso del contexto del hilo

Los agentes en la nube comprenden y usan el contexto de las conversaciones de los hilos existentes. Es útil cuando tu equipo debate un problema y quieres que el agente implemente la solución basándose en esa conversación.

Cuándo usar comandos de forzado

¿Cuándo necesito @Cursor agent?

En hilos con agentes existentes, @Cursor [prompt] añade instrucciones adicionales. Quién puede hacer seguimiento se controla mediante Seguimientos del equipo. Si los seguimientos del equipo están desactivados, solo el propietario puede hacer seguimiento. Para iniciar un agente independiente, usa @Cursor agent [prompt] o haz una solicitud en lenguaje natural:

@Cursor start a new agent to refactor billing

Frases como "crear un nuevo agente", "iniciar un agente nuevo" o "nuevo agente, por favor" funcionan igual.

¿Cuándo necesito Add follow-up (desde el menú contextual)?

Usa el menú contextual (⋯) en la respuesta de un agente para añadir instrucciones adicionales. Es útil cuando hay varios agentes en un hilo y necesitas especificar a cuál quieres hacer seguimiento.

Actualizaciones de estado y transferencia

Antes de que Cursor empiece a cambiar el código, publica un plan breve en el hilo cuando estás solucionando un error o cuando los detalles de implementación te ayuden a seguir el proceso. Las solicitudes sencillas omiten esa nota. Mientras trabaja, Cursor actualiza un estado breve debajo del hilo.

Cuando se ejecuta el agente en la nube, primero tienes la opción de Abrir en Cursor.

Cuando el agente en la nube termina, recibes una notificación en Slack y la opción de consultar la PR creada en GitHub.

Gestión de agentes

Para consultar todos los agentes en ejecución, ejecuta @Cursor list my agents.

Gestiona los agentes en la nube desde el menú contextual; haz clic en los tres puntos (⋯) de cualquier mensaje del agente.

Opciones disponibles:

  • Añadir seguimiento: Añade instrucciones a un agente existente
  • Cambiar de repositorio: Vuelve a lanzar la misma solicitud en otro repositorio o entorno de agente en la nube
  • Eliminar: Detén y archiva el agente en la nube
  • Consultar ID de solicitud: Consulta el ID de solicitud único para solucionar problemas (inclúyelo al contactar con soporte)
  • Enviar comentarios: Envía comentarios sobre el rendimiento del agente

Si el agente necesita un repositorio o entorno distinto del actual, Slack también muestra Cambiar de repositorio en el mensaje de lanzamiento. Elige el nuevo destino y Cursor continuará desde ahí.

Configuración

Gestiona los ajustes predeterminados y las opciones de privacidad desde el Panel de control → Agentes en la nube.

Ajustes

Modelo predeterminado

Se usa cuando no se especifica ningún modelo en tu mensaje. Consulta los ajustes para ver las opciones disponibles.

Selección de repositorio

Cursor selecciona automáticamente el repositorio adecuado en función de:

  1. El contenido de tu mensaje — Nombres de repositorios o palabras clave en tu instrucción
  2. Actividad reciente del agente — Repositorios que has usado recientemente
  3. Reglas de enrutamiento — Mapeos personalizados de palabras clave a repositorios (ver más abajo)
  4. Repositorio predeterminado — Alternativa si no se encuentra ninguna coincidencia

Para usar un repositorio específico, incluye su nombre en tu mensaje. Por ejemplo: @Cursor in mobile-app, fix the login bug.

Rama base

Rama de inicio del agente en la nube. Déjelo en blanco para usar la rama predeterminada del repositorio (normalmente main)

Equipo para los agentes de Slack

Si perteneces a más de un equipo de pago de Cursor, elige en qué equipo se ejecutan tus agentes de Slack. Los agentes que inicies desde Slack se ejecutan, se facturan y usan los ajustes de ese equipo. Selecciónalo en Cursor Team al vincular tu cuenta de Slack o cámbialo más adelante con Equipo para los agentes de Slack en Panel de control → Agentes en la nube. Si tu espacio de trabajo de Slack está restringido a un solo equipo de Cursor, los agentes de Slack siempre se ejecutan en ese equipo.

Ajustes del canal

Configura los ajustes predeterminados del canal con @Cursor settings. Estos ajustes se aplican a todo el equipo y prevalecen sobre tus valores predeterminados personales en ese canal.

Resulta especialmente útil cuando:

  • Distintos canales trabajan con repositorios diferentes
  • Los equipos quieren mantener ajustes coherentes para todos sus miembros

Para configurar los ajustes del canal:

  1. Ejecuta @Cursor settings en el canal deseado
  2. Establece el repositorio predeterminado de ese canal
  3. Todos los miembros del equipo que usen agentes en la nube en ese canal usarán estos valores predeterminados

Cualquier persona de tu equipo de Cursor puede cambiar el repositorio predeterminado o el pool predeterminado de un canal. Cursor responde en el hilo del mensaje @Cursor settings indicando quién hizo cada cambio y el nuevo valor. Si el cambio reemplaza un valor predeterminado existente, la respuesta incluye ambos valores; por ejemplo: "cambió el pool autohospedado predeterminado de este canal de secure a gpu". Si el canal ya tenía ese valor, recibirás una respuesta privada indicando que no hubo ningún cambio.

Reglas de enrutamiento

Las reglas de enrutamiento te permiten definir palabras clave que se asignan automáticamente a un destino. Cuando tu mensaje contiene una palabra clave, Cursor dirige al agente al repositorio asociado o al entorno de agente en la nube. Los entornos pueden incluir varios repositorios, por lo que una sola palabra clave puede iniciar un agente con todos los repositorios necesarios ya configurados.

Configuración de reglas de enrutamiento

  1. Ve a Panel de control → Agentes en la nube
  2. Busca la sección Reglas de enrutamiento
  3. Añade mapeos de palabras clave a destinos y asigna cada palabra clave a un repositorio o entorno

Reglas de ejemplo

Palabra claveDestino
frontendacme/web-app
mobileacme/mobile-app
apiacme/backend-services
platformentorno Platform

Con estas reglas configuradas:

  • @Cursor fix the frontend nav bug → se envía a acme/web-app
  • @Cursor update the mobile onboarding flow → se envía a acme/mobile-app
  • @Cursor add a migration across the platform → se inicia en el entorno Platform, con todos sus repositorios listos

Cómo funciona el enrutamiento

Cursor evalúa tu mensaje en este orden:

  1. Contenido de tu mensaje — Nombres de repositorios o palabras clave en tu instrucción
  2. Actividad reciente del agente — Repositorios que has usado recientemente
  3. Reglas de enrutamiento — Mapeos personalizados de palabras clave a destinos (repositorio o entorno)
  4. Valor predeterminado del canal — El repositorio configurado para este canal
  5. Repositorio predeterminado — Se usa cuando no se encuentra ninguna coincidencia

Pool predeterminado del equipo

Los administradores de equipo pueden establecer un pool del equipo como pool predeterminado del equipo para los lanzamientos con @Cursor. Así, los miembros se ejecutan en ese pool sin tener que añadir pool=<name> o self_hosted=true en cada mención. El pool predeterminado del equipo se aplica a todo el equipo, en todos los canales que no tengan un pool predeterminado del canal.

Gestiona el pool predeterminado del equipo desde Slack. Establecerlo o borrarlo requiere el mismo permiso que cambiar los ajustes de autohospedado en el panel de control. Cualquiera puede consultarlo.

@Cursor pool set my-pool@Cursor pool@Cursor pool unset

@Cursor settings también muestra el pool predeterminado del equipo.

Pool predeterminado del canal

Cualquier miembro de tu equipo de Cursor puede asignar a un canal su propio pool, del mismo modo que puede establecer el repositorio predeterminado del canal. Así, las menciones a @Cursor en ese canal se ejecutan en el pool del canal en lugar del predeterminado del equipo, mientras que los demás canales siguen usando el predeterminado del equipo. El predeterminado del equipo sigue estando reservado a los administradores.

Ejecuta estos comandos en el canal que quieras cambiar:

@Cursor pool set my-pool channel@Cursor pool@Cursor pool unset channel

@Cursor pool muestra el pool del canal junto al predeterminado del equipo. Si prefieres elegirlo de una lista, ejecuta @Cursor settings, haz clic en Set Pool for Channel y selecciona uno de los pools de tu equipo. Para quitarlo, elige Use the team default (no channel pool). A partir de ese momento, las menciones en el canal vuelven a usar el pool predeterminado del equipo.

Cursor anuncia los cambios de pool igual que los demás ajustes del canal. La respuesta indica quién estableció, cambió o eliminó el pool y aparece en un hilo bajo tu comando @Cursor pool, o bajo el mensaje de @Cursor settings si lo eliges de la lista.

Cómo decide Cursor dónde se ejecuta una mención

Las opciones de tu mensaje siempre tienen prioridad. Cursor resuelve el destino en este orden:

  1. Opciones en tu mensaje. pool=<name> apunta a ese pool. worker= o machine= apuntan a una de tus Mis máquinas. self_hosted=false (o sh=0) se ejecuta en la infraestructura gestionada de Cursor. Cada una de estas opciones omite ambos pools predeterminados. self_hosted=true (o sh=1) por sí solo usa el pool predeterminado del canal o, si el canal no tiene uno, el pool predeterminado del equipo.
  2. Tu worker predeterminado de Mis máquinas. Si tienes un worker predeterminado propio para el repositorio, tiene prioridad sobre ambos pools predeterminados.
  3. Pool predeterminado del canal. Se usa cuando el canal en el que mencionas a Cursor tiene su propio pool.
  4. Pool predeterminado del equipo. Se usa cuando tu mensaje no incluye ninguna de las opciones anteriores y el canal no tiene su propio pool.

Repositorios y pools predeterminados

La selección de repositorio funciona igual con un pool predeterminado del canal o del equipo: contenido del mensaje, actividad reciente, reglas de enrutamiento, valor por defecto del canal y, por último, tu repositorio predeterminado y el del equipo. Lo que ocurre después depende de cómo esté registrado el pool:

  • Pool de cualquier repositorio, sin repositorio resuelto. Slack inicia un agente en el pool sin repositorio. El source control queda a cargo del worker, como en cualquier pool de cualquier repositorio. Si sí se resuelve un repositorio predeterminado, el agente lo recibe como contexto, sin limitar qué workers pueden tomar la ejecución.
  • Pool vinculado a un repositorio, sin repositorio resuelto. Slack rechaza la mención con una respuesta efímera en lugar de recurrir a la infraestructura gestionada. Añade repo= o pool= a la mención, usa self_hosted=false para ejecutar en infraestructura gestionada, o consulta el valor por defecto con @Cursor pool y @Cursor settings.
  • Repositorio resuelto y el pool lo atiende. Slack lanza el agente con repo= y pool= establecidos, igual que con una mención explícita pool=<name>.
  • Repositorio resuelto, pero los workers del pool solo atienden otros repositorios. Slack rechaza la mención con una respuesta efímera. Elige con repo= un repositorio que el pool atienda, o con pool= un pool que atienda este repositorio.
  • Todavía no se ha conectado ningún worker al pool. @Cursor pool set acepta cualquier nombre, porque los pools son persistentes y sus workers van y vienen. Una mención que resuelve un repositorio queda en espera en el pool hasta que se une un worker. Una mención sin repositorio se rechaza con una respuesta efímera.

Privacidad

Los agentes en la nube admiten el modo de privacidad.

Obtén más información sobre el modo de privacidad o gestiona tus ajustes de privacidad.

Mostrar resumen del agente

Muestra resúmenes del agente e imágenes de diferencias. Puede contener rutas de archivo o fragmentos de código. Se puede activar o desactivar.

Mostrar el resumen del agente en canales externos

En Slack Connect con otros espacios de trabajo o en canales con miembros externos, como invitados, elija mostrar los resúmenes de los agentes en canales externos.

Permisos

Cursor solicita estos permisos de Slack para que los agentes en la nube funcionen en tu espacio de trabajo:

PermisoDescripción
app_mentions:readDetecta @menciones para iniciar agentes en la nube y responder a solicitudes
channels:historyLee mensajes anteriores en hilos para obtener contexto al añadir instrucciones adicionales
channels:joinSe une automáticamente a canales públicos cuando se le invita o se le solicita
channels:readAccede a metadatos de canales (ID y nombres) para publicar respuestas y actualizaciones
chat:writeEnvía actualizaciones de estado, notificaciones de finalización y enlaces a PR cuando los agentes terminan
files:readDescarga archivos compartidos (registros, capturas de pantalla y ejemplos de código) para obtener contexto adicional
files:writeSube resúmenes visuales de los cambios realizados por los agentes para revisarlos rápidamente
groups:historyLee mensajes anteriores en canales privados para obtener contexto en conversaciones de varios turnos
groups:readAccede a metadatos de canales privados para publicar respuestas y mantener el flujo de la conversación
im:historyAccede al historial de mensajes directos para obtener contexto en conversaciones continuadas
im:readLee metadatos de mensajes directos para identificar a los participantes y mantener la organización adecuada de los hilos
im:writeInicia mensajes directos para notificaciones privadas o comunicaciones individuales
mpim:historyAccede al historial de mensajes directos grupales para conversaciones con varios participantes
mpim:readLee metadatos de mensajes directos grupales para dirigirse a los participantes y garantizar una entrega correcta
reactions:readObserva reacciones con emoji como comentarios de los usuarios y señales de estado
reactions:writeAñade reacciones con emoji para indicar el estado: ⏳ en ejecución, ✅ completado, ❌ con error
team:readIdentifica detalles del espacio de trabajo para distinguir instalaciones y aplicar ajustes
users:readVincula usuarios de Slack con cuentas de Cursor para gestionar permisos y garantizar un acceso seguro

Descargo de responsabilidad

Cursor puede cometer errores. Verifica siempre el código y las respuestas.

Política de privacidad

Para obtener información sobre cómo Cursor recopila, utiliza y protege tus datos, consulta nuestra Política de privacidad.