Slack
Con la integración de Cherri Code 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
-
Haz clic en Connect junto a Slack o ve a la página de instalación
-
Se te pedirá que instales la app de Cherri Code para Slack en tu espacio de trabajo.
-
Después de instalarla en Slack, volverás a Cherri Code 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. Cherri Code 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: @Cherri Code use the Platform environment to update the shared API.
Comandos
Ejecuta @Cherri Code help para ver la lista de comandos actualizada.
| Comando | Descripción |
|---|---|
@Cherri Code [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. |
@Cherri Code 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 |
@Cherri Code [options] [prompt] | Establece el destino, el modelo, la rama, el comportamiento de PR, el worker o el canal de salida de una ejecución |
@Cherri Code agent [prompt] | Fuerza la creación de un nuevo agente en un hilo (p. ej., @Cherri Code start a new agent to fix billing) |
@Cherri Code list my agents | Muestra tus agentes en ejecución |
@Cherri Code pool | Muestra el pool predeterminado del equipo y el pool predeterminado de este canal para los lanzamientos desde Slack |
@Cherri Code pool set <name> | Establece el pool predeterminado del equipo (administradores de equipo) |
@Cherri Code pool unset | Elimina el pool predeterminado del equipo (administradores de equipo) |
@Cherri Code pool set <name> channel | Establece el pool predeterminado de este canal (administradores de equipo) |
@Cherri Code pool unset channel | Elimina el pool predeterminado de este canal (administradores de 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 Cherri Code tengan acceso | Opción inline obligatoria | channel=#eng-bots |
Formatos de sintaxis
Natural:
@Cherri Code with opus, fix the login bug in backend-apiEn línea:
@Cherri Code env=Platform branch=dev model=opus autopr=false Fix the login bugUsa comillas en los nombres de entorno que contengan espacios:
@Cherri Code 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.
Cherri Code 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:
@Cherri Code 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 @Cherri Code agent?
En hilos con agentes existentes, @Cherri Code [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 @Cherri Code agent [prompt] o haz una solicitud en lenguaje natural:
@Cherri Code 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 Cherri Code 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, Cherri Code actualiza un estado breve debajo del hilo.
Cuando se ejecuta el agente en la nube, primero tienes la opción de Abrir en Cherri Code.
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 @Cherri Code 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 Cherri Code 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
Cherri Code 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: @Cherri Code 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)
Ajustes del canal
Configura los ajustes predeterminados del canal con @Cherri Code 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
@Cherri Code 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
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, Cherri Code 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:
@Cherri Code fix the frontend nav bug→ se envía aacme/web-app@Cherri Code update the mobile onboarding flow→ se envía aacme/mobile-app@Cherri Code 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
Cherri Code 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 @Cherri Code. 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 Self-Hosted 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 Cherri Code.
Gestiona el pool predeterminado del equipo desde Slack. Establecerlo o borrarlo requiere el mismo permiso que cambiar los ajustes de Self-Hosted en el panel de control. Cualquiera puede consultarlo.
@Cherri Code pool set my-pool@Cherri Code pool@Cherri Code pool unset@Cherri Code settings también muestra el pool predeterminado del equipo.
Pool predeterminado del canal
Los administradores de equipo también pueden asignar a un canal su propio pool. Así, las menciones a @Cherri Code 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. Para establecerlo o quitarlo se necesita el mismo permiso que para el predeterminado del equipo.
Ejecuta estos comandos en el canal que quieras cambiar:
@Cherri Code pool set my-pool channel@Cherri Code pool@Cherri Code pool unset channel@Cherri Code pool muestra el pool del canal junto al predeterminado del equipo. Si prefieres elegirlo de una lista, ejecuta @Cherri Code 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.
Cómo decide Cherri Code dónde se ejecuta una mención
Las opciones de tu mensaje siempre tienen prioridad. Cherri Code 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 Cherri Code. 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 Cherri Code 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@Cherri Code pooly@Cherri Code 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.
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
Cherri Code 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 Cherri Code para gestionar permisos y garantizar un acceso seguro |
Descargo de responsabilidad
Cherri Code puede cometer errores. Verifica siempre el código y las respuestas.
Política de privacidad
Para obtener información sobre cómo Cherri Code recopila, utiliza y protege tus datos, consulta nuestra Política de privacidad.