Domů Dokumentace AI CDESK MCP server Oblasti a příklady použití

Oblasti a příklady použití

Toto je přehled toho, co váš AI asistent dokáže s vaším CDESK: každý nástroj, který má, příklad, jak si ho vyžádat, a co můžete očekávat. V této beta verzi jich je 64, z toho 39 jen pro čtení a 26 zapisujících, a k tomu nástroj pro kontrolu stavu spojení – celkem 65 položek.

Aktuálně je dostupná beta verze. Vše, co je zde popsáno, funguje a každý zápis je skutečný zápis do vašeho živého systému CDESK – zatím však není pokryta každá část CDESK a další přibudou v budoucích vydáních – zatím nejsou součástí projekty, pracovní příkazy, schvalování, znalostní báze ani kalendář.

Příručka předpokládá, že CDESK MCP už máte připojený. Pokud ne, prohlédněte si část dokumentace Nastavení a provoz CDESK MCP.

Názvy nástrojů nikdy nezadáváte. Ptáte se vlastními slovy – „které tikety společnosti Alfa Ltd. jsou stále otevřené?“ – a asistent si vybere nástroje, které potřebuje. Názvy jsou v této příručce jen proto, abyste viděli, co existuje, a abyste je poznali v seznamu oprávnění své AI aplikace. Aplikace je zobrazují anglicky, proto je u každého nástroje uveden i jeho technický název.

Formulování otázek

Jednoduše popište, co chcete, vlastními slovy. Tři zvyky výrazně zlepší odpovědi:

Pojmenujte oblast, pokud ji znáte. „Co mám přiděleno v úkolech?“ ušetří asistentovi hádání mezi tikety a úkoly.
Uveďte období. „minulý měsíc“, „tento týden“, „od pondělí“. Některé oblasti mají standardní období, které nemusíte očekávat – evidovaná práce například standardně bere aktuální kalendářní měsíc.
Uveďte číslo záznamu, když s ním chcete něco udělat. Každá odpověď čísla uvádí; když jedno zopakujete, nejsou žádné pochybnosti o tom, který záznam myslíte.

Zápis údajů do CDESK

Každé vytvoření, změna, odstranění a změna stavu je skutečný zápis do vašeho CDESK, s vašimi oprávněními. Než se některý spustí, asistent s vámi projde hodnoty, které chce použít – povinné i nepovinné – a nic, co jste mu nedali, si nevymyslí. Počítejte s tím, že se vás zeptá i na pole, která byste ve webovém formuláři přeskočili.

U každého nástroje v tabulkách níže je uvedeno, zda z CDESK jen čte, nebo do něj zapisuje.

Požadavky

Hlavní oblast pro tikety: čtení, filtrování, vytváření, úpravy, odstraňování, změna stavu a čtení či přidávání příspěvků do diskuse – interně nebo viditelně pro zákazníka.

Nástroj	Technický název	Čte nebo zapisuje	Jak se na něj zeptat
Vypsat požadavky	`list_requests`	Čte	„Které požadavky společnosti Alfa Ltd. jsou stále otevřené a které jsou po termínu?“
Otevřít požadavek	`get_request`	Čte	„Otevři tiket 14302 a řekni mi, na co si zákazník vlastně stěžoval.“
Vlastní pole požadavků	`get_request_custom_fields`	Čte	„Jaká další pole mají naše požadavky kromě standardních?“
Seznamy hodnot požadavků	`get_request_enums`	Čte	„Jaké stavy a priority požadavků si mohu vybrat?“
Vytvořit požadavek	`create_request`	Zapisuje	„Vytvoř požadavek pro Alfa Ltd.: tiskárna ve 2. patře nebere papír, priorita vysoká.“
Upravit požadavek	`update_request`	Zapisuje	„Změň termín u 14302 na pátek a přiděl ho Petrovi.“
Odstranit požadavek	`delete_request`	Zapisuje	„Odstraň požadavek 14315, vznikl omylem.“
Změnit stav požadavku	`set_request_status`	Zapisuje	„Nastav 14302 na Vyřešeno.“
Vypsat diskusi k požadavku	`list_request_discussion`	Čte	„Zobraz mi celou diskusi k 14302, od nejstaršího příspěvku.“
Přidat příspěvek do diskuse	`post_request_discussion`	Zapisuje	„Přidej k 14302 příspěvek viditelný pro zákazníka, že jsme vyměnili fixační jednotku.“

Příspěvek do diskuse může být viditelný pro zákazníka, takže vždy řekněte, který chcete – interní, nebo viditelný pro zákazníka.

Katalog požadavků

Definice katalogu, který stojí za typy vašich požadavků – formuláře, na kterých lze požadavek založit.

Nástroj	Technický název	Čte nebo zapisuje	Jak se na něj zeptat
Vypsat katalogy požadavků	`list_request_catalogs`	Čte	„Které katalogy požadavků jsou dostupné pro Alfa Ltd.?“
Otevřít katalog požadavků	`get_request_catalog`	Čte	„Jaká pole vyžaduje katalog ‚Porucha hardwaru‘?“
Seznamy hodnot katalogů	`get_request_catalog_enums`	Čte	„Jaké typy katalogů a oblasti si mohu vybrat?“
Vytvořit katalog požadavků	`create_request_catalog`	Zapisuje	„Vytvoř katalog požadavků ‚Problémy s tiskárnou‘ pro oblast IT.“
Upravit katalog požadavků	`update_request_catalog`	Zapisuje	„Přejmenuj katalog ‚Porucha hardwaru‘ na ‚Chyba hardwaru‘.“
Odstranit katalog požadavků	`delete_request_catalog`	Zapisuje	„Odstraň katalog ‚Starý formulář‘, už ho nikdo nepoužívá.“

Úkoly

Interní pracovní položky: čtení, vytváření, úpravy, odstraňování, změna stavu a správa pozorovatelů.

Nástroj	Technický název	Čte nebo zapisuje	Jak se na něj zeptat
Vypsat úkoly	`list_tasks`	Čte	„Které úkoly mám na tento týden přidělené a které jsou po termínu?“
Otevřít úkol	`get_task`	Čte	„Otevři úkol 8871 – co přesně je třeba udělat a do kdy?“
Seznamy hodnot úkolů	`get_task_enums`	Čte	„Jaké stavy a typy úkolů si mohu vybrat?“
Vytvořit úkol	`create_task`	Zapisuje	„Vytvoř úkol pro Petra, ať zkontroluje tiskárnu na pobočce, termín pátek.“
Upravit úkol	`update_task`	Zapisuje	„Posuň termín úkolu 8871 na nejbližší pondělí a přidej poznámku o náhradním dílu.“
Odstranit úkol	`delete_task`	Zapisuje	„Odstraň úkol 8899, duplikuje 8871.“
Změnit stav úkolu	`set_task_status`	Zapisuje	„Označ úkol 8871 jako hotový.“
Přidat pozorovatele úkolu	`add_task_watchers`	Zapisuje	„Přidej Annu jako pozorovatelku úkolu 8871, aby dostávala aktualizace.“
Odebrat pozorovatele úkolu	`remove_task_watchers`	Zapisuje	„Odeber mě z pozorovatelů úkolu 8871.“

Společnosti

Záznamy společností: výpisy, filtrování, otevření jedné, přehled vlastních polí, která si k nim vedete, a hledání společnosti podle názvu, když si ho pamatujete jen přibližně.

Nástroj	Technický název	Čte nebo zapisuje	Jak se na něj zeptat
Vypsat společnosti	`list_customers`	Čte	„Vypiš společnosti, které máme v Bratislavě.“
Otevřít společnost	`get_customer`	Čte	„Otevři Alfa Ltd. – kdo je kontaktní osoba a jaká je jejich adresa?“
Vlastní pole společností	`get_customer_custom_fields`	Čte	„Jaká vlastní pole si vedeme u záznamů společností?“
Najít společnost podle názvu	`find_customer_by_name`	Čte	„Najdi společnost, která se jmenuje nějak jako ‚Alfa Trading‘.“
Vytvořit společnost	`create_customer`	Zapisuje	„Přidej novou společnost: Beta Ltd., kontaktní osoba John Smith.“
Upravit společnost	`update_customer`	Zapisuje	„Změň telefonní číslo společnosti Alfa Ltd. na 02 1234 5678.“
Odstranit společnost	`delete_customer`	Zapisuje	„Odstraň společnost ‚Test Company‘, byla jen na testování.“

Uživatelé

Uživatelské účty v CDESK: výpisy, filtrování, otevření jednoho, hledání osoby podle jména nebo e-mailu a vytváření, úpravy či odstraňování účtů tam, kde to vaše práva dovolují.

Nástroj	Technický název	Čte nebo zapisuje	Jak se na něj zeptat
Vypsat uživatele	`list_users`	Čte	„Kdo je ve skupině podpory?“
Otevřít uživatele	`get_user`	Čte	„Jaké má Petr telefonní číslo a ve kterých skupinách je?“
Vlastní pole uživatelů	`get_user_custom_fields`	Čte	„Jaká vlastní pole mají naše uživatelské účty?“
Najít uživatele	`find_user`	Čte	„Najdi uživatele s e-mailem john.smith@alfa.example.“
Vytvořit uživatele	`create_user`	Zapisuje	„Vytvoř účet pro naši novou kolegyni Janu Novou, do skupiny podpory.“
Upravit uživatele	`update_user`	Zapisuje	„Změň Petrovi telefonní číslo a přesuň ho do skupiny druhé linie.“
Odstranit uživatele	`delete_user`	Zapisuje	„Odstraň účet kolegy, který odešel minulý měsíc.“

Plnění (evidovaná práce)

Jednotky evidované práce – trvání a popis – zapsané ke společnosti, zakázce, požadavku, pracovnímu příkazu, úkolu, smlouvě k projektu nebo k záznamu o volnu.

Nástroj	Technický název	Čte nebo zapisuje	Jak se na něj zeptat
Vypsat plnění	`list_fills`	Čte	„Jakou práci jsem evidoval minulý týden, den po dni?“
Otevřít plnění	`get_fill`	Čte	„Otevři plnění 5512 – jak dlouho trvalo a co je v popisu?“
Seznamy hodnot plnění	`get_fill_enums`	Čte	„Jaké druhy evidované práce si mohu vybrat?“
Vytvořit plnění	`create_fill`	Zapisuje	„Zapiš dvě hodiny na požadavek 14302: výměna fixační jednotky, u zákazníka.“
Upravit plnění	`update_fill`	Zapisuje	„Oprav včerejší zápis u 14302 ze dvou hodin na tři.“
Odstranit plnění	`delete_fill`	Zapisuje	„Odstraň plnění 5512, zapsal jsem ho na nesprávný tiket.“

Tři věci, o kterých je dobré vědět. Výpis se standardně vztahuje na aktuální kalendářní měsíc, pokud neuvedete jiné období. Již vyfakturovanou práci nelze změnit – CDESK to zablokuje a oznámí vám to. A práci si můžete evidovat i k pracovnímu příkazu nebo smlouvě k projektu, i když tyto oblasti zatím pokryté nejsou

jen musíte číslo záznamu z CDESK zadat sami, protože asistent vám ho neumí vyhledat.

Zakázky

Obchodní zakázky: čtení, filtrování, vytváření, úpravy, odstraňování – a k tomu stavy, fáze a typy kategorií zakázek z vašeho CDESK.

Nástroj	Technický název	Čte nebo zapisuje	Jak se na něj zeptat
Vypsat zakázky	`list_deals`	Čte	„Které zakázky společnosti Alfa Ltd. jsou stále otevřené a v jaké fázi jsou?“
Otevřít zakázku	`get_deal`	Čte	„Otevři zakázku 3120 – jaký je dohodnutý rozsah a kdo ji má na starosti?“
Seznamy hodnot zakázek	`get_deal_enums`	Čte	„Jaké stavy a fáze zakázek používáme?“
Vytvořit zakázku	`create_deal`	Zapisuje	„Vytvoř zakázku ‚Obnova serverů 2027′ pro Alfa Ltd. a nastav ji na přijatou.“
Upravit zakázku	`update_deal`	Zapisuje	„Posuň zakázku 3120 do další fáze a změň odpovědnou osobu na Petra.“
Odstranit zakázku	`delete_deal`	Zapisuje	„Odstraň zakázku 3125, byla zadána dvakrát.“

„Otevřená“ zde znamená totéž co v CDESK – přijatá, v řešení nebo předaná, zatímco odmítnutá a ukončená se počítají za uzavřené. K zakázce lze evidovat práci (kapitola Plnění), takže funguje i „kolik práce jsme na této zakázce evidovali?“

CMDB (konfigurační databáze)

Konfigurační položky a struktura kolem nich – kategorie, hlavní skupiny, typy a jejich vlastnosti.

Nástroj	Technický název	Čte nebo zapisuje	Jak se na něj zeptat
Vypsat konfigurační položky	`list_configuration_items`	Čte	„Které konfigurační položky má Alfa Ltd. a které z nich jsou servery?“
Otevřít konfigurační položku	`get_configuration_item`	Čte	„Otevři CI 4471 – jakého je typu a jaké má vlastnosti?“
Seznamy hodnot CI	`get_ci_enums`	Čte	„Jaké stavy a kategorie může konfigurační položka mít?“
Vypsat kategorie CMDB	`list_cmdb_categories`	Čte	„Jaké kategorie CMDB máme?“
Vypsat hlavní skupiny CMDB	`list_cmdb_maingroups`	Čte	„Jaké hlavní skupiny jsou v CMDB?“
Otevřít hlavní skupinu CMDB	`get_cmdb_maingroup`	Čte	„Otevři hlavní skupinu ‚Síťová zařízení‘ – co do ní patří?“
Vypsat typy CMDB	`list_cmdb_types`	Čte	„Jaké typy CMDB existují pod ‚Síťovými zařízeními‘?“
Otevřít typ CMDB	`get_cmdb_type`	Čte	„Otevři typ ‚Switch‘ – k čemu se používá?“
Vlastnosti typu CMDB	`get_cmdb_type_properties`	Čte	„Jaké vlastnosti má typ ‚Switch‘?“

Tato oblast je jen pro čtení. Asistent nedokáže konfigurační položku vytvořit, změnit ani odstranit – to udělejte v CDESK.

Nástroje pro ověřování faktů

Dva nástroje, o které si nikdy nežádáte jménem. Jeden shromáždí záznamy, které stojí za faktickou otázkou; druhý ještě předtím, než odpověď uvidíte, znovu porovná každou citaci se skutečným záznamem. Fungují v požadavcích, úkolech, společnostech, uživatelích a evidované práci.

Nástroj	Technický název	Čte nebo zapisuje	Co je spustí
Shromáždit záznamy	`collect_records`	Čte	„Hlásil někdo za poslední měsíc problémy s VPN?“ – tento nástroj shromáždí všechny odpovídající záznamy
Ověřit tvrzení	`verify_claims`	Čte	tatáž otázka – tento nástroj znovu přečte každý záznam a zahodí každou citaci, která v něm skutečně není

Díky tomu je každá věta, kterou u faktické otázky dostanete, citátem ze skutečného záznamu, a to i s jeho číslem. Pokud nic neodpovídá, dozvíte se to – nedostanete dohad.