API

Jak funguje API?

API funguje jako přepážka s pevnými pravidly: víte, o co smíte požádat, v jakém tvaru a co dostanete zpět. Program, který o něco žádá, se nazývá klient, program, který odpovídá, server. Jedna výměna má tři části:

• Požadavek: adresa služby, požadovaná operace (například „přelož tento text“) a vstupní data.
• Přístupový klíč: tajný řetězec znaků, kterým se aplikace prokazuje. Podle něj služba pozná, kdo žádá a komu práci vyúčtovat.
• Odpověď: výsledek ve strojově čitelném tvaru, nejčastěji ve formátu JSON (strukturovaný text s pojmenovanými položkami).

U jazykových modelů vypadá požadavek jako zpráva v chatu, jen ji neposílá člověk, ale program. Model vrátí text a program s ním dál pracuje, třeba ho vloží do dokumentu.

Čím se API liší od chatu s AI?

Chat je okno pro člověka, API je vchod pro programy ke stejnému modelu. Přes API nemáte okno s historií konverzace ani tlačítka, zato jde stejný pokyn spustit automaticky stokrát za sebou. U velkých poskytovatelů AI se API obvykle platí zvlášť od předplatného chatu, podle objemu zpracovaného textu. Od MCP se API liší tím, že každá služba má vlastní API s vlastními pravidly, kdežto MCP je jednotný standard, přes který AI asistent připojuje různé aplikace.

Jaký je nejčastější omyl o API?

Častý omyl je, že API je samo o sobě umělá inteligence. API je jen rozhraní, stejné rozhraní mají bankovní systémy, mapy nebo jízdní řády. Druhý omyl: „mám předplatné chatu, takže mám i API“. Jde zpravidla o dvě oddělené služby s vlastním účtem a vlastními podmínkami.

K čemu se API hodí v práci?

API se hodí všude, kde se opakuje stejný přesun dat mezi aplikacemi nebo stejný pokyn pro AI.

• Asistentka ředitele: formulář z webu pošle přihlášku přes API do tabulky, takže ji nepřepisuje ručně.
• Marketér: nástroj na automatizaci postupů každé ráno stáhne přes API nové recenze a jazykový model je roztřídí na pochvaly a stížnosti.
• Správce IT: propojí docházkový systém s personální agendou, aby se změny úvazků promítly do obou.
• Studijní referentka: aplikace pošle schválený text pokynů přes API překladové službě a návrh překladu vloží vedle originálu ke kontrole.

Propojení se dá poskládat i bez programování v nástrojích jako n8n.

Příklad zadání

Personalistka chce, aby nástroj na automatizaci posílal každou novou odpověď z dotazníku spokojenosti jazykovému modelu přes API. Pokyn, který se s každou odpovědí odešle, zní:

Jsi asistent personálního oddělení. Dostaneš jednu anonymní odpověď z dotazníku spokojenosti zaměstnanců.
Vrať pouze JSON s položkami:
"tema": jedno z [mzda, vedení, pracovní prostředí, vzdělávání, jiné],
"nalada": jedno z [pozitivní, neutrální, negativní],
"shrnuti": jedna věta, bez jmen a bez údajů, podle kterých jde pisatele poznat.
Odpověď: {{text_odpovedi}}

Pevný tvar odpovědi umožní programu výsledek rovnou zapsat do tabulky. Prvních dvacet výsledků zkontrolujte ručně, jestli model třídí témata správně.