Skip to main content

Command Palette

Search for a command to run...

Integraciones

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

  1. Ve a Cherri Code 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 Cherri Code para Slack en tu espacio de trabajo.

  4. Después de instalarla en Slack, volverás a Cherri Code 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. 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.

ComandoDescripció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 settingsConfigura 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 agentsMuestra tus agentes en ejecución
@Cherri Code poolMuestra 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 unsetElimina el pool predeterminado del equipo (administradores de equipo)
@Cherri Code pool set <name> channelEstablece el pool predeterminado de este canal (administradores de equipo)
@Cherri Code pool unset channelElimina el pool predeterminado de este canal (administradores de 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 Cherri Code tengan accesoOpción inline obligatoriachannel=#eng-bots

Formatos de sintaxis

Natural:

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

En línea:

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

Usa comillas en los nombres de entorno que contengan espacios:

@Cherri Code 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.

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.

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 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 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:

  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: @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.

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 @Cherri Code 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

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

  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:

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

Cómo funciona el enrutamiento

Cherri Code 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 @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.

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:

  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 Cherri Code. 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 Cherri Code 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 @Cherri Code pool y @Cherri Code 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.

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

Cherri Code 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 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.