Toto je prehľad toho, čo váš AI asistent dokáže s vaším CDESK: každý nástroj, ktorý má, príklad, ako si ho vyžiadať, a čo môžete očakávať. V tejto beta verzii ich je 64, z toho 39 len na čítanie a 26 zapisujúcich, a k tomu nástroj na kontrolu stavu spojenia – spolu 65 položiek.
Aktuálne je dostupná beta verzia. Všetko, čo je tu opísané, funguje a každý zápis je skutočný zápis do vášho živého systému CDESK – zatiaľ však nie je pokrytá každá časť CDESK a ďalšie pribudnú v budúcich vydaniach – zatiaľ nie sú súčasťou projekty, pracovné príkazy, schvaľovanie, znalostná báza ani kalendár.
Príručka predpokladá, že CDESK MCP už máte pripojený. Ak nie, pozrite si časť dokumentácie Nastavenie a prevádzka CDESK MCP.
Názvy nástrojov nikdy nezadávate. Pýtate sa vlastnými slovami – „ktoré tikety spoločnosti Alfa Ltd. sú stále otvorené?“ – a asistent si vyberie nástroje, ktoré potrebuje. Názvy sú v tejto príručke len preto, aby ste videli, čo existuje, a aby ste ich spoznali v zozname oprávnení svojej AI aplikácie. Aplikácie ich zobrazujú po anglicky, preto je pri každom nástroji uvedený aj jeho technický názov.
Formulovanie otázok
Jednoducho opíšte, čo chcete, vlastnými slovami. Tri zvyky výrazne zlepšia odpovede:
- Pomenujte oblasť, ak ju poznáte. „Čo mám pridelené v úlohách?“ ušetrí asistentovi hádanie medzi tiketmi a úlohami.
- Uveďte obdobie. „minulý mesiac“, „tento týždeň“, „od pondelka“. Niektoré oblasti majú štandardné obdobie, ktoré nemusíte očakávať – evidovaná práca napríklad štandardne berie aktuálny kalendárny mesiac.
- Uveďte číslo záznamu, keď s ním chcete niečo urobiť. Každá odpoveď čísla uvádza; keď jedno zopakujete, nie sú žiadne pochybnosti o tom, ktorý záznam myslíte.
Zápis údajov do CDESK
Každé vytvorenie, zmena, odstránenie a zmena stavu je skutočný zápis do vášho CDESK, s vašimi oprávneniami. Než sa niektorý spustí, asistent s vami prejde hodnoty, ktoré chce použiť – povinné aj nepovinné – a nič, čo ste mu nedali, si nevymyslí. Počítajte s tým, že sa vás spýta aj na polia, ktoré by ste vo webovom formulári preskočili.
Pri každom nástroji v tabuľkách nižšie je uvedené, či z CDESK len číta, alebo doň zapisuje.
Požiadavky
Hlavná oblasť pre tikety: čítanie, filtrovanie, vytváranie, úpravy, odstraňovanie, zmena stavu a čítanie či pridávanie príspevkov do diskusie – interne alebo viditeľne pre zákazníka.
| Nástroj | Technický názov | Číta alebo zapisuje | Ako sa naň opýtať |
|---|---|---|---|
| Vypísať požiadavky | list_requests | Číta | „Ktoré požiadavky spoločnosti Alfa Ltd. sú stále otvorené a ktoré sú po termíne?“ |
| Otvoriť požiadavku | get_request | Číta | „Otvor tiket 14302 a povedz mi, na čo sa zákazník vlastne sťažoval.“ |
| Vlastné polia požiadaviek | get_request_custom_fields | Číta | „Aké ďalšie polia majú naše požiadavky okrem štandardných?“ |
| Zoznamy hodnôt požiadaviek | get_request_enums | Číta | „Aké stavy a priority požiadaviek si môžem vybrať?“ |
| Vytvoriť požiadavku | create_request | Zapisuje | „Vytvor požiadavku pre Alfa Ltd.: tlačiareň na 2. poschodí neberie papier, priorita vysoká.“ |
| Upraviť požiadavku | update_request | Zapisuje | „Zmeň termín na 14302 na piatok a prideľ ju Petrovi.“ |
| Odstrániť požiadavku | delete_request | Zapisuje | „Odstráň požiadavku 14315, vznikla omylom.“ |
| Zmeniť stav požiadavky | set_request_status | Zapisuje | „Nastav 14302 na Vyriešené.“ |
| Vypísať diskusiu k požiadavke | list_request_discussion | Číta | „Zobraz mi celú diskusiu k 14302, od najstaršieho príspevku.“ |
| Pridať príspevok do diskusie | post_request_discussion | Zapisuje | „Pridaj k 14302 príspevok viditeľný pre zákazníka, že sme vymenili fixačnú jednotku.“ |
Príspevok do diskusie môže byť viditeľný pre zákazníka, takže vždy povedzte, ktorý chcete – interný, alebo viditeľný pre zákazníka.
Katalóg požiadaviek
Definícia katalógu, ktorý stoja za typmi vašich požiadaviek – formuláre, na ktorých sa požiadavka dá založiť.
| Nástroj | Technický názov | Číta alebo zapisuje | Ako sa naň opýtať |
|---|---|---|---|
| Vypísať katalógy požiadaviek | list_request_catalogs | Číta | „Ktoré katalógy požiadaviek sú dostupné pre Alfa Ltd.?“ |
| Otvoriť katalóg požiadaviek | get_request_catalog | Číta | „Aké polia vyžaduje katalóg ‚Porucha hardvéru‘?“ |
| Zoznamy hodnôt katalógov | get_request_catalog_enums | Číta | „Aké typy katalógov a oblasti si môžem vybrať?“ |
| Vytvoriť katalóg požiadaviek | create_request_catalog | Zapisuje | „Vytvor katalóg požiadaviek ‚Problémy s tlačiarňou‘ pre oblasť IT.“ |
| Upraviť katalóg požiadaviek | update_request_catalog | Zapisuje | „Premenuj katalóg ‚Porucha hardvéru‘ na ‚Chyba hardvéru‘.“ |
| Odstrániť katalóg požiadaviek | delete_request_catalog | Zapisuje | „Odstráň katalóg ‚Starý formulár‘, už ho nikto nepoužíva.“ |
Úlohy
Interné pracovné položky: čítanie, vytváranie, úpravy, odstraňovanie, zmena stavu a správa pozorovateľov.
| Nástroj | Technický názov | Číta alebo zapisuje | Ako sa naň opýtať |
|---|---|---|---|
| Vypísať úlohy | list_tasks | Číta | „Ktoré úlohy mám na tento týždeň pridelené a ktoré sú po termíne?“ |
| Otvoriť úlohu | get_task | Číta | „Otvor úlohu 8871 – čo presne treba urobiť a dokedy?“ |
| Zoznamy hodnôt úloh | get_task_enums | Číta | „Aké stavy a typy úloh si môžem vybrať?“ |
| Vytvoriť úlohu | create_task | Zapisuje | „Vytvor úlohu pre Petra, nech skontroluje tlačiareň na pobočke, termín piatok.“ |
| Upraviť úlohu | update_task | Zapisuje | „Posuň termín úlohy 8871 na najbližší pondelok a pridaj poznámku o náhradnom diele.“ |
| Odstrániť úlohu | delete_task | Zapisuje | „Odstráň úlohu 8899, duplikuje 8871.“ |
| Zmeniť stav úlohy | set_task_status | Zapisuje | „Označ úlohu 8871 ako hotovú.“ |
| Pridať pozorovateľov úlohy | add_task_watchers | Zapisuje | „Pridaj Annu ako pozorovateľku úlohy 8871, aby dostávala aktualizácie.“ |
| Odobrať pozorovateľov úlohy | remove_task_watchers | Zapisuje | „Odober ma z pozorovateľov úlohy 8871.“ |
Spoločnosti
Záznamy spoločností: výpisy, filtrovanie, otvorenie jednej, prehľad vlastných polí, ktoré si k nim vediete, a hľadanie spoločnosti podľa názvu, keď si ho pamätáte len približne.
| Nástroj | Technický názov | Číta alebo zapisuje | Ako sa naň opýtať |
|---|---|---|---|
| Vypísať spoločnosti | list_customers | Číta | „Vypíš spoločnosti, ktoré máme v Bratislave.“ |
| Otvoriť spoločnosť | get_customer | Číta | „Otvor Alfa Ltd. – kto je kontaktná osoba a aká je ich adresa?“ |
| Vlastné polia spoločností | get_customer_custom_fields | Číta | „Aké vlastné polia si vedieme k záznamom spoločností?“ |
| Nájsť spoločnosť podľa názvu | find_customer_by_name | Číta | „Nájdi spoločnosť, ktorá sa volá niečo ako ‚Alfa Trading‘.“ |
| Vytvoriť spoločnosť | create_customer | Zapisuje | „Pridaj novú spoločnosť: Beta Ltd., kontaktná osoba John Smith.“ |
| Upraviť spoločnosť | update_customer | Zapisuje | „Zmeň telefónne číslo spoločnosti Alfa Ltd. na 02 1234 5678.“ |
| Odstrániť spoločnosť | delete_customer | Zapisuje | „Odstráň spoločnosť ‚Test Company‘, bola len na testovanie.“ |
Používatelia
Používateľské kontá v CDESK: výpisy, filtrovanie, otvorenie jedného, hľadanie osoby podľa mena alebo e-mailu a vytváranie, úpravy či odstraňovanie kont tam, kde to vaše práva dovoľujú.
| Nástroj | Technický názov | Číta alebo zapisuje | Ako sa naň opýtať |
|---|---|---|---|
| Vypísať používateľov | list_users | Číta | „Kto je v skupine podpory?“ |
| Otvoriť používateľa | get_user | Číta | „Aké má Peter telefónne číslo a v ktorých skupinách je?“ |
| Vlastné polia používateľov | get_user_custom_fields | Číta | „Aké vlastné polia majú naše používateľské kontá?“ |
| Nájsť používateľa | find_user | Číta | „Nájdi používateľa s e-mailom john.smith@alfa.example.“ |
| Vytvoriť používateľa | create_user | Zapisuje | „Vytvor konto pre našu novú kolegyňu Janu Novú, do skupiny podpory.“ |
| Upraviť používateľa | update_user | Zapisuje | „Zmeň Petrovi telefónne číslo a presuň ho do skupiny druhej línie.“ |
| Odstrániť používateľa | delete_user | Zapisuje | „Odstráň konto kolegu, ktorý odišiel minulý mesiac.“ |
Plnenia (evidovaná práca)
Jednotky evidovanej práce – trvanie a opis – zapísané k spoločnosti, zákazke, požiadavke, pracovnému príkazu, úlohe, zmluve k projektu alebo k záznamu o voľne.
| Nástroj | Technický názov | Číta alebo zapisuje | Ako sa naň opýtať |
|---|---|---|---|
| Vypísať plnenia | list_fills | Číta | „Akú prácu som evidoval minulý týždeň, deň po dni?“ |
| Otvoriť plnenie | get_fill | Číta | „Otvor plnenie 5512 – ako dlho trvalo a čo je v opise?“ |
| Zoznamy hodnôt plnení | get_fill_enums | Číta | „Aké druhy evidovanej práce si môžem vybrať?“ |
| Vytvoriť plnenie | create_fill | Zapisuje | „Zapíš dve hodiny na požiadavku 14302: výmena fixačnej jednotky, u zákazníka.“ |
| Upraviť plnenie | update_fill | Zapisuje | „Oprav včerajší zápis na 14302 z dvoch hodín na tri.“ |
| Odstrániť plnenie | delete_fill | Zapisuje | „Odstráň plnenie 5512, zapísal som ho na nesprávny tiket.“ |
Tri veci, o ktorých je dobré vedieť. Výpis sa štandardne vzťahuje na aktuálny kalendárny mesiac, ak neuvediete iné obdobie. Už vyfakturovanú prácu nemožno zmeniť – CDESK to zablokuje a oznámi vám to. A prácu si môžete evidovať aj k pracovnému príkazu alebo zmluve k projektu, hoci tieto oblasti zatiaľ pokryté nie sú
- len musíte číslo záznamu z CDESK zadať sami, pretože asistent vám ho nevie vyhľadať.
Zákazky
Obchodné zákazky: čítanie, filtrovanie, vytváranie, úpravy, odstraňovanie – a k tomu stavy, fázy a typy kategórií zákaziek z vášho CDESK.
| Nástroj | Technický názov | Číta alebo zapisuje | Ako sa naň opýtať |
|---|---|---|---|
| Vypísať zákazky | list_deals | Číta | „Ktoré zákazky spoločnosti Alfa Ltd. sú stále otvorené a v akej fáze sú?“ |
| Otvoriť zákazku | get_deal | Číta | „Otvor zákazku 3120 – aký je dohodnutý rozsah a kto ju má na starosti?“ |
| Zoznamy hodnôt zákaziek | get_deal_enums | Číta | „Aké stavy a fázy zákaziek používame?“ |
| Vytvoriť zákazku | create_deal | Zapisuje | „Vytvor zákazku ‚Obnova serverov 2027′ pre Alfa Ltd. a nastav ju na prijatú.“ |
| Upraviť zákazku | update_deal | Zapisuje | „Posuň zákazku 3120 do ďalšej fázy a zmeň zodpovednú osobu na Petra.“ |
| Odstrániť zákazku | delete_deal | Zapisuje | „Odstráň zákazku 3125, bola zadaná dvakrát.“ |
„Otvorená“ tu znamená to isté ako v CDESK – prijatá, v riešení alebo odovzdaná, kým odmietnutá a ukončená sa počítajú za zatvorené. K zákazke sa dá evidovať práca (kapitola Plnenia), takže funguje aj „koľko práce sme na tejto zákazke evidovali?“
CMDB (konfiguračná databáza)
Konfiguračné položky a štruktúra okolo nich – kategórie, hlavné skupiny, typy a ich vlastnosti.
| Nástroj | Technický názov | Číta alebo zapisuje | Ako sa naň opýtať |
|---|---|---|---|
| Vypísať konfiguračné položky | list_configuration_items | Číta | „Ktoré konfiguračné položky má Alfa Ltd. a ktoré z nich sú servery?“ |
| Otvoriť konfiguračnú položku | get_configuration_item | Číta | „Otvor CI 4471 – akého je typu a aké má vlastnosti?“ |
| Zoznamy hodnôt CI | get_ci_enums | Číta | „Aké stavy a kategórie môže konfiguračná položka mať?“ |
| Vypísať kategórie CMDB | list_cmdb_categories | Číta | „Aké kategórie CMDB máme?“ |
| Vypísať hlavné skupiny CMDB | list_cmdb_maingroups | Číta | „Aké hlavné skupiny sú v CMDB?“ |
| Otvoriť hlavnú skupinu CMDB | get_cmdb_maingroup | Číta | „Otvor hlavnú skupinu ‚Sieťové zariadenia‘ – čo do nej patrí?“ |
| Vypísať typy CMDB | list_cmdb_types | Číta | „Aké typy CMDB existujú pod ‚Sieťovými zariadeniami‘?“ |
| Otvoriť typ CMDB | get_cmdb_type | Číta | „Otvor typ ‚Switch‘ – na čo sa používa?“ |
| Vlastnosti typu CMDB | get_cmdb_type_properties | Číta | „Aké vlastnosti má typ ‚Switch‘?“ |
Táto oblasť je len na čítanie. Asistent nedokáže konfiguračnú položku vytvoriť, zmeniť ani odstrániť – to urobte v CDESK.
Nástroje na overovanie faktov
Dva nástroje, o ktoré si nikdy nežiadate menom. Jeden zhromaždí záznamy, ktoré stoja za faktickou otázkou; druhý ešte pred tým, než odpoveď uvidíte, znovu porovná každú citáciu so skutočným záznamom. Fungujú v požiadavkách, úlohách, spoločnostiach, používateľoch a evidovanej práci.
| Nástroj | Technický názov | Číta alebo zapisuje | Čo ich spustí |
|---|---|---|---|
| Zhromaždiť záznamy | collect_records | Číta | „Hlásil niekto za posledný mesiac problémy s VPN?“ – tento nástroj zhromaždí všetky zodpovedajúce záznamy |
| Overiť tvrdenia | verify_claims | Číta | tá istá otázka – tento nástroj znovu prečíta každý záznam a zahodí každú citáciu, ktorá v ňom naozaj nie je |
Vďaka tomu je každá veta, ktorú pri faktickej otázke dostanete, citátom zo skutočného záznamu, a to aj s jeho číslom. Ak nič nezodpovedá, dozviete sa to – nedostanete dohad.
Kontrola stavu pripojenia
| Nástroj | Technický názov | Číta alebo zapisuje | Ako sa naň opýtať |
|---|---|---|---|
| Informácie o serveri | server_info | Číta | „Vypýtaj si od CDESK informácie o serveri.“ |
Tento nástroj poznáte z inštalačných príručiek: keď spojenie funguje, odpovie status: ready. Užitočný po aktualizácii alebo keď sa niečo javí nesprávne.