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.

Čo si agent stiahne

Prompt odkazuje na štyri súbory uložené priamo na tomto webe. Nič z toho nie je tajné — môžete si každý z nich otvoriť a skontrolovať, čo presne agent dostane.

Súbor	Čo obsahuje
`ai/llms.txt`	Krátky index dokumentácie s odkazmi na ostatné stránky a špecifikácie — orientačný bod pre agenta.
`ai/llms-full.txt`	Celá dokumentácia webu v jednom súbore — autorizačné modely, scenáre integrácií, webhooky, chyby a limity.
`ai/kros-openapi.json`	OpenAPI 3.0 špecifikácia 43 endpointov KROS API.
`ai/kros-webhooks-openapi.json`	OpenAPI 3.0 špecifikácia 3 webhookov, ktoré KROS posiela na váš endpoint.

Radšej skill než prompt?

Stiahnite si ai/kros-api-integration-skill.zip a rozbaľte ho do .claude/skills/.

Agent tak má celú dokumentáciu k dispozícii offline a natrvalo, bez toho, aby si čokoľvek musel sťahovať.

Markdown verzia každej stránky

Každá stránka tohto webu má svoje dvojča vo formáte Markdown v priečinku md/, generované priamo z HTML. Agent tak nikdy nemusí parsovať HTML — začnite napríklad pri md/index.md.

Odkiaľ pochádzajú dáta

Táto dokumentácia sa generuje priamo z tohto webu, takže nemôže odísť mimo synchronizáciu s tým, čo si prečíta človek. Definície endpointov ale vždy pochádzajú z OpenAPI špecifikácií vyššie — a živý Swagger je nad nimi autoritatívny zdroj.