Cursor Cloud Agents

Připojte AI SmartTalk k Cursor Cloud Agents a spusťte autonomní AI asistenty pro kódování přímo z vašich konverzací nebo pracovních postupů. Cursor Cloud Agents mohou číst repozitáře, generovat kód, vytvářet commity a automaticky otevírat pull requesty.

---

Přehled

Integrace Cursor Cloud Agents vám umožňuje:

• Spustit AI kódovací agenty na vašich GitHub repozitářích
• Automatizovat generování kódu pomocí pokynů v přirozeném jazyce
• Automaticky vytvářet pull requesty po dokončení úkolů
• Sledovat pokrok agentů a zobrazit historii konverzací
• Přidávat následné pokyny k běžícím agentům
• Spouštět kódovací úkoly z pracovních postupů SmartFlow

---

Požadavky

Než začnete, ujistěte se, že máte:

• Aktivní účet AI SmartTalk
• Účet Cursor s přístupem k Cloud Agents
• Klíč API Cursor (získaný z vašeho dashboardu Cursor)
• GitHub repozitáře přístupné z vašeho účtu Cursor

---

Krok za krokem nastavení

Krok 1: Získejte svůj klíč API Cursor

1. Přejděte na váš dashboard Cursor Cloud Agent
2. Přejděte do nastavení API
3. Vygenerujte nový klíč API pro AI SmartTalk
4. Zkopírujte klíč API

Krok 2: Přístup k integraci Cursor

1. Přihlaste se do svého účtu AI SmartTalk
2. Přejděte na Administrace → Moji asistenti → [Název vašeho asistenta]
3. Klikněte na Konektory v levém postranním panelu
4. Najděte Cursor Cloud Agents a klikněte na něj

Krok 3: Nakonfigurujte připojení

1. Klikněte na Nastavit konfiguraci
2. Zadejte svůj klíč API Cursor
3. Klikněte na Uložit konfiguraci
4. AI SmartTalk automaticky ověří váš klíč API

Krok 4: Synchronizujte repozitáře

Jakmile se připojíte, AI SmartTalk automaticky synchronizuje přístupné GitHub repozitáře z vašeho účtu Cursor. Můžete také kdykoli ručně obnovit seznam repozitářů.

---

Dashboard

Jakmile se připojíte, dashboard integrace Cursor poskytuje kompletní přehled:

Přehled statistik

Metrika	Popis
Celkem agentů	Počet spuštěných agentů
Běžící	Aktuálně aktivní agenti
Dokončeno	Dokončení agenti
Dostupné modely	AI modely dostupné pro agenty

Nedávní asistenti

Dashboard zobrazuje vaše nejnovější agenty s:

• ID agenta pro referenci
• Stav: Běžící, Dokončeno, Neúspěšné, Vytváření nebo Zrušeno
• Repozitář, na kterém agent pracuje
• Datum vytvoření
• Rychlé akce: Zobrazit detaily a Zobrazit PR

Dashboard se automaticky obnovuje každých 30 sekund, když agenti běží.

---

Spuštění agenta

Z dashboardu

1. Klikněte na Spustit nového asistenta
2. Vyplňte formulář pro spuštění:

Pole	Povinné	Popis
Repozitář	Ano	Vyberte GitHub repozitář z rozbalovacího seznamu
Popis úkolu	Ano	Popište, co by měl agent dělat v přirozeném jazyce
Větev	Ne	Git větev, na které se má pracovat (výchozí: main)
AI model	Ne	Vyberte konkrétní AI model pro agenta
Automaticky vytvořit PR	Ne	Automaticky vytvořit pull request po dokončení (výchozí: povoleno)
Název větve	Ne	Vlastní název větve pro pull request

3. Klikněte na Spustit agenta

Příklady popisu úkolu

• "Přidejte jednotkové testy pro autentizační modul"
• "Refaktorujte připojení k databázi, aby používalo recyklaci připojení"
• "Opravit chybu, kdy se uživatelské relace předčasně vyprší na mobilu"
• "Přidejte TypeScript typové definice pro všechny objekty odpovědi API"
• "Vytvořte REST API koncový bod pro uživatelské preference"

---

Správa agentů

Zobrazit detaily agenta

Klikněte na Zobrazit detaily u jakéhokoli agenta, abyste viděli:

Záložka přehledu:

• ID agenta a aktuální stav
• Informace o repozitáři a větvi
• Odkaz na pull request (pokud byl vytvořen)
• Souhrn provedené práce
• Časové razítko vytvoření

Záložka konverzace:

• Úplná historie zpráv o práci agenta
• Pokyny uživatele a odpovědi AI
• Záznam pokroku krok za krokem

Přidat následné pokyny

Můžete poslat další pokyny běžícímu agentovi:

1. Otevřete detaily agenta
2. Zadejte svou následnou instrukci (např. "Také přidejte zpracování chyb pro okrajový případ, kdy uživatel není nalezen")
3. Agent pokračuje ve své práci s novým kontextem

Smazat agenta

Pro úklid zdrojů:

1. Klikněte na akci smazání na kartě agenta
2. Potvrďte smazání
3. Agent a jeho zdroje jsou odstraněny

---

Integrace SmartFlow

Cursor Cloud Agents mohou být použity jako akce v pracovních postupech SmartFlow, což umožňuje silné automatizační scénáře.

Dostupné akce SmartFlow

Akce	Popis
Spustit kódovacího agenta	Spustit agenta na repozitáři se specifickými pokyny
Přidat následné pokyny	Poslat další pokyny běžícímu agentovi
Získat stav agenta	Zkontrolovat pokrok a stav agenta
Smazat agenta	Odstranit agenta a uklidit zdroje

Příklad: Automatická oprava na hlášení o chybě

Trigger: Chat Service (když uživatel nahlásí chybu)
Actions:
  1. AI Request:
       Prompt: Extrahujte popis chyby a postižený repozitář
  2. Cursor Launch Agent:
       Repository: {{extracted_repository}}
       Task: "Opravit tuto chybu: {{bug_description}}"
       Auto-create PR: true
  3. Send Message:
       Text: "Spustil jsem kódovacího agenta pro opravu. Oznámím vám, když bude PR připraveno."
  4. Wait / Poll:
       Pravidelně kontrolujte stav agenta
  5. Send Message:
       Text: "Oprava je hotová! Zkontrolujte PR zde: {{pr_url}}"

Příklad: Naplánované zlepšení kódu

Trigger: Naplánovaný pracovní postup (týdně)
Actions:
  1. Cursor Launch Agent:
       Repository: my-org/my-app
       Task: "Zkontrolovat a aktualizovat všechny zastaralé závislosti"
       Branch: chore/update-deps
       Auto-create PR: true

Pro podrobné parametry akcí SmartFlow viz Cursor SmartFlow Actions.

---

Případové studie

Bot pro podporu vývojářů

Nechte uživatele požadovat změny kódu prostřednictvím chatu:

• "Můžete přidat validaci vstupu do registračního formuláře?"
• "Prosím, vytvořte migrační skript pro nová uživatelská pole"

Automatizované opravy chyb

Spouštějte kódovací agenty z hlášení o chybách nebo monitorovacích upozornění, aby automaticky generovaly opravy PR.

Automatizace revize kódu

Spouštějte agenty pro revizi kódu, přidávání testů nebo zlepšování dokumentace na základě zpětné vazby k PR.

Naplánovaná údržba

Nastavte opakující se pracovní postupy pro aktualizaci závislostí, provádění oprav lintingu nebo generování zpráv.

---

Řešení problémů

Problém	Řešení
"Neplatný klíč API"	Znovu vygenerujte svůj klíč API z dashboardu Cursor
"Repozitář nebyl nalezen"	Klikněte na Obnovit, abyste znovu synchronizovali repozitáře. Ujistěte se, že je repozitář přístupný z vašeho účtu Cursor
Agent uvízl ve stavu "Vytváření"	Agent může být v čekacím pořadí. Počkejte několik minut a zkontrolujte stav znovu
Agent selhal	Otevřete detaily agenta, abyste viděli konverzaci a chybová hlášení
PR nebyl vytvořen	Zkontrolujte, zda byla povolena automatická tvorba PR a agent úspěšně dokončil
Žádné dostupné repozitáře	Ujistěte se, že váš účet Cursor má připojené GitHub repozitáře

---

Správa integrace

Akce	Jak
Připojit	Zadejte klíč API v konfiguraci integrace
Zobrazit dashboard	Otevřete stránku integrace Cursor
Synchronizovat repozitáře	Klikněte na Obnovit pro aktualizaci seznamu repozitářů
Odpojit	Odstraňte klíč API z konfigurace

---

Best Practices

1. Napište jasné popisy úkolů: Čím konkrétnější jsou vaše pokyny, tím lepší bude výstup agenta.
2. Používejte vhodné větve: Nespouštějte agenty přímo na main — nechte je vytvářet PR k revizi.
3. Povolit automatické vytváření PR: Usnadňuje to revizi a sloučení práce agenta.
4. Sledujte běžící agenty: Pravidelně kontrolujte řídicí panel nebo nastavte upozornění SmartFlow.
5. Revidujte před sloučením: Vždy revidujte PR generované agentem před sloučením do produkce.
6. Začněte s malými úkoly: Začněte s dobře vymezenými úkoly před pokusem o velké refaktoringy.

---

Related Documentation

• Cursor SmartFlow Actions
• SmartFlow Introduction
• Integrations Overview