Cursor Cloud Agents
Collega AI SmartTalk con Cursor Cloud Agents per avviare assistenti di codifica AI autonomi direttamente dalle tue conversazioni o flussi di lavoro. I Cursor Cloud Agents possono leggere i repository, generare codice, creare commit e aprire pull request automaticamente.
Panoramica
L'integrazione dei Cursor Cloud Agents ti consente di:
- Avviare agenti di codifica AI sui tuoi repository GitHub
- Automatizzare la generazione di codice attraverso istruzioni in linguaggio naturale
- Creare pull request automaticamente al termine dei compiti
- Monitorare i progressi dell'agente e visualizzare la cronologia delle conversazioni
- Aggiungere istruzioni di follow-up agli agenti in esecuzione
- Attivare compiti di codifica dai flussi di lavoro SmartFlow
Requisiti
Prima di iniziare, assicurati di avere:
- Un account AI SmartTalk attivo
- Un account Cursor con accesso ai Cloud Agents
- Una chiave API di Cursor (ottenuta dal tuo dashboard di Cursor)
- Repository GitHub accessibili dal tuo account Cursor
Configurazione Passo-Passo
Passo 1: Ottieni la tua Chiave API di Cursor
- Vai al tuo dashboard dei Cursor Cloud Agents
- Naviga alle impostazioni API
- Genera una nuova chiave API per AI SmartTalk
- Copia la chiave API
Passo 2: Accedi all'Integrazione di Cursor
- Accedi al tuo account AI SmartTalk
- Naviga su Amministrazione → I miei Assistenti → [Nome del tuo Assistente]
- Clicca su Connettori nella barra laterale sinistra
- Trova Cursor Cloud Agents e clicca su di esso
Passo 3: Configura la Connessione
- Clicca su Configura Impostazioni
- Inserisci la tua Chiave API di Cursor
- Clicca su Salva Configurazione
- AI SmartTalk valida automaticamente la tua chiave API
Passo 4: Sincronizza i Repository
Una volta connesso, AI SmartTalk sincronizza automaticamente i repository GitHub accessibili dal tuo account Cursor. Puoi anche aggiornare manualmente l'elenco dei repository in qualsiasi momento.
Dashboard
Una volta connesso, la dashboard dell'integrazione di Cursor fornisce una panoramica completa:
Panoramica Statistiche
| Metri | Descrizione |
|---|---|
| Totale Agenti | Numero di agenti avviati |
| In Esecuzione | Agenti attivi attualmente |
| Completati | Agenti completati |
| Modelli Disponibili | Modelli AI disponibili per gli agenti |
Assistenti Recenti
La dashboard elenca i tuoi agenti più recenti con:
- ID Agente per riferimento
- Stato: In Esecuzione, Completato, Fallito, Creazione o Annullato
- Repository su cui l'agente sta lavorando
- Data di creazione
- Azioni rapide: Visualizza Dettagli e Visualizza PR
La dashboard si aggiorna automaticamente ogni 30 secondi quando gli agenti sono in esecuzione.
Avviare un Agente
Dalla Dashboard
- Clicca su Avvia Nuovo Assistente
- Compila il modulo di avvio:
| Campo | Obbligatorio | Descrizione |
|---|---|---|
| Repository | Sì | Seleziona un repository GitHub dal menu a discesa |
| Descrizione del Compito | Sì | Descrivi cosa dovrebbe fare l'agente in linguaggio naturale |
| Branch | No | Branch Git su cui lavorare (predefinito: main) |
| Modello AI | No | Seleziona un modello AI specifico per l'agente |
| Creazione automatica PR | No | Crea automaticamente una pull request al termine (predefinito: abilitato) |
| Nome Branch | No | Nome personalizzato del branch per la pull request |
- Clicca su Avvia Agente
Esempi di Descrizione del Compito
- "Aggiungi test unitari per il modulo di autenticazione"
- "Rifattorizza il pool di connessione al database per utilizzare il riciclo delle connessioni"
- "Correggi il bug in cui le sessioni utente scadono prematuramente su mobile"
- "Aggiungi definizioni di tipo TypeScript per tutti gli oggetti di risposta API"
- "Crea un endpoint API REST per le preferenze utente"
Gestire gli Agenti
Visualizza Dettagli dell'Agente
Clicca su Visualizza Dettagli su qualsiasi agente per vedere:
Scheda Panoramica:
- ID Agente e stato attuale
- Informazioni su repository e branch
- Link alla pull request (se creata)
- Riepilogo del lavoro svolto
- Timestamp di creazione
Scheda Conversazione:
- Cronologia completa dei messaggi del lavoro dell'agente
- Istruzioni dell'utente e risposte AI
- Registro dei progressi passo-passo
Aggiungi Istruzioni di Follow-Up
Puoi inviare istruzioni aggiuntive a un agente in esecuzione:
- Apri i dettagli dell'agente
- Inserisci la tua istruzione di follow-up (ad es., "Aggiungi anche la gestione degli errori per il caso limite in cui l'utente non viene trovato")
- L'agente continua il suo lavoro con il nuovo contesto
Elimina un Agente
Per liberare risorse:
- Clicca sull'azione di eliminazione sulla scheda dell'agente
- Conferma l'eliminazione
- L'agente e le sue risorse vengono rimossi
Integrazione SmartFlow
I Cursor Cloud Agents possono essere utilizzati come azioni nei flussi di lavoro SmartFlow, abilitando potenti scenari di automazione.
Azioni SmartFlow Disponibili
| Azione | Descrizione |
|---|---|
| Avvia Agente di Codifica | Avvia un agente su un repository con istruzioni specifiche |
| Aggiungi Followup | Invia istruzioni aggiuntive a un agente in esecuzione |
| Ottieni Stato Agente | Controlla i progressi e lo stato di un agente |
| Elimina Agente | Rimuovi un agente e libera risorse |
Esempio: Correzione Automatica su Segnalazione di Bug
Trigger: Servizio Chat (quando l'utente segnala un bug)
Actions:
1. Richiesta AI:
Prompt: Estrai la descrizione del bug e il repository interessato
2. Avvia Agente Cursor:
Repository: {{extracted_repository}}
Task: "Correggi questo bug: {{bug_description}}"
Auto-create PR: true
3. Invia Messaggio:
Text: "Ho avviato un agente di codifica per risolvere questo. Ti notificherò quando la PR sarà pronta."
4. Attendi / Poll:
Controlla Periodicamente lo Stato dell'Agente
5. Invia Messaggio:
Text: "La correzione è pronta! Rivedi la PR qui: {{pr_url}}"
Esempio: Miglioramenti di Codice Programmati
Trigger: Flusso di Lavoro Programmato (settimanale)
Actions:
1. Avvia Agente Cursor:
Repository: my-org/my-app
Task: "Rivedi e aggiorna tutte le dipendenze deprecate"
Branch: chore/update-deps
Auto-create PR: true
Per parametri dettagliati delle azioni SmartFlow, vedere Cursor SmartFlow Actions.
Casi d'Uso
Bot di Supporto per Sviluppatori
Permetti agli utenti di richiedere modifiche al codice tramite chat:
- "Puoi aggiungere la validazione dell'input al modulo di registrazione?"
- "Per favore crea uno script di migrazione per i nuovi campi utente"
Correzione Automatica dei Bug
Attiva agenti di codifica da segnalazioni di bug o avvisi di monitoraggio per generare automaticamente PR di correzione.
Automazione della Revisione del Codice
Avvia agenti per rivedere il codice, aggiungere test o migliorare la documentazione in base al feedback delle PR.
Manutenzione Programmata
Imposta flussi di lavoro ricorrenti per aggiornare le dipendenze, eseguire correzioni di linting o generare report.
Risoluzione dei Problemi
| Problema | Soluzione |
|---|---|
| "Chiave API non valida" | Rigenera la tua chiave API dal dashboard di Cursor |
| "Repository non trovato" | Clicca su Aggiorna per risincronizzare i repository. Assicurati che il repo sia accessibile dal tuo account Cursor |
| Agente bloccato in "Creazione" | L'agente potrebbe essere in coda. Aspetta qualche minuto e controlla di nuovo lo stato |
| Agente fallito | Apri i dettagli dell'agente per visualizzare la conversazione e i messaggi di errore |
| PR non creata | Controlla che la creazione automatica della PR fosse abilitata e che l'agente sia stato completato con successo |
| Nessun repository disponibile | Assicurati che il tuo account Cursor abbia repository GitHub collegati |
Gestire l'Integrazione
| Azione | Come |
|---|---|
| Collegare | Inserisci la chiave API nella configurazione dell'integrazione |
| Visualizza dashboard | Apri la pagina di integrazione di Cursor |
| Sincronizza repository | Clicca su Aggiorna per aggiornare l'elenco dei repository |
| Disconnetti | Rimuovi la chiave API dalla configurazione |
Best Practices
- Scrivi descrizioni chiare dei compiti: Più specifiche sono le tue istruzioni, migliore sarà l'output dell'agente
- Usa rami appropriati: Non avviare agenti direttamente su
main— lascia che creino PR per la revisione - Abilita la creazione automatica di PR: Rende facile la revisione e l'unione del lavoro dell'agente
- Monitora gli agenti in esecuzione: Controlla regolarmente il dashboard o imposta notifiche SmartFlow
- Rivedi prima di unire: Rivedi sempre le PR generate dagli agenti prima di unirle in produzione
- Inizia in piccolo: Comincia con compiti ben definiti prima di tentare grandi rifattorizzazioni