Cursor Cloud Agents
Συνδέστε το AI SmartTalk με τους Cursor Cloud Agents για να εκκινήσετε αυτόνομους βοηθούς κωδικοποίησης AI απευθείας από τις συνομιλίες ή τις ροές εργασίας σας. Οι Cursor Cloud Agents μπορούν να διαβάσουν αποθετήρια, να δημιουργήσουν κώδικα, να δημιουργήσουν commits και να ανοίξουν pull requests αυτόματα.
Επισκόπηση
Η ενσωμάτωση των Cursor Cloud Agents σας επιτ ρέπει να:
- Εκκινήσετε AI κωδικοποιητές στα αποθετήρια GitHub σας
- Αυτοματοποιήσετε τη δημιουργία κώδικα μέσω φυσικών γλωσσικών οδηγιών
- Δημιουργήσετε pull requests αυτόματα όταν οι εργασίες ολοκληρωθούν
- Παρακολουθήσετε την πρόοδο του πράκτορα και να δείτε το ιστορικό συνομιλιών
- Προσθέσετε οδηγίες παρακολούθησης σε ενεργούς πράκτορες
- Ενεργοποιήσετε εργασίες κωδικοποίησης από τις ροές εργασίας SmartFlow
Προαπαιτούμενα
Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε:
- Έναν ενεργό λογαριασμό AI SmartTalk
- Έναν λογαριασμό Cursor με πρόσβαση στους Cloud Agents
- Ένα API key του Cursor (που αποκτήθηκε από τον πίνακα ελέγχου του Cursor)
- Αποθετήρια GitHub προσβάσιμα από τον λογαριασμό σας στο Cursor
Βήμα-Βήμα Ρύθμιση
Βήμα 1: Αποκτήστε το API Key του Cursor
- Μεταβείτε στον πίνακα ελέγχου του Cursor Cloud Agent
- Μεταβείτε στις ρυθμίσεις API σας
- Δημιουργήστε ένα νέο API key για το AI SmartTalk
- Αντιγράψτε το API key
Βήμα 2: Πρόσβαση στην Ενσωμάτωση του Cursor
- Συνδεθείτε στον λογαριασμό σας στο AI SmartTalk
- Μεταβείτε στο Διαχείριση → Οι Βοηθοί Μου → [Όνομα Βοηθού σας]
- Κάντε κλικ στους Συνδέσμους στην αριστερή πλαϊνή μπάρα
- Εντοπίστε τους Cursor Cloud Agents και κάντε κλικ πάνω τους
Βήμα 3: Ρύθμιση της Σύνδεσης
- Κάντε κλικ στο Ρύθμιση Διαμόρφωσης
- Εισάγετε το API Key του Cursor
- Κάντε κλικ στο Αποθήκευση Διαμόρφωσης
- Το AI SmartTalk επικυρώνει αυτόματα το API key σας
Βήμα 4: Συγχρονίστε τα Αποθετήρια
Αφού συνδεθείτε, το AI SmartTalk συγχρονίζει αυτόματα τα προσβάσιμα αποθετήρια GitHub από τον λογαριασμό σας στο Cursor. Μπορείτε επίσης να ανανεώσετε χειροκίνητα τη λίστα των αποθετηρίων οποιαδήποτε στιγμή.
Πίνακας Ελέγχου
Αφού συνδεθείτε, ο πίνακας ελέγχου της ενσωμάτωσης του Cursor παρέχει μια πλήρη επισκόπηση:
Επισκόπηση Στατιστικών
| Μετρήσεις | Περιγραφή |
|---|---|
| Συνολικοί Πράκτορες | Αριθμός των ενεργοποιημένων πρακτόρων |
| Ενεργοί | Πράκτορες που είναι ενεργοί αυτή τη στιγμή |
| Ολοκληρωμένοι | Πράκτορες που έχουν ολοκληρωθεί |
| Διαθέσιμα Μοντέλα | AI μοντέλα διαθέσιμα για τους πράκτορες |
Πρόσφατοι Βοηθοί
Ο πίνακας ελέγχου παραθέτει τους πιο πρόσφατους πράκτορες σας με:
- ID Πράκτορα για αναφορά
- Κατάσταση: Ενεργός, Ολοκληρωμένος, Αποτυχία, Δημιουργία ή Ακυρωμένος
- Αποθετήριο στο οποίο εργάζεται ο πράκτορας
- Ημερομηνία Δημιουργίας
- Γρήγορες ενέργειες: Δείτε Λεπτομέρειες και Δείτε PR
Ο πίνακας ελέγχου ανανεώνεται αυτόματα κάθε 30 δευτερόλεπτα όταν οι πράκτορες είναι ενεργοί.
Εκκίνηση ενός Πράκτορα
Από τον Πίνακα Ελέγχου
- Κάντε κλικ στο Εκκίνηση Νέου Βοηθού
- Συμπληρώστε τη φόρμα εκκίνησης:
| Πεδίο | Απαιτείται | Περιγραφή |
|---|---|---|
| Αποθετή ριο | Ναι | Επιλέξτε ένα αποθετήριο GitHub από την αναπτυσσόμενη λίστα |
| Περιγραφή Εργασίας | Ναι | Περιγράψτε τι θα πρέπει να κάνει ο πράκτορας στη φυσική γλώσσα |
| Κλάδος | Όχι | Κλάδος Git για εργασία (προεπιλογή: main) |
| Μοντέλο AI | Όχι | Επιλέξτε ένα συγκεκριμένο μοντέλο AI για τον πράκτορα |
| Αυτόματη Δημιουργία PR | Όχι | Δημιουργήστε αυτόματα ένα pull request όταν ολοκληρωθεί (προεπιλογή: ενεργοποιημένο) |
| Όνομα Κλάδου | Όχι | Προσαρμοσμένο όνομα κλάδου για το pull request |
- Κάντε κλικ στο Εκκίνηση Πράκτορα
Παραδείγματα Περιγραφών Εργασίας
- "Προσθέστε μονάδες δοκιμών για το module αυθεντικοποίησης"
- "Αναδιοργανώστε την πισίνα σύνδεσης βάσης δεδομένων για να χρησιμοποιεί ανακύκλωση συνδέσεων"
- "Διορθώστε το σφάλμα όπου οι συνεδρίες χρηστών λήγουν πρόωρα σε κινητές συσκευές"
- "Προσθέστε τύπους TypeScript για όλα τα αντικείμενα απάντησης API"
- "Δημιουργήστε ένα REST API endpoint για τις προτιμήσεις χρηστών"
Διαχείριση Πρακτόρων
Δείτε Λεπτομέρειες Πράκτορα
Κάντε κλικ στο Δείτε Λεπτομέρειες σε οποιονδήποτε πράκτορα για να δείτε:
Κατηγορία Επισκόπησης:
- ID Πράκτορα και τρέχουσα κατάσταση
- Πληροφορίες αποθετηρίου και κλάδου
- Σύνδεσμος pull request (αν έχει δημιουργηθεί)
- Περίληψη της εργασίας που έχει εκτελεστεί
- Χρονική σήμανση δημιουργίας
Κατηγορία Συνομιλίας:
- Πλήρης ιστορία μηνυμάτων της εργασίας του πράκτορα
- Οδηγίες χρηστών και απαντήσεις AI
- Ημερολόγιο προόδου βήμα προς βήμα
Προσθήκη Οδηγιών Παρακολούθησης
Μπορείτε να στείλετε επιπλέον οδηγίες σε έναν ενεργό πράκτορα:
- Ανοίξτε τις λεπτομέρειες του πράκτορα
- Εισάγετε την οδηγία παρακολούθησης σας (π.χ., "Προσθέστε επίσης χειρισμό σφαλμάτων για την περίπτωση όπου ο χρήστης δεν βρέθηκε")
- Ο πράκτορας συνεχίζει την εργασία του με το νέο πλαίσιο
Διαγραφή Πράκτορα
Για να καθαρίσετε τους πόρους:
- Κάντε κλικ στην ενέργεια διαγραφής στην κάρτα του πράκτορα
- Επιβεβαιώστε τη διαγραφή
- Ο πράκτορας και οι πόροι του αφαιρούνται
Ενσωμάτωση SmartFlow
Οι Cursor Cloud Agents μπορούν να χρησιμοποιηθούν ως ενέργειες σε ροές εργασίας SmartFlow, επιτρέποντας ισχυρά σενάρια αυτοματοποίησης.
Διαθέσιμες Ενέργειες SmartFlow
| Ενέργεια | Περιγραφή |
|---|---|
| Εκκίνηση Κωδικοποιητή | Ξεκινήστε έναν πράκτορα σε ένα αποθετήριο με συγκεκριμένες οδηγίες |
| Προσθήκη Παρακολούθησης | Στείλτε επιπλέον οδηγίες σε έναν ενεργό πράκτορα |
| Λάβετε Κατάσταση Πράκτορα | Ελέγξτε την πρόοδο και την κατάσταση ενός πράκτορα |
| Διαγραφή Πράκτορα | Αφαιρέστε έναν πράκτορα και καθα ρίστε τους πόρους |
Παράδειγμα: Αυτόματη Διόρθωση σε Αναφορά Σφάλματος
Trigger: Chat Service (when user reports a bug)
Actions:
1. AI Request:
Prompt: Extract the bug description and affected repository
2. Cursor Launch Agent:
Repository: {{extracted_repository}}
Task: "Fix this bug: {{bug_description}}"
Auto-create PR: true
3. Send Message:
Text: "I've launched a coding agent to fix this. I'll notify you when the PR is ready."
4. Wait / Poll:
Check Agent Status periodically
5. Send Message:
Text: "The fix is ready! Review the PR here: {{pr_url}}"
Παράδειγμα: Προγραμματισμένες Βελτιώσεις Κώδικα
Trigger: Scheduled Workflow (weekly)
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: "Review and update all deprecated dependencies"
Branch: chore/update-deps
Auto-create PR: true
Για λεπτομέρειες σχετικά με τις παραμέτρους ενεργειών SmartFlow, δείτε Cursor SmartFlow Actions.
Χρήσεις
Bot Υποστήριξης Προγραμματιστή
Αφήστε τους χρήστες να ζητούν αλλαγές κώδικα μέσω συνομιλίας:
- "Μπορείτε να προσθέσετε έλεγχο εισόδου στη φόρμα εγγραφής;"
- "Παρακα λώ δημιουργήστε ένα σενάριο μετανάστευσης για τα νέα πεδία χρηστών"
Αυτοματοποιημένη Διόρθωση Σφαλμάτων
Ενεργοποιήστε πράκτορες κωδικοποίησης από αναφορές σφαλμάτων ή ειδοποιήσεις παρακολούθησης για να δημιουργήσετε αυτόματα PR διόρθωσης.
Αυτοματοποίηση Αναθεώρησης Κώδικα
Εκκινήστε πράκτορες για να αναθεωρήσουν τον κώδικα, να προσθέσουν δοκιμές ή να βελτιώσουν την τεκμηρίωση με βάση την ανατροφοδότηση PR.
Προγραμματισμένη Συντήρηση
Ρυθμίστε επαναλαμβανόμενες ροές εργασίας για να ενημερώσετε τις εξαρτήσεις, να εκτελέσετε διορθώσεις linting ή να δημιουργήσετε αναφορές.
Αντιμετώπιση Προβλημάτων
| Ζήτημα | Λύση |
|---|---|
| "Μη έγκυρο API key" | Δημιουργήστε ξανά το API key σας από τον πίνακα ελέγχου του Cursor |
| "Αποθετήριο δεν βρέθηκε" | Κάντε κλικ στο Ανανέωση για να συγχρονίσετε ξανά τα αποθετήρια. Βεβαιωθείτε ότι το repo είναι προσβάσιμο από τον λογαριασμό σας στο Cursor |
| Ο πράκτορας κολλημένος σε "Δημιουργία" | Ο πράκτορας μπορεί να είναι σε ουρά. Περιμένετε λίγα λεπτά και ελέγξτε ξανά την κατάσταση |
| Ο πράκτορας απέτυχε | Ανοίξτε τις λεπτομέρειες του πράκτορα για να δείτε τη συνομιλία και τα μηνύματα σφάλματος |
| Το PR δεν δημιουργήθηκε | Ελέγ ξτε ότι η αυτόματη δημιουργία PR ήταν ενεργοποιημένη και ο πράκτορας ολοκληρώθηκε με επιτυχία |
| Δεν υπάρχουν διαθέσιμα αποθετήρια | Βεβαιωθείτε ότι ο λογαριασμός σας στο Cursor έχει συνδεδεμένα αποθετήρια GitHub |
Διαχείριση της Ενσωμάτωσης
| Ενέργεια | Πώς |
|---|---|
| Σύνδεση | Εισάγετε το API key στη διαμόρφωση της ενσωμάτωσης |
| Δείτε τον πίνακα ελέγχου | Ανοίξτε τη σελίδα ενσωμάτωσης του Cursor |
| Συγχρονίστε τα αποθετήρια | Κάντε κλικ στην Ανανέωση για να ενημερώσετε τη λίστα αποθετηρίων |
| Αποσύνδεση | Αφαιρέστε το API key από τη διαμόρφωση |
Καλές Πρακτικές
- Γράψτε σα φείς περιγραφές εργασιών: Όσο πιο συγκεκριμένες είναι οι οδηγίες σας, τόσο καλύτερο θα είναι το αποτέλεσμα του πράκτορα.
- Χρησιμοποιήστε κατάλληλα παρακλάδια: Μην εκκινείτε πράκτορες απευθείας στο
main— αφήστε τους να δημιουργήσουν PR για ανασκόπηση. - Ενεργοποιήστε τη δημιουργία PR αυτόματα: Διευκολύνει την ανασκόπηση και τη συγχώνευση της εργασίας του πράκτορα.
- Παρακολουθήστε τους τρέχοντες πράκτορες: Ελέγχετε το ταμπλό τακτικά ή ρυθμίστε ειδοποιήσεις SmartFlow.
- Ανασκοπήστε πριν τη συγχώνευση: Πάντα να ανασκοπείτε τα PR που δημιουργούνται από πράκτορες πριν τη συγχώνευση στην παραγωγή.
- Ξεκινήστε μικρά: Ξεκινήστε με καλά καθορισμένες εργασίες πριν προσπαθήσετε μεγάλες αναδιαρθρώσεις.