Stav: vývoj, zatím bez veřejného provozu

Odpovědi nad vašimi daty, ne nad fantazií modelu

AI Asistent je bezstavové API. Převede otázku v běžné řeči na typované parametry pro vaše vyhledávání a pak napíše odpověď výhradně ze záznamů, které dodá váš backend, včetně karet zdrojů. Není to chatbot proxy.

Implementační návod Jak to funguje

Z otázky vznikají parametry vašeho hledání

POST /v1/interpretations

"question": "Máte stan do 3000 Kč skladem?"

-> {
  "status": "ready",
  "parameters": {
    "category": "outdoor",
    "maxPrice": 3000,
    "inStock": true
  }
}

Jak to funguje

Aplikace nikdy nevolá AI Asistenta přímo. Volá váš backend, ten drží klíč, hledá ve vlastních datech a rozhoduje, kdo co smí vidět.

Čárkovaná šipka znamená přeskočení interpretace. Pokud už filtry znáte (formulář, FAQ), zavolejte rovnou /v1/answers a ušetříte jednu placenou operaci na otázku.

Výsledek se z backendu vrací aplikaci jako prostý text odpovědi a karty zdrojů s odkazy na vaše vlastní stránky.

Co API umí

Typovaná extrakce polí

Definujete pole typu string, integer, boolean, date nebo stringArray, volitelně s allowedValues. Výstup se ověřuje proti definici.

Odpovědi opřené o zdroje

Model smí citovat jen ID zdrojů ze vstupu. URL pocházejí z vašeho vstupu, modelem vymyšlené odkazy se nevracejí.

Prázdný vstup bez modelu

Při prázdném seznamu zdrojů vrátí API deterministickou odpověď insufficient_sources. Bez volání modelu a bez čerpání kvóty.

Více tenantů a klíče

API klíče se ukládají jen jako hash, lze je rotovat a zrušení platí okamžitě.

Měsíční kvóty

Počítadla v PostgreSQL jsou atomická a přežijí restart.

Limit souběhu

Při přetížení vrací 429 s hlavičkou Retry-After, nic se nefrontuje.

Stabilní chyby

ProblemDetails se stabilním code a traceId pro dohledání.

Soukromí

API neukládá prompty, zdroje ani odpovědi a nikdy nestahuje URL.

Jazyky

Lokalizace cs-CZ a en-US.

OpenAPI

Popis kontraktu je na /openapi/v1.json.

Nasazení

Docker image a PostgreSQL 17. Cílem je Hostinger VPS nebo kontejnery v Azure.

Model

Claude Haiku přes Anthropic, model je konfigurovatelný.

Testy

72 automatických testů nad skutečným PostgreSQL, bez placených volání modelu (stav k 15. 10. 2026).

Kdo za co ručí

AI Asistent nikdy nerozhoduje, kdo smí záznam vidět, a nikdy nestahuje URL zdrojů. Připojení nového systému je adaptér ve vašem backendu, ne změna v API.

Backend volající aplikace	AI Asistent
Definice polí, kontext, historie konverzace	Přihlašovací údaje tenantů a API klíče
Validace interpretovaných parametrů a obchodní pravidla	Volání modelu a validace jeho výstupu
Vyhledávání ve vlastních datech a autorizace uživatele	Měsíční kvóty, limit souběhu, metadata spotřeby
Výběr záznamů, které se stanou zdroji	Kontrola, že citované zdroje pocházejí z požadavku
Vykreslení odpovědi a karet zdrojů	Nic se neukládá: žádná data volajícího, prompty ani odpovědi

Pokračovat na implementační návod

Co ještě není

Stav k 28. 10. 2026. Raději napíšeme, co chybí, než to nechat uhádnout.

Zatím neexistuje

Veřejný produkční provoz ani endpoint, API běží jen lokálně.
Živý test se skutečným modelem a hodnocení české kvality (30 otázek) ještě neproběhly.
První integrace (backend TveMesto a mobilní aplikace) nezačala.
Přístup jen na vyžádání, bez samoobslužné registrace.
Žádná fakturace ani administrační UI.
Žádné klientské SDK, jen HTTP API a ukázkový C# adaptér.

Známá omezení verze 1

Jedna replika, limit souběhu je v rámci procesu.
Žádná idempotence ani exactly-once, placené operace se nikdy automaticky neopakují.
Validace citací prokazuje, že zdroj byl na vstupu, ne že je pravdivá každá věta.
Jen plochá pole, žádné vnořené nástroje ani zápisové akce.
Žádný streaming.

Záměrně odložené

Spravované ukládání konverzací
Crawling a nahrávání dokumentů
Spouštění nástrojů
Streaming
Zápisové akce
Směrování mezi více poskytovateli
Trénování modelů

Přijdou až s konkrétní potřebou skutečné integrace.