Cursor Cloud Agents
Conectați AI SmartTalk cu Cursor Cloud Agents pentru a lansa asistenți AI de codare autonomi direct din conversațiile sau fluxurile dvs. de lucru. Cursor Cloud Agents pot citi repozitorii, genera cod, crea commit-uri și deschide cereri de extragere automat.
Prezentare generală
Integrarea Cursor Cloud Agents vă permite să:
- Lansați agenți de codare AI pe repozitoarele dvs. GitHub
- Automatizați generarea de cod prin instrucțiuni în limbaj natural
- Creați cereri de extragere automat atunci când sarcinile sunt complete
- Monitorizați progresul agenților și vizualizați istoricul conversațiilor
- Adăugați instrucțiuni suplimentare agenților activi
- Declanșați sarcini de codare din fluxurile de lucru SmartFlow
Cerințe preliminare
Înainte de a începe, asigurați-vă că aveți:
- Un cont activ AI SmartTalk
- Un cont Cursor cu acces la Cloud Agents
- Un cheie API Cursor (obținută din tabloul de bord Cursor)
- Repozitoare GitHub accesibile din contul dvs. Cursor
Configurare Pas cu Pas
Pasul 1: Obțineți Cheia API Cursor
- Accesați tabloul de bord Cursor Cloud Agent
- Navigați la setările API
- Generați o nouă cheie API pentru AI SmartTalk
- Copiați cheia API
Pasul 2: Accesați Integrarea Cursor
- Conectați-vă la contul dvs. AI SmartTalk
- Navigați la Administrare → Asistenții Mei → [Numele Asistentului Dvs.]
- Faceți clic pe Conectori în bara laterală stângă
- Găsiți Cursor Cloud Agents și faceți clic pe acesta
Pasul 3: Configurați Conexiunea
- Faceți clic pe Configurare Setup
- Introduceți Cheia API Cursor
- Faceți clic pe Salvați Configurarea
- AI SmartTalk validează automat cheia dvs. API
Pasul 4: Sincronizați Repozitoarele
Odată conectat, AI SmartTalk sincronizează automat repozitoarele GitHub accesibile din contul dvs. Cursor. De asemenea, puteți actualiza manual lista de repozitoare în orice moment.
Tabloul de Bord
Odată conectat, tabloul de bord al integrării Cursor oferă o imagine de ansamblu completă:
Prezentare Generală a Statisticilor
| Metric | Descriere |
|---|---|
| Total Agenți | Numărul de agenți lansați |
| Activ | Agenți activi în prezent |
| Finalizați | Agenți finalizați |
| Modele Disponibile | Modele AI disponibile pentru agenți |
Asistenți Recenți
Tabloul de bord listează cei mai recent agenți cu:
- ID Agent pentru referință
- Stare: Activ, Finalizat, Eșuat, Creare sau Anulat
- Repozitoriu pe care agentul lucrează
- Data creării
- Acțiuni rapide: Vizualizați Detalii și Vizualizați PR
Tabloul de bord se actualizează automat la fiecare 30 de secunde când agenții sunt activi.
Lansarea unui Agent
Din Tabloul de Bord
- Faceți clic pe Lansați Nou Asistent
- Completați formularul de lansare:
| Câmp | Necesare | Descriere |
|---|---|---|
| Repozitoriu | Da | Selectați un repozitoriu GitHub din lista derulantă |
| Descriere Sarcină | Da | Descrieți ce ar trebui să facă agentul în limbaj natural |
| Ramură | Nu | Ramura Git pe care să lucreze (implicit: main) |
| Model AI | Nu | Selectați un model AI specific pentru agent |
| Creare automată PR | Nu | Creați automat o cerere de extragere când este finalizat (implicit: activat) |
| Numele Ramurii | Nu | Nume personalizat pentru ramura cererii de extragere |
- Faceți clic pe Lansați Agent
Exemple de Descriere a Sarcinii
- "Adăugați teste unitare pentru modulul de autentificare"
- "Refactorizați pool-ul de conexiuni la baza de date pentru a folosi reciclarea conexiunilor"
- "Remediați bug-ul în care sesiunile utilizatorilor expiră prematur pe mobil"
- "Adăugați definiții de tip TypeScript pentru toate obiectele de răspuns API"
- "Creați un endpoint REST API pentru preferințele utilizatorului"
Gestionarea Agenților
Vizualizați Detaliile Agentului
Faceți clic pe Vizualizați Detalii pe orice agent pentru a vedea:
Tab-ul Prezentare Generală:
- ID Agent și starea curentă
- Informații despre repozitoriu și ramură
- Linkul cererii de extragere (dacă a fost creat)
- Rezumatul muncii efectuate
- Marcajul de timp al creării
Tab-ul Conversație:
- Istoricul complet al mesajelor muncii agentului
- Instrucțiunile utilizatorului și răspunsurile AI
- Jurnalul de progres pas cu pas
Adăugați Instrucțiuni Suplimentare
Puteți trimite instrucțiuni suplimentare unui agent activ:
- Deschideți detaliile agentului
- Introduceți instrucțiunea dvs. suplimentară (de exemplu, "Adăugați și gestionarea erorilor pentru cazul limită când utilizatorul nu este găsit")
- Agentul își continuă munca cu noul context
Ștergeți un Agent
Pentru a curăța resursele:
- Faceți clic pe acțiunea de ștergere de pe cardul agentului
- Confirmați ștergerea
- Agentul și resursele sale sunt eliminate
Integrarea SmartFlow
Cursor Cloud Agents pot fi folosiți ca acțiuni în fluxurile de lucru SmartFlow, permițând scenarii de automatizare puternice.
Acțiuni SmartFlow Disponibile
| Acțiune | Descriere |
|---|---|
| Lansați Agent de Codare | Porniți un agent pe un repozitoriu cu instrucțiuni specifice |
| Adăugați Urmărire | Trimiteți instrucțiuni suplimentare unui agent activ |
| Obțineți Starea Agentului | Verificați progresul și starea unui agent |
| Ștergeți Agentul | Îndepărtați un agent și curățați resursele |
Exemplu: Corectare Automată pe Raport de Bug
Trigger: Chat Service (când utilizatorul raportează un bug)
Actions:
1. AI Request:
Prompt: Extrageți descrierea bug-ului și repozitoriul afectat
2. Cursor Launch Agent:
Repository: {{extracted_repository}}
Task: "Remediați acest bug: {{bug_description}}"
Auto-create PR: true
3. Send Message:
Text: "Am lansat un agent de codare pentru a remedia acest lucru. Voi notifica când PR-ul este gata."
4. Wait / Poll:
Verificați periodic Starea Agentului
5. Send Message:
Text: "Corectura este gata! Revizuiți PR-ul aici: {{pr_url}}"
Exemplu: Îmbunătățiri de Cod Programate
Trigger: Scheduled Workflow (săptămânal)
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: "Revizuiți și actualizați toate dependențele depreciate"
Branch: chore/update-deps
Auto-create PR: true
Pentru parametrii detaliați ai acțiunilor SmartFlow, consultați Cursor SmartFlow Actions.
Cazuri de Utilizare
Bot de Suport pentru Dezvoltatori
Permiteți utilizatorilor să solicite modificări de cod prin chat:
- "Puteți adăuga validarea inputului pentru formularul de înscriere?"
- "Vă rog să creați un script de migrare pentru noile câmpuri de utilizator"
Corectare Automată a Bug-urilor
Declanșați agenți de codare din rapoartele de bug-uri sau alertele de monitorizare pentru a genera automat PR-uri de corectare.
Automatizarea Revizuirii Codului
Lansați agenți pentru a revizui codul, a adăuga teste sau a îmbunătăți documentația pe baza feedback-ului PR.
Întreținere Programată
Configurați fluxuri de lucru recurente pentru a actualiza dependențele, a rula corecturi de linting sau a genera rapoarte.
Depanare
| Problemă | Soluție |
|---|---|
| "Cheie API invalidă" | Regenerați cheia API din tabloul de bord Cursor |
| "Repozitoriu nu găsit" | Faceți clic pe Refresh pentru a re-sincroniza repozitoarele. Asigurați-vă că repo-ul este accesibil din contul dvs. Cursor |
| Agent blocat în "Creare" | Agentul poate fi în așteptare. Așteptați câteva minute și verificați din nou starea |
| Agent eșuat | Deschideți detaliile agentului pentru a vizualiza conversația și mesajele de eroare |
| PR nu a fost creat | Verificați că crearea automată a PR-ului a fost activată și că agentul a finalizat cu succes |
| Niciun repozitoriu disponibil | Asigurați-vă că contul dvs. Cursor are repozitoare GitHub conectate |
Gestionarea Integrării
| Acțiune | Cum |
|---|---|
| Conectați | Introduceți cheia API în configurația integrării |
| Vizualizați tabloul de bord | Deschideți pagina de integrare Cursor |
| Sincronizați repozitoarele | Faceți clic pe Refresh pentru a actualiza lista de repozitoare |
| Deconectați | Îndepărtați cheia API din configurație |
Cele Mai Bune Practici
- Scrieți descrieri clare ale sarcinilor: Cu cât instrucțiunile sunt mai specifice, cu atât rezultatul agentului va fi mai bun.
- Utilizați ramuri adecvate: Nu lansați agenți direct pe
main— lăsați-i să creeze PR-uri pentru revizuire. - Activați auto-crearea PR-urilor: Facilitează revizuirea și fuzionarea muncii agenților.
- Monitorizați agenții în execuție: Verificați tabloul de bord regulat sau configurați notificări SmartFlow.
- Revizuiți înainte de a fuziona: Revizuiți întotdeauna PR-urile generate de agenți înainte de a le fuziona în producție.
- Începeți mic: Începeți cu sarcini bine definite înainte de a încerca refactorizări mari.