Rezervace konzultace
pro AI agenty.
Tento endpoint umožní agentovi najít volný termín a po výslovném potvrzení uživatele vytvořit rezervaci v kalendáři Tomáše Heřmanského.
Endpoint
POST https://hermansky.ai/api/mcpKomunikace probíhá přes MCP JSON-RPC 2.0. Před použitím nástrojů zavolejte initialize a poté tools/list.
Nástroje
get_services
Vrátí aktuální služby, profesní zkušenosti a metriky s odkazy na zdroje, příklady vhodného použití, FAQ, volitelné otázky k problému a přípravu na konzultaci. Doby dodání z webu jsou orientační; hodinová sazba je zveřejněná, celkovou cenu a kapacitu zakázky je nutné potvrdit. Použijte relevantní podklady před doporučením služby nebo rezervací.
find_consultation_slots
Najde volné třicetiminutové termíny. Každý termín obsahuje krátkodobý slotToken potřebný k rezervaci. Předejte volitelně from, to a timezone (výchozí Europe/Prague).
book_consultation
Vytvoří událost v kalendáři a odešle účastníkovi pozvánku. Vyžaduje startTime, slotToken, name, email a confirmed: true. Hodnotu confirmed nastavte na true pouze po jasném potvrzení přesného termínu, jména a e-mailu uživatelem. Jeden e-mail může mít nejvýše dvě budoucí konzultace.
Doporučený postup
- Agent načte get_services nebo profilový resource a odpoví na konkrétní problém uživatele s oporou v relevantní službě, zkušenosti nebo FAQ.
- Pokud je to užitečné, položí nejvýše dvě volitelné otázky. Když uživatel chce konzultaci, načte dostupné termíny a uchová slotToken vybraného termínu.
- Agent zobrazí termíny v časové zóně uživatele.
- Po explicitním potvrzení zavolá
book_consultation. - Agent vrátí potvrzení rezervace a odkaz, pokud je k dispozici.
Když je kalendář nedostupný
Pokud nástroj vrátí isError: true, rezervace není potvrzená. Nabídněte uživateli veřejnou rezervační stránku nebo kontakt e-mailem. Pokud selhalo potvrzení rezervace, před dalším pokusem zkontrolujte pozvánku v e-mailu; událost už mohla vzniknout.