Cursor Cloud Agents

Yhdistä AI SmartTalk Cursor Cloud Agents -palveluun käynnistääksesi autonomisia AI-koodausassistentteja suoraan keskusteluistasi tai työnkuluistasi. Cursor Cloud Agents voi lukea repositorioita, generoida koodia, luoda committeja ja avata pull requesteja automaattisesti.

---

Yleiskatsaus

Cursor Cloud Agents -integraatio mahdollistaa sinulle:

• Käynnistää AI-koodausassistentteja GitHub-repositorioissasi
• Automatisoida koodin generoinnin luonnollisen kielen ohjeiden avulla
• Luoda pull requesteja automaattisesti, kun tehtävät on suoritettu
• Seurata agentin edistymistä ja tarkastella keskusteluhistoriaa
• Lisätä jatko-ohjeita käynnissä oleville agenteille
• Käynnistää koodaus tehtäviä SmartFlow-työnkuluista

---

Esivaatimukset

Ennen kuin aloitat, varmista, että sinulla on:

• Aktiivinen AI SmartTalk -tili
• Cursor -tili, jolla on pääsy Cloud Agents -palveluun
• Cursor API -avain (saadaan Cursor-hallintapaneelista)
• GitHub-repositoriot, joihin pääsee Cursor-tililtäsi

---

Vaiheittainen asennus

Vaihe 1: Hanki Cursor API -avain

1. Siirry Cursor Cloud Agent -hallintapaneeliisi
2. Siirry API-asetuksiisi
3. Generoi uusi API-avain AI SmartTalkia varten
4. Kopioi API-avain

Vaihe 2: Pääsy Cursor-integraatioon

1. Kirjaudu AI SmartTalk -tilillesi
2. Siirry kohtaan Hallinta → Omat assistentit → [Oma assistenttisi nimi]
3. Napsauta Liittimet vasemmassa sivupalkissa
4. Etsi Cursor Cloud Agents ja napsauta sitä

Vaihe 3: Määritä yhteys

1. Napsauta Määritä kokoonpano
2. Syötä Cursor API -avain
3. Napsauta Tallenna kokoonpano
4. AI SmartTalk validoi API-avaimesi automaattisesti

Vaihe 4: Synkronoi repositoriot

Kun yhteys on muodostettu, AI SmartTalk synkronoi automaattisesti käytettävissä olevat GitHub-repositoriot Cursor-tililtäsi. Voit myös manuaalisesti päivittää repositorioiden luetteloa milloin tahansa.

---

Hallintapaneeli

Kun yhteys on muodostettu, Cursor-integraation hallintapaneeli tarjoaa täydellisen yleiskuvan:

Tilastot

Mittari	Kuvaus
Yhteensä agenteja	Käynnistettyjen agenteiden määrä
Käynnissä	Tällä hetkellä aktiiviset agentit
Valmiit	Suoritetut agentit
Saatavilla olevat mallit	AI-mallit, jotka ovat saatavilla agenteille

Äskettäin käytetyt assistentit

Hallintapaneeli listaa äskettäin käytetyt agentit:

• Agentin ID viitteeksi
• Tila: Käynnissä, Valmis, Epäonnistunut, Luodaan tai Peruutettu
• Repo johon agentti työskentelee
• Luontipäivämäärä
• Nopeat toiminnot: Näytä tiedot ja Näytä PR

Hallintapaneeli päivittää automaattisesti 30 sekunnin välein kun agentit ovat käynnissä.

---

Agentin käynnistäminen

Hallintapaneelista

1. Napsauta Käynnistä uusi assistentti
2. Täytä käynnistyslomake:

Kenttä	Pakollinen	Kuvaus
Repo	Kyllä	Valitse GitHub-repositorio pudotusvalikosta
Tehtävän kuvaus	Kyllä	Kuvaile, mitä agentin tulisi tehdä luonnollisella kielellä
Haara	Ei	Git-haara, jolla työskennellä (oletus: main)
AI-malli	Ei	Valitse tietty AI-malli agentille
Automaattinen PR:n luonti	Ei	Luo automaattisesti pull request, kun tehtävä on valmis (oletus: käytössä)
Haara nimi	Ei	Mukautettu haaran nimi pull requestille

3. Napsauta Käynnistä agentti

Tehtävän kuvausesimerkkejä

• "Lisää yksikkötestit todennusmoduulille"
• "Refaktoroida tietokannan yhteysuima käyttämään yhteyksien kierrätystä"
• "Korjaa bugi, jossa käyttäjäistunnot vanhenevat liian aikaisin mobiilissa"
• "Lisää TypeScript-tyyppimääritykset kaikille API-vastausobjekteille"
• "Luo REST API -päätepiste käyttäjän asetuksille"

---

Agenteiden hallinta

Näytä agentin tiedot

Napsauta Näytä tiedot mitä tahansa agenttia nähdäksesi:

Yleiskatsaus-välilehti:

• Agentin ID ja nykyinen tila
• Repo ja haaratiedot
• Pull request -linkki (jos luotu)
• Yhteenveto suoritetusta työstä
• Luontiaika

Keskustelu-välilehti:

• Täydellinen viestihistoria agentin työstä
• Käyttäjän ohjeet ja AI-vastaukset
• Vaiheittainen edistymispäiväkirja

Lisää jatko-ohjeita

Voit lähettää lisäohjeita käynnissä olevalle agentille:

1. Avaa agentin tiedot
2. Syötä jatko-ohjeesi (esim. "Lisää myös virheenkäsittely äärimmäiselle tapaukselle, jossa käyttäjää ei löydy")
3. Agentti jatkaa työtään uuden kontekstin kanssa

Poista agentti

Resurssien siivoamiseksi:

1. Napsauta poisto-toimintoa agenttikortilla
2. Vahvista poisto
3. Agentti ja sen resurssit poistetaan

---

SmartFlow-integraatio

Cursor Cloud Agents -palvelua voidaan käyttää toimintoina SmartFlow-työnkuluissa, mahdollistaen tehokkaita automaatioskenaarioita.

Saatavilla olevat SmartFlow-toiminnot

Toiminto	Kuvaus
Käynnistä koodausagentti	Käynnistä agentti repositoriossa tietyillä ohjeilla
Lisää jatko-ohje	Lähetä lisäohjeita käynnissä olevalle agentille
Hae agentin tila	Tarkista agentin edistyminen ja tila
Poista agentti	Poista agentti ja siivoa resurssit

Esimerkki: Automaattinen korjaus bugiraportissa

Trigger: Chat Service (kun käyttäjä raportoi bugin)
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}}"

Esimerkki: Aikataulutetut koodiparannukset

Trigger: Scheduled Workflow (viikoittain)
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

Yksityiskohtaisia SmartFlow-toimintoparametreja varten katso Cursor SmartFlow Actions.

---

Käyttötapaukset

Kehittäjätuki-botti

Anna käyttäjien pyytää koodimuutoksia chatin kautta:

• "Voitko lisätä syötevalidoinnin rekisteröitymislomakkeeseen?"
• "Luo siirtoskripti uusille käyttäjäkentille"

Automaattinen bugikorjaus

Käynnistä koodausagentteja bugiraporteista tai valvontahälytyksistä automaattisesti luodaksesi korjaus-PR:itä.

Koodin tarkastuksen automaatio

Käynnistä agenteja tarkastamaan koodia, lisäämään testejä tai parantamaan dokumentaatiota PR-palaute perusteella.

Aikataulutettu ylläpito

Aseta toistuvia työnkulkuja päivittämään riippuvuuksia, suorittamaan lint-fixejä tai luomaan raportteja.

---

Vianetsintä

Ongelma	Ratkaisu
"Virheellinen API-avain"	Generoi API-avain uudelleen Cursor-hallintapaneelista
"Repoa ei löytynyt"	Napsauta Päivitä synkronoidaaksesi repositoriot uudelleen. Varmista, että repo on käytettävissä Cursor-tililtäsi
Agentti jumissa "Luodaan"	Agentti saattaa olla jonossa. Odota muutama minuutti ja tarkista tila uudelleen
Agentti epäonnistui	Avaa agentin tiedot nähdäksesi keskustelun ja virheilmoitukset
PR:ää ei luotu	Tarkista, että automaattinen PR:n luonti oli käytössä ja agentti suoritettiin onnistuneesti
Ei saatavilla olevia repositorioita	Varmista, että Cursor-tililläsi on yhteyksiä GitHub-repositorioihin

---

Integraation hallinta

Toiminto	Kuinka
Yhdistä	Syötä API-avain integraation kokoonpanoon
Näytä hallintapaneeli	Avaa Cursor-integraatiosivu
Synkronoi repositoriot	Napsauta Päivitä päivittääksesi repositorioiden luettelon
Katkaise yhteys	Poista API-avain kokoonpanosta

---

Parhaat käytännöt

1. Kirjoita selkeitä tehtäväkuvauksia: Mitä tarkempia ohjeesi ovat, sitä parempi on agentin tuotos.
2. Käytä sopivia haaroja: Älä käynnistä agenteja suoraan main-haarassa — anna niiden luoda PR:itä tarkistettavaksi.
3. Ota käyttöön automaattinen PR:n luonti: Helpottaa agentin työn tarkistamista ja yhdistämistä.
4. Seuraa käynnissä olevia agenteja: Tarkista hallintapaneeli säännöllisesti tai aseta SmartFlow-ilmoituksia.
5. Tarkista ennen yhdistämistä: Tarkista aina agentin luomat PR:t ennen niiden yhdistämistä tuotantoon.
6. Aloita pienestä: Aloita hyvin rajatuista tehtävistä ennen suurten refaktorointien yrittämistä.

---

Liittyvä dokumentaatio

• Cursor SmartFlow -toiminnot
• SmartFlow -esittely
• Integraatioiden yleiskatsaus