Dokumentace

Glossary

Slovník používaný napříč UI platformy, dokumentací a API. Když v projektu uvidíte některé z těchto slov, tohle je, co znamená.

Project a konfigurace

Tenant — váš účet. Hranice pro fakturaci a izolaci. Jeden tenant může obsahovat mnoho projektů, členů a API klíčů.

Project — jedna firma s jedním hlasovým agentem. Drží scénáře, knowledge base, propojení pluginů, členy, API klíče a čerpání z peněženky. Většina operací na platformě je scoped na jeden projekt.

Industry Pack — kalibrovaný balíček všeho, co agent potřebuje v konkrétním vertikále (Restaurants, Sales, Real estate, Government). Výběr packu při vytváření projektu nasadí scénáře, sloty, cíle, intent routes a požadavky na pluginy. Potom plně editovatelný.

Member — osoba s přístupem k projektu. Role: Owner, Editor, Viewer.

Role — úroveň oprávnění člena na projektu. Owner = plná kontrola; Editor = konfigurace, ale ne billing; Viewer = jen čtení.

Copilot — AI asistent vestavěný do platformy (web i mobil). Odpovídá na otázky o projektu a navrhuje typované změny konfigurace — cíle, prompty, packy — které aplikujete, zpřesníte nebo odmítnete. Nic se nemění bez vašeho explicitního apply.

Runtime konverzace

Scenario — jeden typ hovoru pro jeden projekt. „Příchozí rezervace“, „odchozí připomínka“, „kvalifikace leadu“ — každý je scénář. Projekt má mnoho scénářů. Každý je buď inbound, nebo outbound.

Session — jedno spuštění scénáře pro jeden telefonní hovor nebo textovou konverzaci. Drží přepis hovoru, hodnoty slotů, tool cally, referenci nahrávky, outcome a cenu.

Slot — typovaná strukturovaná hodnota, kterou agent během session sbírá. partySize: integer, bookingTime: datetime, phone: phone. Každý scénář deklaruje sloty, které potřebuje.

Goal — business výsledek, kterého má scénář dosáhnout. Nese kritéria úspěchu, omezení, pravidla eskalace, tón a prioritu. Většina scénářů má jeden primární cíl.

Step — pojmenovaný účastník flow scénáře (slot_collection, say, branch). Většina jednoduchých scénářů je jeden krok slot_collection, který vlastní všechny sloty; agent je vyplní v jedné plynulé konverzaci.

Intercept — pojmenovaný moment v konverzaci, kde může běžet handler skriptu: silence, interruption, before/after tool call, slot filled, session start/end, webhook received. Industry packy dodávají rozumné výchozí hodnoty.

Outcome — k čemu se dokončená session vyhodnotila. Tři hodnoty: success (cíl dosažen), middle (reálná konverzace 30 sekund nebo více, ale bez cíle), spam (shoz pod 30 sekund nebo bez engagementu). Řídí fakturaci.

Commercial Intent Score — skóre 0–100, které platforma přiřadí každé session po hovoru a ukazuje, jak komerčně zainteresovaný volající působil. Užitečné pro prioritizaci follow-upu.

Integrace

Plugin — integrace s externím systémem: kalendář, rezervace, CRM, messengery, SMS, e-mail, web widget. Pluginy vystavují tools, které agent volá během session.

Plugin Type — druh integrace (Calendar, Booking, CRM, Messenger atd.). Každý plugin daného typu implementuje stejný kontrakt, takže poskytovatelé jsou vyměnitelní.

Tool Call — volání platform capability agentem během session. schedule_meeting, create_lead, send_sms. Každý tool call je zaznamenán ve stopě session s argumenty a výsledkem.

Knowledge base — indexovaný obsah, který agent používá k odpovědi na faktické otázky o vaší firmě. Zdroje: crawl webu a nahraná PDF.

Outbound

Outbound trigger — API request POST /v1/calls, který spustí jeden odchozí hovor.

Outbound batch — CSV nahraná sada kontaktů vytáčená kontrolovaným tempem pod jedním scénářem. Průběh dávky a počty per stav jsou dostupné přes API.

Idempotency Key — váš unikátní identifikátor pro state-changing API request. Opakování stejného klíče vrátí původní odpověď — bezpečné pro retry.

Webhooks a API

Webhook subscription — URL, na kterou POSTujeme, když se spustí zadaný event. Podepsané HMAC body requestu, retry s rostoucím backoffem.

Inbound webhook — pojmenovaná URL, na kterou vaše systémy mohou POSTovat, aby pushly event do aktivních session projektu, doručený jako intercept on_webhook_received.

API key — token, kterým váš kód mluví s API. Project-scoped, permission-scoped, odvolatelný. Při vytvoření se zobrazí jednou; at rest se hashuje.

Scope — operace, které API klíč smí provádět. outbound:trigger, sessions:read, webhooks:read.

Fakturace a usage

Wallet — předplacený zůstatek tenanta. Čerpá se poplatky za hovory, čas crawleru, chat tokeny a channel eventy.

Top-up — přesun peněz do peněženky, ručně nebo pravidlem auto top-upu.

Trial — bezplatné období, se kterým začíná každý nový tenant: 14 dní a až 200 konverzací, bez nutnosti karty. Testovací hovory se do něj nepočítají.

Tier — stack poskytovatelů, na kterém scénář běží: Economy / Standard / Premium / Enterprise. Nastavuje podkladové modely i cenu za hovor. Enterprise také zahrnuje enterprise podporu a SLA.

Overage — minuty hovoru nad výchozí 5minutový cap, když ho scénář zvedne. Účtují se per minuta sazbou tieru.

Sandbox — režim účtu pro vývoj, ve kterém se každý poplatek simuluje a je jasně označený. Peněženka se reálně nehýbe. Zapíná se na žádost.

Usage event — metered záznam (minuta hovoru, LLM tokeny, STT sekundy, TTS znaky, telefonní minuta, storage GB-hodina, API call, crawler sekunda). Používá se k výpočtu billingu a zobrazení usage reportů per project.

Bezpečnost a retence

Tenant isolation — architektonické pravidlo, že každý data řádek nese tenant id a každý query ho vynucuje. Zvenku to vypadá, jako by každý tenant měl vlastní kopii platformy.

DSAR — Data Subject Access Request. Právo volajícího vědět, jaká data o něm držíte, a požadovat smazání. Žádosti o smazání posílejte na privacy@aitelier.org a erasure dokončíme s potvrzením.

Retention — jak dlouho platforma drží vaše data. Nahrávky 30 dní; přepisy a session data po dobu života účtu; billing záznamy podle požadavků finanční compliance.