Swagger

Naučiť AI agenta

Skopírujte jeden prompt nižšie a vložte ho do Claude Code alebo iného AI agenta — agent si sám stiahne dokumentáciu aj OpenAPI špecifikácie, aby rozumel KROS API. Až potom mu zadáte, čo má postaviť alebo rozšíriť.

Prompt

Všeobecný variant agenta iba naučí KROS API a potom sa zastaví — nič nedopĺňate a hodí sa aj vtedy, keď integráciu už máte a chcete ju len rozšíriť. E-shop a POS idú ďalej: majú predvyplnený smer dát, ukazujú na overený scenár napojenia a agent po nich navrhne postup. V tých dvoch dopíšte polia označené <DOPLŇ>.

Prompt pre vášho AI agenta

Agent v každom variante najprv stiahne a prečíta zdroje. Kód nezačne písať, kým mu to nepovolíte.

Naštuduj si KROS OpenAPI (fakturácia a sklad, Slovensko). Zatiaľ nič
neimplementuj — potrebujem, aby si najprv rozumel tomu, ako to API funguje.

Stiahni a prečítaj CELÉ tieto zdroje:

1. ${BASE_URL}/ai/llms-full.txt
   Celá dokumentácia KROS API v jednom súbore — autorizačné modely,
   scenáre integrácií, webhooky, chybové kódy, limity.
2. ${BASE_URL}/ai/kros-openapi.json
   OpenAPI 3.0 špecifikácia endpointov.
3. ${BASE_URL}/ai/kros-webhooks-openapi.json
   OpenAPI 3.0 špecifikácia webhookov, ktoré KROS posiela na tvoj endpoint.

Po prečítaní mi krátko zhrň:
1. Aké autorizačné modely KROS API ponúka a čím sa od seba líšia.
2. Aké skupiny endpointov existujú a na čo slúžia.
3. Ako fungujú webhooky a aké sú chybové kódy a limity.

Potom sa zastav a čakaj na moje pokyny. Nenavrhuj architektúru, nepíš
kód a nemeň nič v projekte, kým ti nepovím, čo presne potrebujem.

Nevymýšľaj si názvy polí, endpointov ani hodnôt. Ak niečo nie je
v stiahnutých zdrojoch, povedz že to nevieš a spýtaj sa.
Budeš implementovať integráciu s KROS OpenAPI (fakturácia a sklad, Slovensko).
Najprv stiahni a prečítaj CELÉ tieto zdroje, až potom navrhuj kód:

1. ${BASE_URL}/ai/llms-full.txt
   Celá dokumentácia KROS API v jednom súbore — autorizačné modely,
   scenáre integrácií, webhooky, chybové kódy, limity.
2. ${BASE_URL}/ai/kros-openapi.json
   OpenAPI 3.0 špecifikácia endpointov.
3. ${BASE_URL}/ai/kros-webhooks-openapi.json
   OpenAPI 3.0 špecifikácia webhookov, ktoré KROS posiela na tvoj endpoint.
4. ${BASE_URL}/md/integracie-eshop.md
   Overený scenár: objednávky a faktúry z e-shopu do KROSu, skladové karty
   a zostatky späť — odporúčané endpointy a postup.

Kontext môjho zadania:
- Produkt, ktorý integrujem: <DOPLŇ>
- Smer dát: objednávky a faktúry z e-shopu do KROSu, skladové karty a zostatky späť
- Autorizačný model: <DOPLŇ, alebo napíš „vyber podľa dokumentácie">
- Jazyk a framework: <DOPLŇ>

Po prečítaní zdrojov:
1. Zhrň mi jedným odstavcom, ktorý autorizačný model si vybral a prečo.
2. Vypíš presný zoznam endpointov, ktoré budeme volať, v poradí.
3. Až po mojom potvrdení začni písať kód.

Nevymýšľaj si názvy polí, endpointov ani hodnôt. Ak niečo nie je
v stiahnutých zdrojoch, povedz že to nevieš a spýtaj sa.
Budeš implementovať integráciu s KROS OpenAPI (fakturácia a sklad, Slovensko).
Najprv stiahni a prečítaj CELÉ tieto zdroje, až potom navrhuj kód:

1. ${BASE_URL}/ai/llms-full.txt
   Celá dokumentácia KROS API v jednom súbore — autorizačné modely,
   scenáre integrácií, webhooky, chybové kódy, limity.
2. ${BASE_URL}/ai/kros-openapi.json
   OpenAPI 3.0 špecifikácia endpointov.
3. ${BASE_URL}/ai/kros-webhooks-openapi.json
   OpenAPI 3.0 špecifikácia webhookov, ktoré KROS posiela na tvoj endpoint.
4. ${BASE_URL}/md/integracie-pos.md
   Overený scenár: skladové karty do pokladne, predaje a tržby späť do
   KROSu — odporúčané endpointy a postup.

Kontext môjho zadania:
- Produkt, ktorý integrujem: <DOPLŇ>
- Smer dát: skladové karty do pokladne, predaje a tržby späť do KROSu
- Autorizačný model: <DOPLŇ, alebo napíš „vyber podľa dokumentácie">
- Jazyk a framework: <DOPLŇ>

Po prečítaní zdrojov:
1. Zhrň mi jedným odstavcom, ktorý autorizačný model si vybral a prečo.
2. Vypíš presný zoznam endpointov, ktoré budeme volať, v poradí.
3. Až po mojom potvrdení začni písať kód.

Nevymýšľaj si názvy polí, endpointov ani hodnôt. Ak niečo nie je
v stiahnutých zdrojoch, povedz že to nevieš a spýtaj sa.

Radšej skill než prompt?

Prompt si agent musí stiahnuť v každom novom chate. Skill zostane v projekte natrvalo — dokumentáciu aj obe OpenAPI špecifikácie má agent na disku a offline.

Skill pre KROS API

Dva kroky, potom už agent o KROS API vie sám.

  1. Stiahnite balíček

    Obsahuje pokyny pre agenta (SKILL.md) a tri referenčné súbory — celú dokumentáciu tohto webu, OpenAPI špecifikáciu endpointov a OpenAPI špecifikáciu webhookov.

    Stiahnuť skill (ZIP, 60 kB)

  2. Rozbaľte ho do projektu

    Do priečinka .claude/skills/ v koreni projektu, s ktorým pracujete:

    bash 
    unzip kros-api-integration-skill.zip -d .claude/skills/

    Agent si skill načíta sám pri ďalšom spustení — nič ďalšie nenastavujete.