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
-
Ve a Cursor integrations
-
Haz clic en Connect junto a Slack o ve a la página de instalación
-
Se te pedirá que instales la app de Cursor para Slack en tu espacio de trabajo.
-
Después de instalarla en Slack, volverás a Cursor para finalizar la configuración
- Conecta un proveedor de repositorios (si aún no lo has hecho) y elige un repositorio predeterminado
- Activa los precios basados en consumo
- Confirma los ajustes de privacidad
-
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.
| Comando | Descripció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 settings | Configura 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 agents | Muestra tus agentes en ejecución |
@Cursor pool | Muestra 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 unset | Elimina el pool predeterminado del equipo (administradores de equipo) |
@Cursor pool set <name> channel | Establece el pool predeterminado de este canal (cualquier miembro del equipo) |
@Cursor pool unset channel | Elimina el pool predeterminado de este canal (cualquier miembro del equipo) |
Opciones
Personaliza el comportamiento del agente en la nube con estas opciones:
| Opción | Descripción | Ejemplo en lenguaje natural | Ejemplo inline |
|---|---|---|---|
repo | Usa un repositorio específico | en acme/backend | repo=acme/backend |
env / environment | Usa un entorno de agente en la nube con nombre | usa el entorno Platform | env=Platform |
branch | Usa una rama base específica | trabaja desde la rama dev | branch=dev |
model | Usa un modelo específico | con Opus | model=opus |
autopr | Activa o desactiva la creación automática de PR | Opción inline obligatoria | autopr=false |
worker / machine | Ejecuta en una Mi máquina con nombre | Opción inline obligatoria | worker=my-devbox |
pool | Ejecuta 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 equipo | Opción inline obligatoria | pool=my-pool |
self_hosted / sh | Ejecuta 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/0 | Opción inline obligatoria | self_hosted=true o sh=1 |
channel | Publica las actualizaciones del agente en otro canal al que tú y Cursor tengan acceso | Opción inline obligatoria | channel=#eng-bots |
Formatos de sintaxis
Natural:
@Cursor with opus, fix the login bug in backend-apiEn línea:
@Cursor env=Platform branch=dev model=opus autopr=false Fix the login bugUsa comillas en los nombres de entorno que contengan espacios:
@Cursor env="Platform Services" Update the shared APIPrioridad 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
envtiene prioridad sobrerepocuando ambos están presentespool,worker,machineyself_hosted=false(osh=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.
Los agentes en la nube leen todo el hilo para obtener contexto cuando se invocan, y comprenden e implementan soluciones basándose en la discusión del equipo.
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 billingFrases 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:
- El contenido de tu mensaje — Nombres de repositorios o palabras clave en tu instrucción
- Actividad reciente del agente — Repositorios que has usado recientemente
- Reglas de enrutamiento — Mapeos personalizados de palabras clave a repositorios (ver más abajo)
- 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.
Los ajustes del canal solo se aplican a canales públicos.
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:
- Ejecuta
@Cursor settingsen el canal deseado - Establece el repositorio predeterminado de ese canal
- 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.
Los ajustes del canal prevalecen sobre los valores predeterminados personales, pero puedes anularlos mencionando un repositorio específico en tu mensaje.
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
- Ve a Panel de control → Agentes en la nube
- Busca la sección Reglas de enrutamiento
- Añade mapeos de palabras clave a destinos y asigna cada palabra clave a un repositorio o entorno
Reglas de ejemplo
| Palabra clave | Destino |
|---|---|
frontend | acme/web-app |
mobile | acme/mobile-app |
api | acme/backend-services |
platform | entorno Platform |
Con estas reglas configuradas:
@Cursor fix the frontend nav bug→ se envía aacme/web-app@Cursor update the mobile onboarding flow→ se envía aacme/mobile-app@Cursor add a migration across the platform→ se inicia en el entornoPlatform, con todos sus repositorios listos
Enviar tareas a un entorno es útil para entornos con varios repositorios. Aprende a configurar uno en la documentación del agente en la nube, incluidos los entornos con varios repositorios.
Cómo funciona el enrutamiento
Cursor evalúa tu mensaje en este orden:
- Contenido de tu mensaje — Nombres de repositorios o palabras clave en tu instrucción
- Actividad reciente del agente — Repositorios que has usado recientemente
- Reglas de enrutamiento — Mapeos personalizados de palabras clave a destinos (repositorio o entorno)
- Valor predeterminado del canal — El repositorio configurado para este canal
- 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.
Los pools del equipo requieren un plan Enterprise. Los pools predeterminados del equipo y del canal solo se aplican mientras Allow autohospedadas Machines esté activado en el panel de control de agentes en la nube. Si un admin lo desactiva, Slack ignora ambos pools predeterminados y las menciones se ejecutan en la infraestructura gestionada de Cursor.
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:
- Opciones en tu mensaje.
pool=<name>apunta a ese pool.worker=omachine=apuntan a una de tus Mis máquinas.self_hosted=false(osh=0) se ejecuta en la infraestructura gestionada de Cursor. Cada una de estas opciones omite ambos pools predeterminados.self_hosted=true(osh=1) por sí solo usa el pool predeterminado del canal o, si el canal no tiene uno, el pool predeterminado del equipo. - Tu worker predeterminado de Mis máquinas. Si tienes un worker predeterminado propio para el repositorio, tiene prioridad sobre ambos pools predeterminados.
- Pool predeterminado del canal. Se usa cuando el canal en el que mencionas a Cursor tiene su propio pool.
- 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=opool=a la mención, usaself_hosted=falsepara ejecutar en infraestructura gestionada, o consulta el valor por defecto con@Cursor pooly@Cursor settings. - Repositorio resuelto y el pool lo atiende. Slack lanza el agente con
repo=ypool=establecidos, igual que con una mención explícitapool=<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 conpool=un pool que atienda este repositorio. - Todavía no se ha conectado ningún worker al pool.
@Cursor pool setacepta 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.
El modo de privacidad (heredado) no es compatible. Los agentes en la nube requieren almacenamiento temporal de código mientras se ejecutan.
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:
| Permiso | Descripción |
|---|---|
app_mentions:read | Detecta @menciones para iniciar agentes en la nube y responder a solicitudes |
channels:history | Lee mensajes anteriores en hilos para obtener contexto al añadir instrucciones adicionales |
channels:join | Se une automáticamente a canales públicos cuando se le invita o se le solicita |
channels:read | Accede a metadatos de canales (ID y nombres) para publicar respuestas y actualizaciones |
chat:write | Envía actualizaciones de estado, notificaciones de finalización y enlaces a PR cuando los agentes terminan |
files:read | Descarga archivos compartidos (registros, capturas de pantalla y ejemplos de código) para obtener contexto adicional |
files:write | Sube resúmenes visuales de los cambios realizados por los agentes para revisarlos rápidamente |
groups:history | Lee mensajes anteriores en canales privados para obtener contexto en conversaciones de varios turnos |
groups:read | Accede a metadatos de canales privados para publicar respuestas y mantener el flujo de la conversación |
im:history | Accede al historial de mensajes directos para obtener contexto en conversaciones continuadas |
im:read | Lee metadatos de mensajes directos para identificar a los participantes y mantener la organización adecuada de los hilos |
im:write | Inicia mensajes directos para notificaciones privadas o comunicaciones individuales |
mpim:history | Accede al historial de mensajes directos grupales para conversaciones con varios participantes |
mpim:read | Lee metadatos de mensajes directos grupales para dirigirse a los participantes y garantizar una entrega correcta |
reactions:read | Observa reacciones con emoji como comentarios de los usuarios y señales de estado |
reactions:write | Añade reacciones con emoji para indicar el estado: ⏳ en ejecución, ✅ completado, ❌ con error |
team:read | Identifica detalles del espacio de trabajo para distinguir instalaciones y aplicar ajustes |
users:read | Vincula 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.