Príklady použitia · IT a vývoj

AI asistent pre IT, ktorý pozná vašu dokumentáciu

Runbook, integrácie aj konvencie vie asistent vytiahnuť aj o druhej v noci. Má pridelenú vašu technickú dokumentáciu, vlastné zadanie a svoj okruh ľudí. Nižšie je ukážkové nastavenie aj ukážky odpovedí.

  • Postup z runbooku počas incidentu
  • Odkaz na konkrétnu sekciu dokumentácie
  • Nový kolega sa nemusí pýtať seniora
  • Prístupové údaje doň vôbec nedávame
IT asistent v aplikácii vysvetľuje, ako je e-shop napojený na sklad a ako často sa synchronizujú zásoby.

Čo tento asistent rieši

Ako sú systémy prepojené

Čo je s čím integrované, ako často sa synchronizujú dáta, kde je diagram. Odpoveď z vašej dokumentácie namiesto hľadania naprieč nástrojmi.

Postup počas incidentu

Keď treba konať rýchlo, asistent vytiahne presný krok z runbooku. Aj cez víkend a aj keď je autor runbooku na dovolenke.

Onboarding nového vývojára

Nový človek sa pýta asistenta na konvencie, postupy a architektúru namiesto toho, aby pri každej otázke vyrušoval senior kolegu.

Dokumentácia, ktorú niekto používa

Dokumentácia prestane byť miestom, kam sa píše a nikdy nepozerá. Asistent z nej odpovedá, takže sa oplatí ju udržiavať aktuálnu.

Hotové výstupy

Okrem odpovedí vám asistent pripraví aj hotový súbor na stiahnutie z vašich dokumentov. Súčasť plánu Growth a vyššie.

IT a vývoj

HTML

Testovací checklist na nasadenie

„Z runbooku nasadenia priprav checklist so zaškrtávaním, záložkami podľa fázy a počítadlom hotových krokov.“

Runbook nasadenia. Zaškrtávanie a počítadlo priamo v stránke

Word

Príručka pre nového vývojára

„Z IT dokumentácie priprav príručku pre nového vývojára: systémy, integrácie a postup nasadenia.“

Dokumentácia integrácií, runbooky

Ukážkové nastavenie asistenta

Takto vyzerá IT asistent po nasadení. Rozsah dokumentov a čísla sú modelové, pri vás ich nastavíme podľa toho, čo reálne máte.

Zaindexované zdroje
Technická dokumentácia, runbooky pre nasadenie a incidenty, prehľad integrácií, architektonické rozhodnutia a on-call rozpis. Modelovo okolo 300 dokumentov.
Kto naň vidí
Vývoj, prevádzka a správa IT. Dokumenty s prístupovými údajmi doň nenahrávame vôbec, tie patria do správcu hesiel, nie do znalostnej bázy.
Aktualizácia zdrojov
Dokumentáciu udržiavate ako doteraz a asistent odpovedá z posledného nahratého znenia. Pri zmene runbooku nahráte novú verziu.

Zadanie si určujete vy

Asistent dostane zadanie: krátky text bežnou rečou, v ktorom určíte, ako sa má správať. Nič sa neprogramuje, len napíšete, čo od neho čakáte. Pri IT asistentovi doň patrí napríklad:

  • Z ktorej dokumentácie a z ktorých runbookov má čerpať
  • Aby pri každej odpovedi uviedol dokument a sekciu
  • Aby pri incidentoch uvádzal kroky v poradí a povedal, keď postup chýba
  • Aby nikdy neuvádzal prístupové údaje ani tajné kľúče

Nie je to pevný zoznam. Do zadania napíšete čokoľvek, čo má asistent dodržiavať, a kedykoľvek ho prepíšete. Prvé zadania píšeme s vami, ďalšie si upravujete sami.

Čo tento asistent nerobí

  • Nemá prístup do vašich systémov a nevykoná žiadny zásah.
  • Nevidí živé logy ani monitoring.
  • Neuchováva prístupové údaje, heslá ani kľúče.
  • Nenahrádza on-call službu. Ukáže postup, konať musí človek.

Ukážka odpovedí

Jedna otázka z bežného dňa a jedna z horšieho. Ilustračné ukážky, systémy aj názvy dokumentov sú modelové.

Ako je e-shop napojený na sklad a ako často sa synchronizujú zásoby?

E-shop číta zásoby zo skladu cez REST API každých 15 minút a objednávky posiela späť webhookom pri každej platbe. Diagram a detaily sú v dokumente „Integrácie“, sekcia E-shop a sklad.

Zdroj: Technická dokumentácia, Integrácie (E-shop a sklad)

Aký je postup pri nasadení novej verzie do produkcie a čo robiť pri výpadku?

Nasadenie beží cez CI/CD po schválení v pull requeste, rollback sa robí príkazom z runbooku, krok 4. Pri výpadku sa najprv overí stav služby a eskaluje sa podľa on-call rozpisu. Detaily sú v dokumente „Runbook“, časť Nasadenie a incidenty.

Zdroj: Runbook, časť Nasadenie a incidenty · On-call rozpis

Ako sme ho nastavili

  1. Zistili sme, čo je naozaj zdokumentované

    Pri analýze sa obvykle ukáže, že runbook existuje, len ho nikto nevie nájsť. Zmapovali sme, čo je aktuálne a čo treba doplniť.

  2. Pridelili sme dokumentáciu a runbooky

    Asistent dostal technickú zložku. Zadanie mu prikazuje uvádzať sekciu a priznať, keď postup v dokumentácii nie je.

  3. Vylúčili sme citlivé súbory

    Dokumenty s prístupovými údajmi do znalostnej bázy nepatria. Pri nasadení sme ich z indexu vynechali.

Pre koho je IT asistent

  • Malé IT tímy, kde postup pozná jeden človek
  • Vývojári počas nasadenia alebo incidentu
  • Noví kolegovia, ktorí sa učia architektúru
  • Firmy, ktoré dokumentáciu majú, ale nikto ju nečíta

Súčasť každého plánu

Znalostných asistentov si vytvárate neobmedzene vo všetkých plánoch, tento je jeden z nich. Plány sa líšia rozsahom používania, jazykovým modelom a úrovňou podpory, nie počtom asistentov. Prvých navrhneme a nastavíme za vás počas analýzy prínosu AI a pri nasadení, presnú ponuku dostanete po analýze.

Asistent odpovedá z vašej technickej dokumentácie a runbookov. Nemá prístup do vašich systémov, nevykonáva zásahy a nevidí živý monitoring. Odpoveď je podklad, konanie ostáva na vašich ľuďoch. Názvy a detaily v ukážkach sú modelové.

Ušetrite tímu hodiny práce každý deň

Pošlite nám základné informácie o vašej firme a oblasť, ktorú chcete zlepšiť. Termín online ukážky si vyberiete hneď po odoslaní, alebo sa vám ozveme e-mailom, zvyčajne do jedného pracovného dňa. Spoločne potom posúdime, kde vám AI prinesie najväčší prínos.