Agentes de Cursor Cloud
Conecta AI SmartTalk con Agentes de Cursor Cloud para lanzar asistentes de codificación autónomos de IA directamente desde tus conversaciones o flujos de trabajo. Los Agentes de Cursor Cloud pueden leer repositorios, generar código, crear commits y abrir pull requests automáticamente.
Descripción general
La integración de Agentes de Cursor Cloud te permite:
- Lanzar agentes de codificación de IA en tus repositorios de GitHub
- Automatizar la generación de código a través de instrucciones en lenguaje natural
- Crear pull requests automáticamente cuando las tareas estén completas
- Monitorear el progreso del agente y ver el historial de conversaciones
- Agregar instrucciones de seguimiento a los agentes en ejecución
- Activar tareas de codificación desde flujos de trabajo de SmartFlow
Requisitos previos
Antes de comenzar, asegúrate de tener:
- Una cuenta activa de AI SmartTalk
- Una cuenta de Cursor con acceso a Agentes Cloud
- Una clave API de Cursor (obtenida desde tu panel de control de Cursor)
- Repositorios de GitHub accesibles desde tu cuenta de Cursor
Configuración paso a paso
Paso 1: Obtén tu clave API de Cursor
- Ve a tu panel de control de Agentes de Cursor Cloud
- Navega a la configuración de tu API
- Genera una nueva clave API para AI SmartTalk
- Copia la clave API
Paso 2: Accede a la integración de Cursor
- Inicia sesión en tu cuenta de AI SmartTalk
- Navega a Administración → Mis Asistentes → [Tu Nombre de Asistente]
- Haz clic en Conectores en la barra lateral izquierda
- Localiza Agentes de Cursor Cloud y haz clic en él
Paso 3: Configura la conexión
- Haz clic en Configurar Configuración
- Ingresa tu Clave API de Cursor
- Haz clic en Guardar Configuración
- AI SmartTalk valida automáticamente tu clave API
Paso 4: Sincroniza repositorios
Una vez conectado, AI SmartTalk sincroniza automáticamente los repositorios de GitHub accesibles desde tu cuenta de Cursor. También puedes actualizar manualmente la lista de repositorios en cualquier momento.
Tablero
Una vez conectado, el tablero de integración de Cursor proporciona una visión completa:
Resumen de estadísticas
| Métrica | Descripción |
|---|---|
| Total de Agentes | Número de agentes lanzados |
| En Ejecución | Agentes actualmente activos |
| Finalizados | Agentes completados |
| Modelos Disponibles | Modelos de IA disponibles para los agentes |
Asistentes Recientes
El tablero lista tus agentes más recientes con:
- ID del Agente para referencia
- Estado: En Ejecución, Completado, Fallido, Creando o Cancelado
- Repositorio en el que está trabajando el agente
- Fecha de creación
- Acciones rápidas: Ver Detalles y Ver PR
El tablero se actualiza automáticamente cada 30 segundos cuando los agentes están en ejecución.
Lanzando un Agente
Desde el Tablero
- Haz clic en Lanzar Nuevo Asistente
- Completa el formulario de lanzamiento:
| Campo | Requerido | Descripción |
|---|---|---|
| Repositorio | Sí | Selecciona un repositorio de GitHub del menú desplegable |
| Descripción de la Tarea | Sí | Describe lo que el agente debe hacer en lenguaje natural |
| Rama | No | Rama de Git en la que trabajar (predeterminado: main) |
| Modelo de IA | No | Selecciona un modelo de IA específico para el agente |
| Crear PR automáticamente | No | Crear automáticamente un pull request cuando esté terminado (predeterminado: habilitado) |
| Nombre de Rama | No | Nombre de rama personalizado para el pull request |
- Haz clic en Lanzar Agente
Ejemplos de Descripción de Tareas
- "Agregar pruebas unitarias para el módulo de autenticación"
- "Refactorizar el grupo de conexiones a la base de datos para usar reciclaje de conexiones"
- "Arreglar el error donde las sesiones de usuario expiran prematuramente en móviles"
- "Agregar definiciones de tipos de TypeScript para todos los objetos de respuesta de la API"
- "Crear un endpoint de API REST para preferencias de usuario"
Gestión de Agentes
Ver Detalles del Agente
Haz clic en Ver Detalles en cualquier agente para ver:
Pestaña de Resumen:
- ID del Agente y estado actual
- Información del repositorio y rama
- Enlace al pull request (si se creó)
- Resumen del trabajo realizado
- Marca de tiempo de creación
Pestaña de Conversación:
- Historial completo de mensajes del trabajo del agente
- Instrucciones del usuario y respuestas de IA
- Registro de progreso paso a paso
Agregar Instrucciones de Seguimiento
Puedes enviar instrucciones adicionales a un agente en ejecución:
- Abre los detalles del agente
- Ingresa tu instrucción de seguimiento (por ejemplo, "También agrega manejo de errores para el caso extremo cuando no se encuentra al usuario")
- El agente continúa su trabajo con el nuevo contexto
Eliminar un Agente
Para limpiar recursos:
- Haz clic en la acción de eliminar en la tarjeta del agente
- Confirma la eliminación
- El agente y sus recursos son eliminados
Integración de SmartFlow
Los Agentes de Cursor Cloud pueden ser utilizados como acciones en flujos de trabajo de SmartFlow, habilitando potentes escenarios de automatización.
Acciones Disponibles en SmartFlow
| Acción | Descripción |
|---|---|
| Lanzar Agente de Codificación | Iniciar un agente en un repositorio con instrucciones específicas |
| Agregar Seguimiento | Enviar instrucciones adicionales a un agente en ejecución |
| Obtener Estado del Agente | Verificar el progreso y estado de un agente |
| Eliminar Agente | Remover un agente y limpiar recursos |
Ejemplo: Corrección Automática en Informe de Error
Trigger: Servicio de Chat (cuando el usuario informa un error)
Actions:
1. Solicitud de IA:
Prompt: Extraer la descripción del error y el repositorio afectado
2. Lanzar Agente de Cursor:
Repositorio: {{extracted_repository}}
Tarea: "Arreglar este error: {{bug_description}}"
Crear PR automáticamente: true
3. Enviar Mensaje:
Texto: "He lanzado un agente de codificación para arreglar esto. Te notificaré cuando el PR esté listo."
4. Esperar / Consultar:
Verificar Estado del Agente periódicamente
5. Enviar Mensaje:
Texto: "¡La corrección está lista! Revisa el PR aquí: {{pr_url}}"
Ejemplo: Mejoras de Código Programadas
Trigger: Flujo de Trabajo Programado (semanal)
Actions:
1. Lanzar Agente de Cursor:
Repositorio: my-org/my-app
Tarea: "Revisar y actualizar todas las dependencias obsoletas"
Rama: chore/update-deps
Crear PR automáticamente: true
Para parámetros detallados de acciones de SmartFlow, consulta Acciones de SmartFlow de Cursor.
Casos de Uso
Bot de Soporte para Desarrolladores
Permite a los usuarios solicitar cambios de código a través del chat:
- "¿Puedes agregar validación de entrada al formulario de registro?"
- "Por favor, crea un script de migración para los nuevos campos de usuario"
Corrección Automática de Errores
Activa agentes de codificación a partir de informes de errores o alertas de monitoreo para generar automáticamente PRs de corrección.
Automatización de Revisión de Código
Lanza agentes para revisar código, agregar pruebas o mejorar documentación basada en comentarios de PR.
Mantenimiento Programado
Configura flujos de trabajo recurrentes para actualizar dependencias, ejecutar correcciones de linting o generar informes.
Solución de Problemas
| Problema | Solución |
|---|---|
| "Clave API inválida" | Regenera tu clave API desde el panel de control de Cursor |
| "Repositorio no encontrado" | Haz clic en Actualizar para re-sincronizar repositorios. Asegúrate de que el repo sea accesible desde tu cuenta de Cursor |
| Agente atascado en "Creando" | El agente puede estar en cola. Espera unos minutos y verifica el estado nuevamente |
| Agente fallido | Abre los detalles del agente para ver la conversación y los mensajes de error |
| PR no creado | Verifica que la opción de crear PR automáticamente esté habilitada y que el agente haya completado exitosamente |
| No hay repositorios disponibles | Asegúrate de que tu cuenta de Cursor tenga repositorios de GitHub conectados |
Gestión de la Integración
| Acción | Cómo |
|---|---|
| Conectar | Ingresa la clave API en la configuración de la integración |
| Ver tablero | Abre la página de integración de Cursor |
| Sincronizar repositorios | Haz clic en Actualizar para actualizar la lista de repositorios |
| Desconectar | Elimina la clave API de la configuración |
Mejores Prácticas
- Escribe descripciones de tareas claras: Cuanto más específicas sean tus instrucciones, mejor será la salida del agente.
- Utiliza ramas apropiadas: No lances agentes directamente en
main— deja que creen PRs para revisión. - Habilita la creación automática de PR: Facilita la revisión y fusión del trabajo del agente.
- Monitorea los agentes en ejecución: Revisa el panel regularmente o configura notificaciones de SmartFlow.
- Revisa antes de fusionar: Siempre revisa los PR generados por el agente antes de fusionarlos en producción.
- Comienza pequeño: Empieza con tareas bien definidas antes de intentar grandes refactorizaciones.