# Cursor Agent SDK vs. @cursor/sdk: co je co a na co si dát pozor

> Cursor vydal dva různé SDK: @cursor/sdk z dubna a Agent SDK z října. Co je u Agent SDK doložené, co patří k dubnovému balíčku a co zatím nevíme.

Canonical: https://aicko.cz/content/cursor-agent-sdk-vs-cursor-sdk-co-je-co-a-na-co-si-dat-pozor
Last updated: 2026-11-13
Kategorie: Vibe coding

[Cursor v roce 2026](https://aicko.cz/content/cursor-composer) vydal dvě různé věci, které se jmenují skoro stejně: TypeScript SDK `@cursor/sdk` z 29. dubna a **Cursor Agent SDK** (`@cursor/agent-sdk`) z 20. října. Když hledáš, co Agent SDK umí, snadno narazíš na recenzi dubnového balíčku a přečteš si ji jako hodnocení říjnového. Tenhle krátký přehled odděluje, co je u Agent SDK doložené, co patří k tomu staršímu a co zatím nevíme.

Pokud tě zajímá praktický postup, máme k Agent SDK samostatný návod: [Cursor Agent SDK: první PR reviewer krok za krokem](https://aicko.cz/content/cursor-agent-sdk-prvni-pr-reviewer-krok-za-krokem). Tady jde o orientaci a pozor na záměnu.

## Dva produkty, dvě jména

| | `@cursor/sdk` | Cursor Agent SDK (`@cursor/agent-sdk`) |
|---|---|---|
| Vydáno | 29. 4. 2026 | 20. 10. 2026 |
| Co to je | TypeScript SDK (public beta) pro programové spouštění agentů Cursoru | agent jako složka kódu, který otestuješ evaly a nasadíš; GA od vydání |
| Zdroj | veřejné recenze (The New Stack, DEV Community) | [changelog Cursoru](https://cursor.com/changelog/agent-sdk) |

Rozdíl je důležitý hlavně při čtení recenzí. Výhrady, které se objevují v The New Stack a na DEV Community, se týkají dubnového `@cursor/sdk`, ne říjnového Agent SDK.

## Co Cursor Agent SDK podle changelogu umí

Podle changelogu ze 20. 10. 2026 je Agent SDK obecně dostupný (GA) a začíná se příkazem `npx @cursor/agent-sdk init ./my-bot`. Postavený je takhle:

- **Agent jako složka kódu.** Agenta máš v repozitáři jako obyčejnou složku se soubory, ne jako nastavení někde v rozhraní.
- **Testy přes eval.** Chování agenta můžeš ověřovat evaluačními testy, ne jen ručním zkoušením.
- **Nasazení kam chceš.** Agenta nasadíš do Cursoru, nebo na vlastní infrastrukturu.
- **Hotové šablony.** Changelog uvádí šablony pro security reviewera, schvalovatele podle pravidel vlastnictví kódu (owners-policy approver), automatický opravář pull requestů (PR autofixer) a třídič úkolů pro Linear a Jira.
- **Různé spouštěče.** Agent se dá spustit z GitHubu, GitLabu nebo Bitbucketu, ze Slacku, přes webhook nebo časovačem (cron).

To je všechno, co si dovolíme tvrdit s odkazem na zdroj. Konkrétní krok za krokem najdeš v návodu na PR reviewera výše.

## Co se řeší u dubnového SDK

Recenze, které se k Cursor SDK objevily, jmenují tři věci: SDK je jen pro TypeScript, schémata tool callů nejsou stabilní a zatím chybí API klíče pro správu týmu (team admin). Autoři doporučují brát balíček jako verzi 1. Ber to jako varování pro `@cursor/sdk`. Pro Agent SDK z října tyhle konkrétní výhrady nikdo veřejně nepotvrdil, takže je do hodnocení nepřenášej.

## Proč na rozdílu záleží

Dvě skoro stejná jména způsobují praktické problémy. Hledáš-li informace o stabilitě nebo omezeních, můžeš narazit na text o jiném balíčku a vyvodit špatný závěr. Platí to oběma směry: pochvala dubnového SDK ještě neznamená, že říjnový Agent SDK je hotová věc, a výhrada k tomu dubnovému ještě neznamená, že je problém i v tom novém.

Praktické pravidlo při čtení jakékoli recenze nástroje, který se rychle vyvíjí: najdi v textu datum a přesný název balíčku nebo verze. Pokud se v recenzi píše `@cursor/sdk`, je řeč o dubnovém TypeScript SDK. Pokud `@cursor/agent-sdk`, jde o říjnový Agent SDK. U nových produktů v první verzi počítej s tím, že se rozhraní může měnit, a nepouštěj je rovnou do produkce bez testů.

## Co zatím nevíme

Poctivě je potřeba říct i to, co chybí:

- **Cena.** Changelog u Agent SDK cenu neuvádí. Jak se účtuje běh agentů, si ověř v aktuálním ceníku Cursoru, než na tom postavíš něco ve firmě. Přehled plánů najdeš v článku [Cursor cena 2026: tarify AI editoru a který vybrat](https://aicko.cz/content/cursor-cena-tarify-2026).
- **Zkušenosti z provozu.** Agent SDK je na trhu teprve pár týdnů a nezávislé recenze delšího nasazení zatím chybí. Videa a příspěvky, které se k němu objevily, většinou jen převyprávějí oznámení — o kvalitě a stabilitě toho moc neřeknou.

## Jak to prakticky využít

1. **Přečti si changelog** a ověř, že čteš text o Agent SDK, ne o `@cursor/sdk`.
2. **Zkus šablonu**, která odpovídá tvé práci (třeba třídění úkolů nebo opravy pull requestů), místo psaní agenta od nuly.
3. **Piš evaly od začátku.** Když je agent složka kódu, patří k němu testy stejně jako ke každému jinému kódu.
4. **Nasazuj opatrně.** U agenta, který zasahuje do repozitáře, nech lidskou kontrolu diffu, jak popisujeme v [návodu k Cursoru](https://aicko.cz/content/cursor-navod-jak-pouzivat-ai-editor).

## Časté otázky

### Je Cursor Agent SDK totéž co @cursor/sdk?
Ne. `@cursor/sdk` je TypeScript SDK z 29. 4. 2026, Agent SDK (`@cursor/agent-sdk`) vyšel 20. 10. 2026 a jde o jiný produkt.

### Kde najdu oficiální popis Agent SDK?
V [changelogu Cursoru](https://cursor.com/changelog/agent-sdk). Tam jsou šablony i způsoby spouštění, ze kterých tenhle článek vychází.

### Kolik Cursor Agent SDK stojí?
Changelog cenu neuvádí. Ověř si ji v aktuálním ceníku Cursoru.

## Závěr

Nejdůležitější praktická věc je odlišit dvě jména: kritika dubnového `@cursor/sdk` se na říjnový Cursor Agent SDK nevztahuje automaticky. Co je doložené, je v changelogu: agent jako složka kódu, evaly, nasazení do Cursoru nebo na vlastní infrastrukturu, šablony a spouštěče. Zbytek, tedy cenu a reakce uživatelů, je potřeba ověřit samostatně.

## Related

- [Obsah: Vibe coding](https://aicko.cz/obsah/vibe-coding)
- [Cursor](https://aicko.cz/ai-tools/cursor)
- [Jira](https://aicko.cz/ai-tools/jira)
- [Linear](https://aicko.cz/ai-tools/linear)

---
Zdroj: AIčko.cz. Při citaci uveďte název webu a odkaz na https://aicko.cz/content/cursor-agent-sdk-vs-cursor-sdk-co-je-co-a-na-co-si-dat-pozor
