AI OPS / PRŮVODCE PRO LAIKY

Ilustrační návod · neprodukční stránka

Řekněte, čeho chcete dosáhnout.

Nemusíte znát technický postup. Popište výsledek, zkontrolujte rozsah úlohy a sledujte ověřený stav na jednom místě.

Jak napsat dobré zadání

O TÉTO STRÁNCE

aiops-pruvodce-20261111

Průvodce zadáváním úloh AI Ops pro laika vysvětluje, jak úlohu srozumitelně zadat a jak číst její stav. Je to statický ilustrační návod, nikoli živý dashboard. Stránka žádnou úlohu nespouští a neukazuje průběh skutečné instalace.

01 / ZAČNĚTE VÝSLEDKEM

Popište, co má být na konci hotové

Pište běžnými slovy. Uveďte, komu má výsledek sloužit, co má umět a podle čeho poznáte, že je správně. Technické kroky může navrhnout AI Ops.

Do zadání patří

  • Výsledek: co chcete získat nebo změnit.
  • Rozsah: čeho se práce týká a co má zůstat beze změny.
  • Omezení: například neprodukční prostředí a dohodnutý rozpočet.
  • Ověření: jak se pozná, že výsledek splňuje zadání.

VZOR ZADÁNÍ

„Připrav český návod pro začátečníka.“

Má vysvětlit zadání a sledování úlohy. Musí být čitelný na mobilu, bez formulářů a bez připojení k produkci. Hotovo bude, až půjde otevřít stránku a projít všechny její kapitoly.

Do zadání nevkládejte hesla, přístupové klíče ani jiné tajné údaje.

02 / JEDNO SROZUMITELNÉ SCHVÁLENÍ

Schvalujte celou podporovanou úlohu

Před schválením má být jasné, co se udělá, kde, s jakými limity a jak se ověří výsledek. U podporované instalace může jedno schválení zahrnout přípravu zdrojů, závislosti, instalaci i závěrečné ověření.

  1. Přečtěte si rozsah. Musí odpovídat vašemu zadání a podporovanému postupu.
  2. Schvalte popsaný celek. Stejné nezměněné kroky nemají vyžadovat opakované „pokračuj“.
  3. Změnu rozsahu posuďte zvlášť. Destruktivní zásahy, změny přístupových práv a náklady mimo schválený rámec vyžadují samostatné rozhodnutí.

Schválení má své hranice

Souhlas s úlohou sám nezapíná oprávnění ani nepovoluje nepodporované prostředí. Dokončená příprava zdrojů nebo kontrola CI ještě neznamená provedenou instalaci či nasazení do produkce.

03 / ČTĚTE DŮKAZY, NE DOJMY

Kde hledat stav a co znamená

V projektu hledejte jediný souhrnný komentář AIOPS_CURRENT_STATE v úloze č. 68. Zkontrolujte čas aktualizace a údaj valid_until. Prošlý nebo neúplný údaj znamená, že aktuální stav není známý.

ČEKÁNÍ

Další krok ještě nezačal

Úloha může čekat na schválení, závislost nebo dostupný běh. Hledejte uvedený důvod a případný konkrétní požadavek na vás.

Co udělat: reagovat na jasný požadavek; neposílat úlohu znovu jen kvůli čekání.

BĚH

Existuje aktivní krok

Označení RUNNING musí mít oporu ve skutečně aktivním kroku Codex v Actions. Úspěšná kontrola koordinátoru sama o sobě běh Codexu nedokládá.

Co udělat: sledovat odkaz na konkrétní běh uvedený v souhrnu projektu.

DOKONČENO

Výsledek je ověřený

Souhrn má uvádět, co je skutečně hotové, a doklad ověření. Dokončení jednoho kroku nemusí znamenat splnění celé úlohy.

Co udělat: porovnat doložený výsledek s původním zadáním.

Tyto karty jsou vysvětlení pojmů. Nezobrazují aktuální stav žádné úlohy.

04 / KDYŽ SE NĚCO NEPOVEDE

Nejdřív zjistěte, co opravdu selhalo

Čekání na schválení nebo běh, ve kterém nezačala žádná testovací úloha, samo o sobě není neúspěšný test. Skutečná chyba má konkrétní selhaný krok a vysvětlení, co se nepodařilo.

  1. Najděte důkaz. Podívejte se na označený krok a jeho chybovou zprávu.
  2. Popište rozdíl. Napište, co jste očekávali a co se skutečně stalo. Přidejte označení úlohy a čas pozorování.
  3. Sdílejte jen potřebné údaje. Odkaz na konkrétní běh předejte v původní projektové úloze; tajné údaje z výpisů vynechte.
  4. Vyžádejte si cílenou opravu. Před opakováním nejasně dokončené operace ověřte, zda už neměla účinek nebo nezpůsobila náklad.
Jak může vypadat užitečné hlášení

„V úloze jsem očekával ověřenou stránku. Souhrn uvádí chybu při kontrole odkazů. Přikládám označení selhaného běhu a čas pozorování. Prosím o ověření příčiny a opravu v původním rozsahu.“

Krátký tahák před odesláním

Výsledek → rozsah → schválení → ověřený stav. Pokud některý bod není jasný, pojmenujte konkrétní nejasnost v původní úloze. Nevytvářejte duplicitní požadavky jen proto, že zatím nevidíte nový výsledek.

Vrátit se k přípravě zadání ↑