Cursor
Inicia y gestiona agentes en la nube de Cursor para trabajar en repositorios de GitHub
Configuración
Iniciar agente
Operación
Iniciar agente
Clave de API*
••••••••
URL del repositorio*
https://github.com/your-org/your-repo
Rama/Ref
main (opcional)
Prompt*
Describe la tarea para el agente...
Modelo
Selección automática por defecto
Nombre de la rama
Nombre de rama personalizado (opcional)
Crear PR automáticamente
Disabled
Abrir como aplicación de GitHub de Cursor
Disabled
Omitir solicitud de revisor
Disabled
Iniciar agente (
cursor_launch_agent)Inicia un nuevo agente en la nube para trabajar en un repositorio de GitHub con las instrucciones proporcionadas.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de Cursor |
repository | string | Sí | URL del repositorio de GitHub (p. ej., https://github.com/your-org/your-repo) |
ref | string | No | Rama, etiqueta o commit desde el que trabajar (por defecto, la rama predeterminada) |
promptText | string | Sí | El texto de instrucción para el agente |
promptImages | string | No | Array JSON de objetos de imagen con datos base64 y dimensiones |
model | string | No | Modelo a usar (dejar vacío para selección automática) |
branchName | string | No | Nombre de rama personalizado para que lo use el agente |
autoCreatePr | boolean | No | Crear automáticamente un PR cuando el agente termine |
openAsCursorGithubApp | boolean | No | Abrir el PR como la app de GitHub de Cursor |
skipReviewerRequest | boolean | No | Omitir la solicitud de revisores en el PR |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
content | string | Mensaje de éxito con los detalles del agente |
metadata | object | Metadatos del resultado del lanzamiento |
Añadir seguimiento
Operación
Añadir seguimiento
Clave de API*
••••••••
ID del agente*
p. ej., bc_abc123
Prompt de seguimiento*
Instrucciones adicionales para el agente...
Agregar seguimiento (
cursor_add_followup)Agrega una instrucción de seguimiento a un agente en la nube existente.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de Cursor |
agentId | string | Sí | Identificador único del agente en la nube (p. ej., bc_abc123) |
followupPromptText | string | Sí | Texto de la instrucción de seguimiento para el agente |
promptImages | string | No | Arreglo JSON de objetos de imagen con datos en base64 y dimensiones (máx. 5) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
content | string | Mensaje de éxito |
metadata | object | Metadatos del resultado |
Obtener estado del agente
Operación
Obtener estado del agente
Clave de API*
••••••••
ID del agente*
p. ej., bc_abc123
Obtener estado del agente (
cursor_get_agent)Recuperar el estado actual y los resultados de un agente en la nube.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de Cursor |
agentId | string | Sí | Identificador único para el agente en la nube (p. ej., bc_abc123) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
content | string | Detalles del agente legibles por humanos |
metadata | object | Metadatos del agente |
Obtener conversación
Operación
Obtener conversación
Clave de API*
••••••••
ID del agente*
p. ej., bc_abc123
Obtener conversación (
cursor_get_conversation)Recuperar el historial de conversación de un agente en la nube, incluidos todos los prompts del usuario y las respuestas del asistente.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de Cursor |
agentId | string | Sí | Identificador único para el agente en la nube (p. ej., bc_abc123) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
content | string | Historial de conversación legible |
metadata | object | Metadatos de la conversación |
Listar agentes
Operación
Listar agentes
Clave de API*
••••••••
Límite
20 (predeterminado, máx. 100)
Cursor de paginación
Cursor de la respuesta anterior
Listar agentes (
cursor_list_agents)Listar todos los agentes en la nube para el usuario autenticado con paginación opcional.
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de Cursor |
limit | number | No | Número de agentes a devolver (predeterminado: 20, máx.: 100) |
cursor | string | No | Cursor de paginación de la respuesta anterior |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
content | string | Lista legible de agentes |
metadata | object | Metadatos de la lista de agentes |
Detener agente
Operación
Detener agente
Clave de API*
••••••••
ID del agente*
p. ej., bc_abc123
Detener agente (
cursor_stop_agent)Detiene un agente en la nube en ejecución. Pausa el agente sin eliminarlo.
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de Cursor |
agentId | string | Sí | Identificador único del agente en la nube (p. ej., bc_abc123) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
content | string | Mensaje de éxito |
metadata | object | Metadatos del resultado |
Eliminar agente
Operación
Eliminar agente
Clave de API*
••••••••
ID del agente*
p. ej., bc_abc123
Eliminar agente (
cursor_delete_agent)Elimina permanentemente un agente en la nube. Esta acción no se puede deshacer.
Entrada
| Parámetro | Tipo | ¿Obligatorio? | Descripción |
|---|---|---|---|
apiKey | string | Sí | Clave de API de Cursor |
agentId | string | Sí | Identificador único del agente en la nube (p. ej., bc_abc123) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
content | string | Mensaje de éxito |
metadata | object | Metadatos del resultado |
Instrucciones de uso
Interactúa con la API de Cursor Cloud Agents para lanzar agentes de IA que pueden trabajar en tus repositorios de GitHub. Admite el lanzamiento de agentes, la incorporación de instrucciones de seguimiento, la consulta del estado, la visualización de conversaciones y la gestión del ciclo de vida de los agentes.
Notas
- Categoría:
tools - Tipo:
cursor