Cursor Cloud Agents
Kapcsolja össze az AI SmartTalk-ot a Cursor Cloud Agents-szel, hogy autonóm AI kódoló asszisztenseket indítson közvetlenül a beszélgetéseiből vagy munkafolyamataiból. A Cursor Cloud Agents képesek olvasni a tárolókat, kódot generálni, elkötelezéseket létrehozni és automatikusan pull requesteket nyitni.
Áttekintés
A Cursor Cloud Agents integráció lehetővé teszi, hogy:
- Indítson AI kódoló ügynököket a GitHub tárolóiban
- Automatizálja a kódgenerálást természetes nyelvű utasításokkal
- Automatikusan hozzon létre pull requesteket a feladatok befejezésekor
- Kövesse nyomon az ügynök előrehaladását és nézze meg a beszélgetési előzményeket
- Adjon hozzá következő utasításokat a futó ügynököknek
- Indítson kódolási feladatokat a SmartFlow munkafolyamataiból
Előfeltételek
Mielőtt elkezdené, győződjön meg arról, hogy rendelkezik:
- Egy aktív AI SmartTalk fiókkal
- Egy Cursor fiókkal, amely hozzáféréssel rendelkezik a Cloud Agents-hez
- Egy Cursor API kulccsal (amelyet a Cursor irányítópultjáról szerezhet be)
- GitHub tárolókkal, amelyek elérhetők a Cursor fiókjából
Lépésről lépésre történő beállítás
1. lépés: Szerezze meg a Cursor API kulcsát
- Lépjen a Cursor Cloud Agent irányítópultjára
- Navigáljon az API beállításaihoz
- Generáljon egy új API kulcsot az AI SmartTalk számára
- Másolja az API kulcsot
2. lépés: Hozzáférés a Cursor integrációhoz
- Jelentkezzen be az AI SmartTalk fiókjába
- Navigáljon a Kezelés → Saját asszisztenseim → [Az Ön asszisztense neve] menüpontra
- Kattintson a bal oldali sávban a Csatlakozók lehetőségre
- Keresse meg a Cursor Cloud Agents-t, és kattintson rá
3. lépés: A kapcsolat konfigurálása
- Kattintson a Beállítás konfigurálása gombra
- Adja meg a Cursor API kulcsát
- Kattintson a Konfiguráció mentése gombra
- Az AI SmartTalk automatikusan érvényesíti az API kulcsát
4. lépés: Tárolók szinkronizálása
Miután csatlakozott, az AI SmartTalk automatikusan szinkronizálja a Cursor fiókjából elérhető GitHub tárolókat. A tárolólista manuálisan bármikor frissíthető.
Irányítópult
Miután csatlakozott, a Cursor integrációs irányítópult teljes áttekintést nyújt:
Statisztikai áttekintés
| Metrika | Leírás |
|---|---|
| Összes ügynök | Indított ügynökök száma |
| Futó | Jelenleg aktív ügynökök |
| Befejezett | Befejezett ügynökök |
| Elérhető modellek | AI modellek, amelyek elérhetők az ügynökök számára |
Legutóbbi asszisztensek
Az irányítópult a legutóbbi ügynökeit listázza:
- Ügynök ID hivatkozásként
- Állapot: Futó, Befejezett, Sikertelen, Létrehozás alatt vagy Törölve
- Tároló, amin az ügynök dolgozik
- Létrehozás dátuma
- Gyors műveletek: Részletek megtekintése és PR megtekintése
Az irányítópult 30 másodpercenként automatikusan frissül, amikor az ügynökök futnak.
Ügynök indítása
Az irányítópultról
- Kattintson az Új asszisztens indítása gombra
- Töltse ki az indítási űrlapot:
| Mező | Kötelező | Leírás |
|---|---|---|
| Tároló | Igen | Válasszon ki egy GitHub tárolót a legördülő menüből |
| Feladat leírása | Igen | Írja le, mit kell tennie az ügynöknek természetes nyelven |
| Ág | Nem | Git ág, amin dolgozni kell (alapértelmezett: main) |
| AI modell | Nem | Válasszon ki egy konkrét AI modellt az ügynök számára |
| Automatikus PR létrehozás | Nem | Automatikusan hozzon létre pull requestet, amikor kész (alapértelmezett: engedélyezve) |
| Ág neve | Nem | Egyedi ág név a pull requesthez |
- Kattintson az Ügynök indítása gombra
Feladat leírásának példái
- "Adjon hozzá egységteszteket az autentikációs modulhoz"
- "Refaktorálja az adatbázis kapcsolat medencét, hogy használja a kapcsolat újrahasznosítást"
- "Javítsa ki a hibát, ahol a felhasználói munkamenetek idő előtt lejárnak mobilon"
- "Adjon hozzá TypeScript típusdefiníciókat az összes API válaszobjektumhoz"
- "Hozzon létre egy REST API végpontot a felhasználói preferenciákhoz"
Ügynökök kezelése
Ügynök részleteinek megtekintése
Kattintson a Részletek megtekintése gombra bármely ügynök esetében, hogy lássa:
Áttekintés fül:
- Ügynök ID és aktuális állapot
- Tároló és ág információ
- Pull request link (ha létrejött)
- A végzett munka összefoglalása
- Létrehozás időbélyeg
Beszélgetés fül:
- Az ügynök munkájának teljes üzenettörténete
- Felhasználói utasítások és AI válaszok
- Lépésről lépésre haladási napló
Következő utasítások hozzáadása
További utasításokat küldhet egy futó ügynöknek:
- Nyissa meg az ügynök részleteit
- Adja meg a következő utasítást (pl. "Továbbá adjon hozzá hiba kezelést a szélsőséges esethez, amikor a felhasználó nem található")
- Az ügynök folytatja a munkáját az új kontextussal
Ügynök törlése
Az erőforrások tisztításához:
- Kattintson a törlés műveletre az ügynök kártyáján
- Erősítse meg a törlést
- Az ügynök és az erőforrásai eltávolításra kerülnek
SmartFlow integráció
A Cursor Cloud Agents akciókként használhatók a SmartFlow munkafolyamataiban, lehetővé téve a hatékony automatizálási forgatókönyveket.
Elérhető SmartFlow akciók
| Akció | Leírás |
|---|---|
| Kódoló ügynök indítása | Indítson egy ügynököt egy tárolón a konkrét utasításokkal |
| Következő utasítás hozzáadása | Küldjön további utasításokat egy futó ügynöknek |
| Ügynök állapotának lekérdezése | Ellenőrizze egy ügynök előrehaladását és állapotát |
| Ügynök törlése | Távolítson el egy ügynököt és tisztítsa meg az erőforrásokat |
Példa: Automatikus javítás hiba jelentéskor
Trigger: Chat Service (amikor a felhasználó hibát jelent)
Actions:
1. AI Request:
Prompt: Kivonja a hiba leírását és az érintett tárolót
2. Cursor Launch Agent:
Repository: {{extracted_repository}}
Task: "Javítsa ki ezt a hibát: {{bug_description}}"
Auto-create PR: true
3. Send Message:
Text: "Indítottam egy kódoló ügynököt a javításhoz. Értesítelek, amikor a PR készen áll."
4. Wait / Poll:
Ellenőrizze az ügynök állapotát időszakonként
5. Send Message:
Text: "A javítás kész! Nézd meg a PR-t itt: {{pr_url}}"
Példa: Ütemezett kódjavítások
Trigger: Ütemezett munkafolyamat (heti)
Actions:
1. Cursor Launch Agent:
Repository: my-org/my-app
Task: "Nézze át és frissítse az összes elavult függőséget"
Branch: chore/update-deps
Auto-create PR: true
A részletes SmartFlow akcióparaméterekért lásd a Cursor SmartFlow Actions.
Használati esetek
Fejlesztői támogatási bot
Engedje meg a felhasználóknak, hogy kódváltoztatásokat kérjenek a csevegésen keresztül:
- "Hozzá tudna adni bemeneti érvényesítést a regisztrációs űrlaphoz?"
- "Kérem, hozzon létre egy migrációs szkriptet az új felhasználói mezők számára"
Automatizált hibajavítás
Indítson kódoló ügynököket hiba jelentésekből vagy figyelmeztető értesítésekből, hogy automatikusan generáljanak javító PR-eket.
Kódellenőrzési automatizálás
Indítson ügynököket a kód ellenőrzésére, tesztek hozzáadására vagy a dokumentáció javítására a PR visszajelzése alapján.
Ütemezett karbantartás
Állítson be ismétlődő munkafolyamatokat a függőségek frissítésére, lint javítások futtatására vagy jelentések generálására.
Hibaelhárítás
| Probléma | Megoldás |
|---|---|
| "Érvénytelen API kulcs" | Generálja újra az API kulcsát a Cursor irányítópultjáról |
| "Tároló nem található" | Kattintson a Frissítés gombra a tárolók újraszinkronizálásához. Győződjön meg arról, hogy a tároló elérhető a Cursor fiókjából |
| Ügynök "Létrehozás alatt" állapotban | Az ügynök várakozó állapotban lehet. Várjon néhány percet, és ellenőrizze újra az állapotot |
| Ügynök sikertelen | Nyissa meg az ügynök részleteit, hogy megnézze a beszélgetést és a hibaüzeneteket |
| PR nem jött létre | Ellenőrizze, hogy az automatikus PR létrehozás engedélyezve volt-e, és az ügynök sikeresen befejezte-e |
| Nincs elérhető tároló | Győződjön meg arról, hogy a Cursor fiókjához GitHub tárolók vannak csatlakoztatva |
Az integráció kezelése
| Akció | Hogyan |
|---|---|
| Kapcsolódás | Adja meg az API kulcsot az integrációs konfigurációban |
| Irányítópult megtekintése | Nyissa meg a Cursor integrációs oldalát |
| Tárolók szinkronizálása | Kattintson a Frissítés gombra a tárolólista frissítéséhez |
| Kapcsolat bontása | Távolítsa el az API kulcsot a konfigurációból |
Legjobb Gyakorlatok
- Írjon világos feladatleírásokat: Minél specifikusabb az utasítása, annál jobb lesz az ügynök kimenete.
- Használjon megfelelő ágakat: Ne indítson ügynököket közvetlenül a
main-en — engedje meg nekik, hogy PR-t hozzanak létre felülvizsgálatra. - Engedélyezze az automatikus PR létrehozást: Könnyebbé teszi az ügynök munkájának felülvizsgálatát és egyesítését.
- Figyelje a futó ügynököket: Rendszeresen ellenőrizze a műszerfalat, vagy állítson be SmartFlow értesítéseket.
- Felülvizsgálat egyesítés előtt: Mindig vizsgálja felül az ügynök által generált PR-eket, mielőtt egyesítené a termelésbe.
- Kezdje kicsiben: Kezdje jól körülhatárolt feladatokkal, mielőtt nagyobb refaktorálásokat próbálna meg.