Cursor Cloud Agents
Pripojte AI SmartTalk s Cursor Cloud Agents na spustenie autonómnych AI asistentov pre kódovanie priamo z vašich konverzácií alebo pracovných tokov. Cursor Cloud Agents môžu čítať repozitáre, generovať kód, vytvárať commity a automaticky otvárať pull requesty.
Prehľad
Integrácia Cursor Cloud Agents vám umožňuje:
- Spustiť AI kódovacie agenti vo vašich GitHub repozitároch
- Automatizovať generovanie kódu prostredníctvom pokynov v prirodzenom jazyku
- Automaticky vytvárať pull requesty po dokončení úloh
- Monitorovať pokrok agenta a zobraziť históriu konverzácií
- Pridať doplňujúce pokyny bežiacim agentom
- Spustiť kódovacie úlohy z pracovných tokov SmartFlow
Predpoklady
Predtým, než začnete, zabezpečte, aby ste mali:
- Aktívny účet AI SmartTalk
- Účet Cursor s prístupom k Cloud Agents
- API kľúč Cursor (získaný z vášho Cursor dashboardu)
- GitHub repozitáre prístupné z vášho Cursor účtu
Nastavenie krok za krokom
Krok 1: Získajte svoj Cursor API kľúč
- Prejdite na váš Cursor Cloud Agent dashboard
- Prejdite do nastavení API
- Vygenerujte nový API kľúč pre AI SmartTalk
- Skopírujte API kľúč
Krok 2: Prístup k integrácii Cursor
- Prihláste sa do svojho účtu AI SmartTalk
- Prejdite na Administrácia → Moji asistenti → [Názov vášho asistenta]
- Kliknite na Konektory v ľavom bočnom paneli
- Nájdite Cursor Cloud Agents a kliknite naň
Krok 3: Konfigurácia pripojenia
- Kliknite na Nastaviť konfiguráciu
- Zadajte svoj Cursor API kľúč
- Kliknite na Uložiť konfiguráciu
- AI SmartTalk automaticky overí váš API kľúč
Krok 4: Synchronizácia repozitárov
Akonáhle ste pripojení, AI SmartTalk automaticky synchronizuje prístupné GitHub repozitáre z vášho Cursor účtu. Môžete tiež manuálne obnoviť zoznam repozitárov kedykoľvek.
Dashboard
Akonáhle ste pripojení, dashboard integrácie Cursor poskytuje kompletný prehľad:
Prehľad štatistík
| Metrika | Popis |
|---|---|
| Celkový počet agentov | Počet spustených agentov |
| Bežiace | Aktuálne aktívni agenti |
| Dokončené | Dokončení agenti |
| Dostupné modely | AI modely dostupné pre agentov |
Nedávni asistenti
Dashboard zobrazuje vašich najnovších agentov s:
- ID agenta na referenciu
- Stav: Beží, Dokončené, Zlyhané, Vytváranie alebo Zrušené
- Repozitár, na ktorom agent pracuje
- Dátum vytvorenia
- Rýchle akcie: Zobraziť detaily a Zobraziť PR
Dashboard sa automaticky obnovuje každých 30 sekúnd, keď agenti bežia.
Spustenie agenta
Z dashboardu
- Kliknite na Spustiť nového asistenta
- Vyplňte formulár na spustenie:
| Pole | Povinné | Popis |
|---|---|---|
| Repozitár | Áno | Vyberte GitHub repozitár zo zoznamu |
| Popis úlohy | Áno | Opíšte, čo by mal agent robiť v prirodzenom jazyku |
| Branch | Nie | Git branch, na ktorom sa má pracovať (predvolené: main) |
| AI Model | Nie | Vyberte konkrétny AI model pre agenta |
| Automaticky vytvoriť PR | Nie | Automaticky vytvoriť pull request po dokončení (predvolené: povolené) |
| Názov branch | Nie | Vlastný názov branch pre pull request |
- Kliknite na Spustiť agenta
Príklady popisu úlohy
- "Pridať jednotkové testy pre autentifikačný modul"
- "Refaktorovať pripojovací pool databázy na použitie recyklácie pripojení"
- "Opraviť chybu, kde sa používateľské relácie predčasne vypršia na mobile"
- "Pridať TypeScript typové definície pre všetky objekty odpovede API"
- "Vytvoriť REST API koncový bod pre preferencie používateľa"
Správa agentov
Zobraziť detaily agenta
Kliknite na Zobraziť detaily na akomkoľvek agentovi, aby ste videli:
Prehľadová karta:
- ID agenta a aktuálny stav
- Informácie o repozitári a branche
- Odkaz na pull request (ak bol vytvorený)
- Zhrnutie vykonanej práce
- Časová pečiatka vytvorenia
Karta konverzácie:
- Úplná história správ o práci agenta
- Pokyny používateľa a odpovede AI
- Záznam pokroku krok za krokom
Pridať doplňujúce pokyny
Môžete poslať ďalšie pokyny bežiacemu agentovi:
- Otvorte detaily agenta
- Zadajte svoju doplňujúcu pokyn (napr. "Pridajte aj spracovanie chýb pre okrajový prípad, keď používateľ nie je nájdený")
- Agent pokračuje vo svojej práci s novým kontextom
Zmazať agenta
Na vyčistenie zdrojov:
- Kliknite na akciu zmazať na karte agenta
- Potvrďte zmazanie
- Agent a jeho zdroje sú odstránené
Integrácia SmartFlow
Cursor Cloud Agents môžu byť použité ako akcie v pracovných tokoch SmartFlow, čo umožňuje silné automatizačné scenáre.
Dostupné akcie SmartFlow
| Akcia | Popis |
|---|---|
| Spustiť kódovací agent | Spustiť agenta na repozitári so špecifickými pokynmi |
| Pridať doplnok | Poslať ďalšie pokyny bežiacemu agentovi |
| Získať stav agenta | Skontrolovať pokrok a stav agenta |
| Zmazať agenta | Odstrániť agenta a vyčistiť zdroje |
Príklad: Automatická oprava pri hlásení chyby
Trigger: Chat Service (keď používateľ hlási chybu)
Actions:
1. AI Request:
Prompt: Extrahujte popis chyby a ovplyvnený repozitár
2. Cursor Launch Agent:
Repository: {{extracted_repository}}
Task: "Opraviť túto chybu: {{bug_description}}"
Auto-create PR: true
3. Send Message:
Text: "Spustil som kódovacieho agenta na opravu. Oznámim vám, keď bude PR pripravené."
4. Wait / Poll:
Pravidelne kontrolujte stav agenta
5. Send Message:
Text: "Oprava je hotová! Skontrolujte PR tu: {{pr_url}}"
Príklad: Naplánované zlepšenia kódu
Trigger: Naplánovaný pracovný tok (týždenne)
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: "Skontrolovať a aktualizovať všetky zastarané závislosti"
Branch: chore/update-deps
Auto-create PR: true
Pre podrobné parametre akcií SmartFlow pozrite Cursor SmartFlow Actions.
Prípady použitia
Podpora pre vývojárov
Nechajte používateľov žiadať o zmeny kódu prostredníctvom chatu:
- "Môžete pridať validáciu vstupu do registračného formulára?"
- "Prosím, vytvorte migračný skript pre nové používateľské polia"
Automatizované opravy chýb
Spustite kódovacie agenti z hlásení chýb alebo monitorovacích upozornení na automatické generovanie opravných PR.
Automatizácia kontroly kódu
Spustite agentov na kontrolu kódu, pridanie testov alebo zlepšenie dokumentácie na základe spätnej väzby z PR.
Naplánovaná údržba
Nastavte opakujúce sa pracovné toky na aktualizáciu závislostí, spustenie opráv lintovania alebo generovanie správ.
Riešenie problémov
| Problém | Riešenie |
|---|---|
| "Neplatný API kľúč" | Znovu vygenerujte svoj API kľúč z dashboardu Cursor |
| "Repozitár nenájdený" | Kliknite na Obnoviť na opätovnú synchronizáciu repozitárov. Uistite sa, že je repozitár prístupný z vášho Cursor účtu |
| Agent uviazol v "Vytváraní" | Agent môže byť v poradí. Počkajte niekoľko minút a skontrolujte stav znova |
| Agent zlyhal | Otvorte detaily agenta, aby ste videli konverzáciu a chybové správy |
| PR nebol vytvorený | Skontrolujte, či bol povolený automatický prenos PR a agent úspešne dokončil |
| Žiadne dostupné repozitáre | Uistite sa, že váš Cursor účet má pripojené GitHub repozitáre |
Správa integrácie
| Akcia | Ako |
|---|---|
| Pripojiť | Zadajte API kľúč do konfigurácie integrácie |
| Zobraziť dashboard | Otvorte stránku integrácie Cursor |
| Synchronizovať repozitáre | Kliknite na Obnoviť na aktualizáciu zoznamu repozitárov |
| Odpojiť | Odstráňte API kľúč z konfigurácie |
Najlepšie praktiky
- Píšte jasné popisy úloh: Čím konkrétnejšie sú vaše pokyny, tým lepší bude výstup agenta.
- Používajte vhodné vetvy: Nespúšťajte agentov priamo na
main— nechajte ich vytvoriť PR na revíziu. - Povoľte automatické vytváranie PR: Uľahčuje to revíziu a zlúčenie práce agenta.
- Sledujte bežiacich agentov: Pravidelne kontrolujte panel alebo nastavte notifikácie SmartFlow.
- Revidujte pred zlúčením: Vždy prejdite PR generované agentom pred zlúčením do produkcie.
- Začnite s malými úlohami: Začnite s úlohami s jasne definovaným rozsahom pred pokusom o veľké refaktoringy.