Navigačné a administratívne stránky¶
Táto referencia pokrýva hlavné navigačné, koordinačné a administratívne stránky. Väčšina detailov globálnych Settings je zámerne vynechaná, okrem správania šablón promptov zdieľaného s tenant settings. Použite ju vtedy, keď chcete rýchlo pochopiť stránky, ktoré vás vedú do správneho pracovného priestoru alebo ukazujú prevádzkový kontext, nie priamo tvorbu artefaktov. Je to dôležité preto, že práve tieto stránky určujú, kam sa v produkte presuniete, kto má prístup a kde skontrolujete AI usage alebo tenant stav. Potrebujete len bežný prístup do aplikácie a ide o krátke referenčné čítanie.
Pomocník a obnovenie stránky¶
Hlavička stránky používa jednotné kompaktné ovládacie prvky pre pomocníka (i v krúžku) a obnovenie (kruhová šípka), ak sú dostupné. Ich ikony si zachovávajú rovnaké proporcie v svetlej aj tmavej téme naprieč prehliadačmi. Po prejdení kurzorom sa zobrazí lokalizovaný popis; asistenčné technológie oznámia rovnaký názov akcie.
Prihlásenie a relácie¶
Relácie vypršia po 30 minútach nečinnosti a majú aj dlhší absolútny limit nastavený v nasadení. Ak otvorená stránka stratí reláciu, AIKOZO ponechá jej formuláre a modálne okná otvorené a zobrazí štandardné okno Relácia je pozastavená. Výberom Pokračovať v relácii sa bezpečne prihlásite v samostatnom okne. Po prihlásení sa toto okno zatvorí a pôvodný formulár sa pripojí automaticky bez obnovenia stránky alebo ručného overovania. Ak okno zostane otvorené, vráťte sa k pôvodnému formuláru. Pokračovať v úpravách skryje upozornenie, aby ste mohli ďalej písať; uloženie stále vyžaduje prihlásenie. Ak sa prihlasovacie okno neotvorilo alebo ste ho zatvorili, znova vyberte Pokračovať v relácii. Automatické overovanie sa zastaví po piatich minútach; návrat na pôvodnú kartu tiež overí reláciu. Pokračujte s rovnakým účtom a tenantom a sami zopakujte prerušené uloženie alebo nahrávanie. Neuložené zmeny zostávajú v pamäti pôvodnej karty; jej obnovenie alebo zatvorenie ich stratí. Úvodné prihlásenie, nastavenie hesla pri prvom prihlásení a reset hesla vás naďalej vrátia na požadovanú stránku.
Ak AIKOZO dočasne nemôže overiť inak aktívnu reláciu pre nedostupnú autentifikačnú službu alebo sieť, ponechá aktuálnu stránku otvorenú, zobrazí upozornenie a overenie automaticky zopakuje trikrát. Ak tieto pokusy zlyhajú, písanie, návrat na kartu alebo obnovenie siete spustí ďalšie overenie. Úspešné obnovenie opäť zapne sledovanie aktivity. Po obnovení prihlásenia môže byť potrebné zopakovať akciu; neúspešné uloženia a nahrávania sa automaticky neopakujú.
Na ukončenie lokálnej relácie použite Odhlásiť sa v hlavičke. AIKOZO túto akciu odošle ako chránenú požiadavku a potom pokračuje na odhlasovaciu stránku identity providera; priame otvorenie adresy logout API reláciu neukončí. Prebiehajúce obnovenie relácie ani zaznamenanie aktivity nemôže obnoviť odhlásenú reláciu alebo nahradiť novšie prihlásenie. Limit nečinnosti a absolútny limit relácie naďalej platia; overovanie na pozadí neudržiava neaktívnu reláciu prihlásenú.
História úloh na pozadí a zapamätané úlohy generovania patria k vášmu overenému účtu a tenantovi. Pri rovnakom účte zostávajú dostupné aj po obnovení stránky. Odhlásenie alebo zmena účtu či tenanta vymaže predchádzajúcu históriu úloh a odkazy; oneskorená odpoveď ich neobnoví. Dočasný výpadok autentifikácie zachová históriu posledného overeného účtu. Ostatné nastavenia prehliadača a otvorené rozpracované formuláre si ponechávajú doterajšie správanie.
Roly aplikácie určujú dostupné stránky a akcie. AIKOZO prijíma podporované roly
pridelené poskytovateľom identity vrátane rolí nakonfigurovaného aplikačného
klienta. Rola inej aplikácie, aj keď sa volá admin alebo manager, neposkytuje
prístup do AIKOZO. Ak po prihlásení chýba očakávaný prístup, požiadajte správcu,
aby skontroloval pridelenie vašich rolí v AIKOZO.
Kontextový AI asistent¶
Keď je zapnuté CAP_CONTEXTUAL_ASSISTANT, v akciách hero sekcie pri ovládaní
pomoci na stránke sa zobrazí launcher AI na podporovaných stránkach
projektov, špecifikácií, plánovania, implementácií a artefaktov. Nezobrazuje sa
na stránkach nastavení, profilu, správy tenantov, AI Usage, About, Action Pack
ani Build execution. Otvorí kontextového asistenta pre aktuálnu stránku alebo
artefakt. Asistent odpovedá z ohraničeného AIKOZO MCP kontextu a pre
podporované artefakty môže zobraziť štruktúrované návrhy zmien. Odpovede
asistenta sa renderujú ako štruktúrovaný Markdown pre čitateľné sekcie, odrážky
a rozpisy počtov.
Hneď ako plánovanie načítania určí zámer, pod správou používateľa sa zobrazí tlmený jednoriadkový štítok Zámer s najviac piatimi slovami. Začína hlavnou operáciou, napríklad Načítať všetko, Vyhľadať, Hľadať, Zhrnúť, Vypočítať, Porovnať, Upraviť alebo Posúdiť, a potom spresní rozsah použitý existujúcou odpoveďou a načítaním asistenta bez opakovania promptu. Asistent určí operáciu, jazyk a stručný rozsah z celej požiadavky vrátane záporu a opráv. Aplikácia zobrazí štítok jednotne po anglicky alebo slovensky a zachová gramatiku a ľudské identifikátory. Podporovaná je slovenčina bez diakritiky aj kombinácia s technickými výrazmi. Mená ani jazyk projektu nemenia jazyk pokynu; výslovná požiadavka na jazyk odpovede má prednosť. Neutrálna nadväzujúca správa zachová jazyk konverzácie. Celý skrátený štítok zobrazíte podržaním kurzora. Krátky štítok slúži iba na zobrazenie a nejde o krok potvrdenia. Rozsah dôkazov riadi spoločný štruktúrovaný zámer; znenie štítka nevyberá zdroje. Ak chcete interpretáciu opraviť, odošlite opravu ako bežný nasledujúci prompt. Ikona sa vznáša v pravom dolnom rohu každej správy bez vytvorenia ďalšieho riadka akcií. V správe používateľa skopíruje pôvodný prompt a v správe asistenta danú odpoveď. Po podržaní kurzora nad dokončenou bublinou správy sa zobrazí kompaktný dátum a čas jej vytvorenia v lokálnom časovom pásme prehliadača.
Vo všetkých AI asistentoch sa citačné štítky dôkazov zobrazujú napríklad ako E1 alebo S1, bez hranatých zátvoriek.
Asistenti začínajú vo svojom oprávnenom lokálnom kontexte. Publikované dôkazy tenanta zahrnú iba pri výslovnej požiadavke vyplývajúcej zo zámeru a ak ich daný asistent podporuje. Zápor a opravy môžu ponechať alebo obnoviť lokálny rozsah. Požiadavka vyžadujúca spresnenie alebo nepodporovanú schopnosť sa zastaví pred načítaním dôkazov. Panel dôkazov zobrazuje výber backendu bez opätovnej interpretácie promptu v prehliadači. Odpoveď používa zámer plánovača. Project Setup naplánuje požiadavku pred načítaním požadovaných publikovaných organizačných dôkazov. Otázky bez požiadavky na úpravu aj nevyriešené požiadavky zachovajú návrh. Kliknutím na citáciu, napríklad E1, zobrazíte názov zdroja a pasáž uloženú pre danú odpoveď. Citácie starších odpovedí bez uložených dôkazov sú nedostupné.
Keď je zapnutý Prompt Guru, panel asistenta obsahuje výber šablóny promptu.
Predvolený prompt a model asistenta sa spravujú cez použitie
assistant.contextual.chat v Settings alebo Tenant settings.
Panel Načítané dôkazy zobrazuje dôkazy vybrané pre poslednú odpoveď vrátane celkových počtov kolekcií. Kliknutím na citáciu, napríklad E1, alebo kartu dôkazu otvoríte uloženú snímku a odkazy na artefakty. Každá odpoveď uchováva vlastnú snímku; rovnaký štítok v neskoršej odpovedi môže označovať iný dôkaz. Staršie odpovede bez snímky označujú citáciu ako nedostupnú. Otázky na celkový stav načítajú stavy podriadených artefaktov; otázky na počty používajú overené súčty kolekcií.
Enter odošle správu, Shift+Enter pridá riadok. Počas odosielania zostáva pole zamerané a iba na čítanie; opakovaný Enter neodošle ďalšiu požiadavku.
Pri jasných požiadavkách na presnú náhradu textu vie asistent vytvoriť návrhy zo scoped artefaktov aj vtedy, keď načítaný zoznam zobrazuje iba preview. Náhrada rozlišuje veľkosť písmen a platí iba pre podporované skalárne textové polia, napríklad finálny text požiadavky, názov alebo finálny text prípadu použitia a title, description, expected result alebo final text testovacieho prípadu.
Pri požiadavkách na reorganizáciu špecifikácie vie asistent navrhnúť nedeštruktívnu reštrukturalizáciu špecifikácie. Po aplikovaní sa vytvoria nové epiky a do novej štruktúry sa skopírujú existujúce požiadavky, prípady použitia a testovacie prípady. Pôvodné artefakty sa nepresúvajú, nemažú, nepremenúvajú ani neupravujú. Kópie začínajú ako draft a chýbajúce skopírované väzby na požiadavky sa zobrazia ako upozornenia.
Asistent môže navrhnúť nové požiadavky a prípady použitia v existujúcom epiku, testovacie prípady pod existujúcim prípadom použitia a nové epiky v aktuálnej špecifikácii. Nové artefakty sa zobrazia v Návrhoch asistenta, nielen v chate. Každý nový koncept má vlastnú kartu návrhu, kontrolu a schválenie; schválením jedného zostanú ostatné čakajúce. Dávky nových artefaktov sa automaticky rozdelia na jednotlivé návrhy vrátane nových epikov. Reštrukturalizácia s kópiami zostáva spoločným návrhom. Karta zobrazuje typ artefaktu, kľúč a trojriadkovú ukážku textu s jedným tlačidlom Skontrolovať. Pred vytvorením uvádza Kľúč sa priradí po schválení. Po schválení zobrazuje pridelený kľúč a tlačidlo Schválené, ktoré otvorí podrobnosti. Ak jazyk rozhrania zodpovedá jazyku projektu, karta používa lokalizovaný text. Stručný náhľad ukazuje nadradený artefakt a explicitné väzby na požiadavky, potom úplný anglický obsah a druhú jazykovú verziu vedľa seba (na úzkych obrazovkách pod sebou). Neobsahuje počty ani poznámky k reštrukturalizácii; relevantné upozornenia a prekážky schválenia zostávajú viditeľné. Schváliť vytvorí iba daný artefakt; Zrušiť alebo Escape zatvorí náhľad bez vytvorenia. Dvojjazyčný projekt vyžaduje obe verzie aj pri otázke položenej v angličtine; toto pravidlo nie je viazané na slovenčinu. Schválením sa priradia kľúče a vytvoria neoznačené koncepty v stave draft; pred schválením sa nič nevytvorí. Nové nadradené artefakty najprv schváľte a až potom navrhujte ich potomkov. Chýbajúce preklady, finálne alebo odstránené epiky a väzby mimo rozsahu blokujú schválenie. Existujúce artefakty a ich väzby sa nemenia.
Ak asistent oznámi nekompatibilnú konfiguráciu promptu, správca musí spoločne nasadiť aktuálny prompt kontextového asistenta a jeho mapovanie v nastaveniach. Asistent potichu nenahradí uložený prompt ani neobíde schvaľovanie.
Karty návrhov sú súhrny. Použite Skontrolovať na otvorenie read-only náhľadu návrhu pred tým, ako sa čokoľvek aplikuje. Skalárne zmeny zobrazujú hodnoty pred a po zmene alebo kompaktné riadky pre zmenu stavu. Návrhy reštrukturalizácie špecifikácie zobrazujú navrhované cieľové epiky so zoskupenými kópiami požiadaviek, prípadov použitia a testovacích prípadov. Aplikovanie návrhu sa vykonáva z päty náhľadu. Náhľad používa kľúče, názvy a title artefaktov namiesto databázových ID.
Príklady otázok a príkazov:
- Ktoré prípady použitia v tomto kontexte sú v stave final?
- Ktoré draft testovacie prípady už majú vyplnený finálny text?
- Mohli by ste navrhnúť lepšiu štruktúru aktuálneho epiku?
- Navrhnite chýbajúce požiadavky pre tento epik, aby som ich mohol skontrolovať.
- Nastavte stav final pre všetky požiadavky v tomto kontexte, ktoré už majú vyplnený finálny text.
- V požiadavkách, ktorých final text obsahuje
Administrator, nahraďte tento text hodnotouadministrator.
Kliknutím na príklad sa text skopíruje do poľa správy asistenta, aby ste ho mohli pred odoslaním skontrolovať alebo upraviť.
Odpovede asistenta vykresľujú podporovaný Markdown vrátane číslovaných zoznamov s vnorenými odrážkami a odsekmi. Číslovanie pokračuje aj cez tieto podrobnosti a samostatné zoznamy zachovávajú zadané počiatočné číslo. Tabuľky najprv použijú kompaktné stĺpce vážené podľa obsahu, aby sa zmestili do šírky správy. Po podržaní myši alebo zameraní tabuľky možno pomocou ikony rozbalenia otvoriť väčší náhľad so zvislým posúvaním; ak to obsah stále vyžaduje, zostáva dostupné aj vodorovné posúvanie.
Návrhy zmien sú rozdelené na položky s hodnotami pred a po zmene. Nič sa nezapíše, kým konkrétnu položku neschválite. Nepodporované stránky a vylúčené typy artefaktov zostávajú iba v režime chatu.
Šablóny promptov v Settings¶
Globálne Settings umožňujú administrátorom vytvárať, upravovať a vymazávať šablóny promptov uložené v singleton dokumente nastavení. Tenant settings zobrazujú šablóny promptov z tenantového dokumentu nastavení aj z globálneho singleton nastavenia. Každý riadok promptu má pill Tenant alebo Globálne. Vymazanie tenantového promptu odstráni iba tenantovú šablónu alebo prepis; zdedené globálne prompty zostanú viditeľné a vymazávajú sa v globálnych Settings.
Každý prompt zobrazuje Poslednú aktualizáciu obsahu v lokálnom časovom pásme prehliadača (uvedenom pri čase). Tenantové prepisy zobrazujú vlastný dátum; zdedené prompty zobrazujú globálny dátum. Uloženie nezmeneného obsahu, zmena iba koncov riadkov či bielych znakov na začiatku a konci a import nezmenených promptov dátum zachovajú. Zmeny bielych znakov vo vnútri obsahu sa počítajú ako zmeny. Staršie uložené prompty bez sledovanej histórie zobrazujú Neznáme, kým sa ich obsah nezmení; prompty dodané iba aplikáciou zobrazujú Predvolená šablóna aplikácie.
V Tenant Settings vyberte jednotlivé prompty označené Tenant pomocou checkboxov v riadkoch alebo použite Vybrať všetko na výber všetkých tenantových promptov. Zdedené Globálne prompty nemožno vybrať. Počet vybraných promptov a checkbox s čiastočným výberom zobrazujú aktuálny výber. Zvoľte Vymazať vybrané a skontrolujte vybrané kľúče v potvrdzovacom modálnom okne. Odstránenie prepisu odhalí zdedený globálny prompt; čisto tenantová šablóna zmizne. Mapovania zostávajú zachované, ak je zdedený prompt stále dostupný; mapovania na odstránené čisto tenantové šablóny sa vymažú. Možno odstrániť všetky tenantové prepisy vrátane posledného. Ak vymazanie zlyhá, úspešné vymazania sa zobrazia a zostávajúce tenantové prompty zostanú vybrané.
Uloženie v sekcii Predvolené prompty podľa použitia mení iba mapovanie akcie na prompt. Nekopíruje zdedené prompty do tenanta ani nemení ich definície, obsah či zdroj Globálne/Tenant. Uloženie AI nastavení, prahov, guardrails alebo tenantových predvolených hodnôt tiež nemení definície promptov. Vybranú definíciu mení iba výslovné vytvorenie, úprava alebo vymazanie promptu.
AI model mapping v Settings a Tenant settings používa rovnaké označenia použití ako AI Usage vrátane Build execution pre apply-patch volania počas buildu. Päť aktívnych fáz AI asistenta projektového pracovného priestoru je zoskupených pod označeniami AI asistent projektového pracovného priestoru pre plánovanie vyhľadávania, rozpoznávanie artefaktov, skúmanie grafu, kontrolu návrhu a zostavenie odpovede.
Tenant Settings obsahuje aj sekciu Spracovanie zdroja AI Workspace. Jej samostatná akcia Uložiť uloží pre vybraný tenant limit prehľadávania webu, cieľovú veľkosť a prekrytie častí zdroja a veľkosť jednotky extrakcie znalostí. Tieto hodnoty ovplyvnia nové alebo opätovne spracované zdroje, nie zdroje, ktoré sú už pripravené.
Stránka Projects¶
Účel¶
Stránku Projects používajte na vstup do správneho projektu, vytvorenie nového projektu a potvrdenie, ku ktorým projektom máte prístup.
Projekty sa načítavajú po stránkach a zobrazené riadky obsahujú označenia dokumentových kontextov. Ďalšiu stránku zobrazíte cez Load more.
Keď je zapnuté CAP_PROJECT_WORKSPACE, manažéri môžu zvoliť AI Workspace vedľa
AI Nový pre dočasný pracovný priestor pred vytvorením projektu alebo akciu
Pracovný priestor na existujúcom projekte. Pozrite si Projektový pracovný
priestor.
Súvisiaci "Flow"¶
- Flow analytika: krok 1
- Flow buildera: krok 1
Hlavné akcie¶
- filtrovať zoznam projektov podľa key alebo name
- označiť alebo zrušiť označenie projektov hviezdičkou a potom použiť filter Starred na zobrazenie iba vašich dostupných projektov označených hviezdičkou
- otvoriť projekt a pokračovať do špecifikácií alebo implementácií
- vidieť restricted projekty len vtedy, keď ste manager alebo ste priradený ako allowed user
- vytvoriť NewPersonal projekt po prihlásení
- vytvoriť project cez New, ak to vaša rola povoľuje
- spustiť AI New, keď je zapnutý
CAP_AI_PROJECT_BOOTSTRAP; používatelia bez role Manager vytvárajú osobný draft, Manageri si pred chatom vyberajú osobný alebo kolaboratívny rozsah - pre managerov výslovne zahrnúť osobné projekty, keď potrebujú skontrolovať súkromnú projektovú prácu
- obnoviť zoznam
Popup modaly¶
- New personal project: zadanie key, name, description a jazyka projektu
- New project: zadanie key, name, description, jazyka projektu a režimu prístupu
- AI sprievodca nastavením projektu: Manageri najprv vyberú cieľový
rozsah. Používatelia bez role Manager pokračujú priamo s osobným projektovým
draftom. Potom nasleduje chat nad metadátami projektu,
BIZ/TECHkontextom a biznis požiadavkami a použitie Vytvoriť projekt v súhrne Project po splnení kontroly pripravenosti. Draft je dočasný, po neaktivite expiruje a po zaradení creation jobu sa odstráni. Pod každým dokončeným ťahom používateľa sa zobrazí aj pasívny jednoriadkový štítok Zámer s najviac piatimi slovami. Začína hlavnou operáciou a potom spresní jej rozsah bez opakovania promptu. Platia rovnaké pravidlá rozpoznania a anglického či slovenského zobrazenia ako pri kontextovom asistentovi, vrátane záporu, opráv a výslovnej požiadavky na jazyk odpovede. Staršie štítky sa nemenia. Celý text skráteného štítka zobrazíte podržaním kurzora. Mení sa iba štítok, nie správanie draftu. Opravu odošlite ako bežný nasledujúci prompt; štítok nemení pravidlá draftu ani vytvorenia projektu. Ikona sa vznáša v pravom dolnom rohu každej správy bez ďalšieho riadka akcií a skopíruje pôvodný prompt alebo odpoveď asistenta. Po podržaní kurzora nad dokončenou bublinou správy sa zobrazí kompaktný dátum a čas jej vytvorenia v lokálnom časovom pásme prehliadača.
Stránka Project¶
Účel¶
Stránku Project používajte ako systémovú mapu jedného projektu. Prepája špecifikačnú prácu naľavo s implementačnou prácou napravo a dáva rýchly vstup do ďalších pracovných priestorov.
Projekty vytvorené cez projektový pracovný priestor zobrazujú odkaz späť na
pôvod objavovania, kým je CAP_PROJECT_WORKSPACE zapnuté.
Súvisiaci "Flow"¶
- Flow analytika: krok 1
- Flow buildera: krok 1
Hlavné akcie¶
- skontrolovať description, key, badge Restricted a agregované počty
- otvoriť project settings
- povýšiť vlastný osobný projekt cez Promote to managed
- pre managerov vidieť čitateľné meno vlastníka pri otvorení cudzieho osobného projektu
- prehliadať projektové zoznamy špecifikácií a implementácií
- keď je Planning zapnutý pre vašu rolu a projekt, prehliadať projektový zoznam Plans a skontrolovať súhrnné počty Planning (Ready) pre Plans, Scopes, Estimates, Risks a Effort drivers; každý riadok Plan obsahuje aj kontext Scope a aktuálny Minimum Baseline ako Baseline
- otvoriť zjednodušený Workspace pre specification alebo implementation z akcií v riadku
- použiť Open workspace na kartách systémovej mapy; pri viacerých položkách sa stránka posunie na príslušný zoznam a nevyberá položku za vás
- vytvoriť novú specification
- vytvoriť novú implementation
- vytvoriť nový Plan kontajner zo zoznamu Plans v projekte výberom Specification a Epicov, ktoré sa majú stať Scopes
Popup modaly¶
- New specification
- New implementation
- New Plan: vybrať Specification, zvoliť jeden alebo viac Epicov ako Scopes, potom zadať Plan key, name a voliteľný description
Stránka Project settings¶
Účel¶
Stránku Project settings používajte na kontrolu lokalizácie projektu, správu restricted prístupu a údržbu projektového kontextu.
Súvisiaci "Flow"¶
- Flow analytika: krok 1
- Flow buildera: krok 1
Hlavné akcie¶
- skontrolovať jazyk projektu
- skontrolovať vlastníka osobného projektu alebo pôvodného vlastníka, keď sa tieto údaje zobrazujú
- vybrať predvoľbu formátu projektu používanú pre budúce AI generovania
- nastaviť Format Enforcement na Enforce, keď má validácia formátu blokovať finalizáciu, alebo Warning Only, keď sa problémy formátu majú zobraziť ako upozornenia a finalizácia má pokračovať; nové osobné projekty a existujúce projekty spred tohto nastavenia majú predvolené Warning Only, nové kolaboratívne projekty majú predvolené Enforce; stavové gate-y zdrojov zostávajú vynútené
- prepnúť project access medzi unrestricted a restricted
- priraďovať a odoberať povolených používateľov pri restricted projekte
- prehliadať typy projektového kontextu
- upravovať, ukladať alebo mazať projektový kontext
Stránka Specifications¶
Účel¶
Stránku Specifications používajte na prehliadanie specification kontajnerov naprieč kolaboratívnymi projektmi, ku ktorým máte prístup, a na rýchle otvorenie správnej špecifikácie. Cross-project pohľad zoskupuje riadky podľa projektu a každý riadok zobrazuje kľúč špecifikácie a krátky popis, ak je dostupný.
Osobné projekty sa na tejto stránke nikdy nezobrazujú, ani vo výsledkoch vyhľadávania alebo pri filtrovaní podľa projektu. Manager ich špecifikácie otvorí cez Projects: výslovne zahrnie osobné projekty, otvorí projekt a použije jeho zoznam špecifikácií.
Súvisiaci "Flow"¶
- Flow analytika: kroky 1-2
Hlavné akcie¶
- filtrovať špecifikácie podľa key, name alebo project
- použiť Load more, keď existujú ďalšie zodpovedajúce špecifikácie; filtrovanie prehľadáva dostupný výsledkový set, nielen riadky už načítané na obrazovke
- použiť Workspace v riadku specification na otvorenie Specification workspace
- otvoriť samotný riadok na pokračovanie do pokročilej stránky Epics
- obnoviť zoznam podľa potreby
Stránka Implementations¶
Účel¶
Stránku Implementations používajte na prehliadanie implementačných kontajnerov naprieč projektmi a na otvorenie správneho implementation workspace-u. Cross-project pohľad zoskupuje riadky podľa projektu a každý riadok zobrazuje kľúč implementation, prepojenú specification a krátky popis, ak je dostupný.
Výsledky sa načítavajú po stránkach a zachovávajú označenia Project a Specification. V nasadeniach s vytváraním na tejto stránke sa možnosti Specification načítajú pri otvorení New implementation.
Súvisiaci "Flow"¶
- Flow buildera: krok 1
Hlavné akcie¶
- filtrovať implementations podľa key, name, project alebo specification
- použiť Load more, keď existujú ďalšie zodpovedajúce implementations; filtrovanie prehľadáva dostupný výsledkový set, nielen riadky už načítané na obrazovke
- použiť Workspace v riadku implementation na otvorenie Implementation workspace
- otvoriť samotný riadok na pokračovanie do pokročilej stránky Implementation
Pozrite tiež¶
Hlavné akcie¶
- filtrovať implementations podľa key alebo name
- otvoriť implementation a pokračovať na Implementation workspace alebo na stránku Implementation
- v deploymentoch, kde je to sprístupnené, vytvoriť novú implementation
Popup modaly¶
New implementation sa na tejto stránke zobrazí vtedy, keď je vytváranie sprístupnené priamo tu.
Stránka Plans¶
Účel¶
Stránku Plans používajte na prehliadanie first-class plánovacích kontajnerov. Nové Plans sú viazané na Specification a obsahujú jeden Planning Scope pre každý vybraný Epic. Scope vlastní AI-backed hodnotenia pre daný plánovaný Epic. Hodnotenia extrahujú plánovacie faktory v background jobe, ukladajú použitý prompt/model a aktualizujú baseline vybraného Scope hrubým odhadom úsilia až po prijatí Plannerom alebo Adminom. Delivery slicing a integrácia s delivery systémami sú stále mimo scope.
Plans vyžadujú CAP_PLANNING a sú viditeľné pre roly Admin, Planner a Manager.
Manager môže Planning čítať a prijať riziko zmien zdrojov; ostatné úpravy vyžadujú Planner/Admin.
Výsledky sa načítavajú po stránkach. Odkazy obmedzené na Project alebo Epic zachovávajú vybraný kontext.
Súvisiaci "Flow"¶
- Planning flow: primárny krokový planning workflow
- Flow analytika: upstream príprava špecifikácie
- Flow buildera: downstream použitie prijatého planning guidance
Hlavné akcie¶
- filtrovať Plans podľa key, name, project, Specification, Epic Scope alebo lifecycle statusu
- otvoriť prehľad Plan
- na detaile Plan upraviť name a description; uloženie accepted alebo
superseded Plan ho znovu otvorí ako
draft - pridať chýbajúci Epic ako Scope, keď Epic patrí do Specification daného Plan
- otvoriť stránku Planning Scope a vygenerovať alebo pregenerovať AI-backed hodnotenie preň
- otvoriť Estimation Profiles na stránke Tenant a zobraziť deterministické verzie profilov používané plánovacími hodnoteniami
- otvoriť Delivery Role Profiles na stránke Tenant a zobraziť deterministické váhy rolí používané pre Role Allocation
- skontrolovať najnovšie vygenerované hodnotenie, pridať review notes, voliteľne prepísať odhad so zdôvodnením a prijať jedno hodnotenie ako aktuálny plánovací baseline Scope
- po potvrdení vymazať Plan zo zoznamu Plans alebo zoznamu Plans v Project
- pozrieť stav prijatého baseline, upozornenia na zastaraný baseline, históriu hodnotení, timeline, verziu profilu odhadu a append-only históriu verzií
Popup modaly¶
- Edit Plan: upraviť name a description; Plans mimo stavu draft sa pri uložení znovu otvoria ako draft
- Add Scope: pridať do Plan ďalší Scope z epicu
- Delete pri Scope: natrvalo vymazať daný Scope spolu s jeho hodnoteniami, alokáciami, prepojeniami pôvodu a odvodenými plánovacími výstupmi. Potvrdenie zobrazí ovplyvnené zdroje. Vymazanie je zablokované, kým prebieha súvisiaca úloha na pozadí alebo kým od Scope závisia aplikované Implementation Features; najprv vymažte tieto Features. Zdrojový Epic ani jeho Requirements, Use Cases a Test Cases sa nevymažú.
Detail Plan¶
Detail Plan zobrazuje identitu Planu a context path: Project, Plan a Scopes v Plane. Context tree prepája riadky Project, Plan a Scope na ich príslušné stránky.
- Scopes zobrazuje Scopes odvodené z Epicov s Full/Active rozsahmi, počtami active/deferred, verziou prijatého assessmentu, stavom allocation a freshness. Filter podľa názvu zúži viditeľný zoznam Scopes. Kompaktný ovládač tabu radí Scopes podľa najstarších, najnovších alebo key a zachová výber v URL. Scope otvoríte výberom jeho riadka; jedinou explicitnou akciou riadka je Delete pre plannerov a administrátorov, ktorá najprv zobrazí dopad vymazania.
- Plán práce podľa rolí prognózuje potrebu ľudských rolí v pracovných dňoch z vybraných pripravených rozsahov. Pomenované scenáre majú vlastné časovanie a jeden spoločný základ akceptovaných zdrojov. Pred uložením skontrolujte dopad aktualizácie zdrojov na všetky scenáre, týždennú/mesačnú potrebu, denné špičky a export uloženej matice potreby podľa filtrov za celý horizont. Výber názvu roly otvorí týždenné posuvníky a číselné hodnoty najpravdepodobnejšieho odhadu. Upravené týždne sa fixujú; automatické týždne sa prispôsobia v rámci časovania Scope pri zachovaní celkovej prácnosti. Skontrolujte automatický náhľad a uložte rozloženie pre daný scenár. Všeobecné nastavenia a časovanie sú v sekcii Nastavenie a zdroje. Kapacita a nedostatok zdrojov sú odložené. Pozrite postup plánu práce podľa rolí.
- Minimum Baseline generuje nemenné deterministické revízie z aktuálnych prijatých dvojitých Scope assessments a kanonických Scope Item splitov; Specification Allocation je voliteľná. Tab zobrazuje Full Scope, Active Scope, Minimum Baseline, plánované zníženie, reconciliation buckets a residual, freshness, kompaktné počty klasifikácií a AI-asistované Savings Opportunities. Použite Generate, keď chcete orientačné AI kandidáty úspor pre aktuálny Minimum Baseline zaradiť ako background job. Job sledujte v Background jobs. Backend validuje každý návrh a orientačnú úsporu počíta iba z existujúcich allocation údajov. Príležitosti so stavom decision needed môžu stále zobrazovať orientačnú hodnotu, keď má affected artifact allocation estimate. Návrhy nevymazávajú ani nemenia Specification artefakty. Keď sa návrh bezpečne mapuje na položky Planning Scope, Defer all uloží plánovacie rozhodnutia a označí príležitosť applied bez prepísania nemenného zdrojového Minimum Baseline.
- Design verification kontroluje aktuálny Minimum Baseline voči final Implementation Designu a vybraným Patternom. Tab generuje, kontroluje, prijíma, nahrádza a obnovuje Design-informed Confidence reviews ako background jobs.
- Feature Candidates premieta prijatý Minimum Baseline do kontrolovateľných kandidátov na Implementation Features pomocou prepojených špecifikačných artefaktov, prijatých plánovacích allocations, Design fragments a vybraných alebo povolených Patterns. Generovanie sa zaraďuje ako background job a dá sa sledovať v Background jobs. Karty kandidátov zostávajú stručné; otvorením kandidáta skontrolujete risks, decisions, included scope, required dependencies, traceability, Design fragments a Patterns na detaile Feature Candidate. Prijaté proposals sa dajú aplikovať iba do novej Implementation alebo do existujúcej Implementation bez Features; naplnené Implementations sú chránené pred náhodným zlúčením.
- Remaining Scope zobrazuje projection coverage po aplikovaní Feature Projection. Porovnáva lineage Plan Scope s traceability vytvorených Features pre Requirements, Use Cases, Test Cases a effort, keď existujú allocation estimates. Planner/Admin používatelia môžu vytvárať Extensions z vybrateľných remaining alebo deferred artefaktov, generovať Extension Feature Candidates a aplikovať prijaté Extension proposals do novej, prázdnej alebo same-Plan traceable Implementation.
- Versions zobrazuje append-only históriu verzií Plan
Vybraný tab detailu Plan sa premieta do URL stránky, takže reload alebo zdieľaný odkaz otvorí rovnaký tab.
Časť Plan foundation sa na detaile Plan zámerne nezobrazuje. Plan upravte alebo vymažte po potvrdení zo zoznamu Plans alebo zo zoznamu Plans v Project. Staršie Plans viazané priamo na Epic sú na detaile iba na zobrazenie. Supersede pre Minimum Baseline nie je vymazanie; staré baseline-y zostávajú auditnými záznamami.
Stránka Planning Scope¶
Stránka Planning Scope vlastní hodnotiacu prácu pre jeden Epic v spec-scoped Plane. Kontextový strom je nad tabmi a je tam rezervované miesto pre budúce semantic search v Planningu. Taby sú Overview pre Scope Coverage so základnými detailmi Scope, súhrn prijatého baseline, zdrojový Epic a počty plánovacieho pokrytia; Assessment pre najnovšie vygenerované hodnotenie, review rozhodnutia, drivery, chýbajúce informácie a históriu hodnotení; Scope Items pre rozdelenie na UC/fallback RQ; Allocation pre Specification Allocation; Roles pre Role Allocation; a Timeline pre filtrovateľnú auditovateľnú aktivitu s rozbaliteľnými detailmi udalostí.
Vybraný tab Planning Scope sa premieta do URL stránky, takže reload alebo zdieľaný odkaz otvorí rovnaký tab.
Scope Coverage spája popis Scope a súhrn prijatého Scope Estimate so zdrojovým Epicom, počtom primárnych plánovacích položiek, pokrytím Requirements/Use Cases, fallback Requirements a dôkazmi z Test Cases pre daný Scope. Refresh Coverage znovu odvodí súhrn pokrytých artefaktov zo zdrojového Epicu Scope. Admini a Planneri ho môžu obnoviť, čitatelia Planningu môžu kontrolovať súhrn.
Zmeny špecifikácie pod pokrytím zobrazujú pridané, odstránené a zmenené zdrojové artefakty s rozbaliteľným porovnaním pôvodných a aktuálnych hodnôt. Planner, Manager a Admin môžu uviesť dôvod a potvrdiť rozhodnutie tlačidlom Prijať riziko zmien v modálnom okne. Prijatá prácnosť sa nemení; rozhodnutie sa zapíše do Časovej osi a platí iba pre skontrolované posúdenie a zistené revízie zdrojov. Staršie snímky môžu mať obmedzené historické údaje.
Tab Scope Items sa napĺňa z najnovšieho vygenerovaného hodnotenia. Zobrazuje každý primárny Use Case a fallback Requirements, ktoré nie sú prepojené na Use Case. Kompaktný súhrn ukazuje počty položiek a priebeh schvaľovania práce. Podrobná tabuľka sa sústredí na stav Active/Deferred, pôvod a dôvod rozhodnutia, kanonické Full a Active úsilie, úrovne faktorov pre UI, backend, dáta, integráciu, bezpečnosť a testovanie a dôkazy. Každá položka používa dvojriadkovú skupinu: jej názov a Action prechádzajú cez oba riadky a všetkých šesť faktorov zdieľa širokú zlúčenú bunku v druhom riadku. Tabuľka sa tak zmestí na stránku bez horizontálneho posúvania. Prepínač vpravo ponúka zjednodušenú tabuľku: položka rozsahu, finálny text, medzery, posudzovateľ a rovnaké klikateľné položky práce. Finálny text používa rovnaký 220-znakový náhľad súvisiaceho artefaktu špecifikácie ako Allocation. Údaj o schválení je menší a písaný kurzívou; prejdenie myšou alebo zameranie klávesnicou zvýrazní spodný okraj položky. Prepnutie obnoví oba filtre na *. Podrobné filtre sú *, aktívne, odložené, vyžaduje ocenenie; zjednodušené kombinujú * alebo priradené mne s filtrom Medzery: *, chyba, upozornenie. Filter medzier * zahŕňa aj položky bez medzier; položky s chybami aj upozorneniami sa zobrazia pri oboch úrovniach. Koncepčné poznámky sú neblokujúce upozornenia s postupom vyjasnenia; chýbajúce množstvá a chyby ocenenia naďalej blokujú prijatie. Na uplatnenie pravidla upozornení staršie hodnotenia znovu vygenerujte. Hodnoty Scope item odkazujú späť na detail zdrojového Use Case alebo fallback Requirement. Kompaktný ovládač tabu prepína poradie assessmentu, obrátené poradie assessmentu a poradie podľa key a zachová výber v URL. Admini a Planneri môžu prejsť myšou na faktorový pill a kliknúť na jeho ľavú alebo pravú polovicu, aby faktor znížili alebo zvýšili medzi úrovňami none, low, medium a high. Každá zmena prepočíta iba kanonický príspevok danej položky a premietne rozdiel do Full a Active odhadov Scope; pôvodný celkový odhad sa neprerozdelí medzi ostatné položky. Existujúce allocations sa pre audit označia ako stale, ale zostávajú použiteľné. Admini a Planneri môžu položky Scope z tejto tabuľky Defer alebo Restore cez modal s povinným dôvodom; tieto akcie aktualizujú iba overlay Planning Scope a zdrojové Specification artefakty nemenia.
Generate Assessment zaradí AI generovanie do background jobu. Kým je job vo fronte alebo beží, stránka priebežne kontroluje latest status a zdieľaný popover Background jobs zobrazuje zaradenú úlohu hodnotenia Planning Scope. Dokončené hodnotenie je reviewable, ale neaktualizuje baseline Scope, kým ho Planner alebo Admin neprijme. Prijatie hodnotenia z neho spraví aktuálny plánovací baseline pre daný Scope a prepočíta rollup rodičovského Plan. Rodičovský Plan sa stane accepted až vtedy, keď má každý aktívny Scope prijatý baseline. Predtým prijaté hodnotenia pre rovnaký Scope sa označia ako superseded. Assessment ponúka Accept a Supersede bez tlačidiel Review a Override. Kompaktné karty ukazujú najpravdepodobnejšiu prácnosť, rozsah, pripravenosť a dôveryhodnosť. Zhodné metriky Full/Active zdieľajú jednu kartu; odlišné hodnoty sú vedľa seba. Pri neúplnom ocenení oba rozsahy ukazujú známy medzisúčet. Duplicitná karta Review status a neaktuálna Review note sú odstránené. Názov a verzia profilu sú v jednom riadku, kľúč a systémový/vlastný pôvod v popise pri prejdení myšou. Faktory prácnosti, riziká a chýbajúce informácie zostávajú v kompaktných paneloch. Prijaté odhady sú plánovacie baseline, nie záväzky doručenia. Zlyhané hodnotenie zostáva v histórii pre audit, ale nemôže sa stať baseline.
Role Allocation rozdelí každý kanonický príspevok aktívnej položky Scope
medzi faktory odlišné od none a každý faktorový bucket alokuje iba oprávneným
delivery rolám podľa Delivery Role Profile Planu. Nulový test-factor bucket
preto nevytvorí žiadnu alokáciu pre Tester. Algoritmus je deterministický a pri
chýbajúcich alebo všetkých none faktoroch nepoužíva equal fallback.
Vygenerované role allocations ukladajú snapshot profilu a dôkazy faktorového
rozdelenia a zosúlaďujú min, most likely a max súčty späť na prijatý odhad Scope.
Admini a Planneri môžu role allocations generovať, prijať, nahradiť a
pregenerovať. Planneri môžu kontrolovať váhy profilov; Admini spravujú vlastné
verzie profilov a tenant default na stránke Tenant. Role Allocation je na tabe
Roles a dá sa exportovať ako CSV. Matica úsilia faktorov a rolí zobrazuje
každý kôš faktora ako riadok, každú alokovanú rolu ako stĺpec a príslušný
príspevok v bunke. Tlačidlá možností Min, Most likely a Max nad
tabuľkami prepínajú hodnoty v matici aj jediný stĺpec Estimate v tabuľke
Delivery Role. CSV obsahuje rovnaké súčty košov, oprávnenosť a príspevky rolí.
Specification Allocation zvolí Full alebo Active základ (predvolene Active) a rozdelí ho medzi prepojené špecifikačné artefakty. Nejde o nezávislý odhad pre každú Requirement, Use Case alebo Test Case. Predvolený cieľ sú Use Cases, ak existujú, potom Requirements; Test Cases sú dostupné, keď sú prepojené. Vygenerované rozdelenia zosúlaďujú min, most likely a max súčty späť na prijatý odhad Scope. Drobné zaokrúhlenie sa rieši pridaním zvyškového rozdielu poslednej položke. Admini a Planneri môžu rozdelenia generovať, prijať, nahradiť a pregenerovať. Hodnoty allocation artefaktov odkazujú na zdrojové detail stránky, zobrazujú skrátený final text vedľa effort splitu a obsahujú koše úsilia faktorov UI, backend, dáta, integrácia, bezpečnosť a test. Koše používajú rovnaký kanonický rozklad low/medium/high klasifikácií Scope Items ako Role Allocation a po zaokrúhlení zachováva súčet položky. Specification Allocation je na tabe Allocation. Základ odhadu, cieľ, metóda a kompaktný stav zosúladenia zdieľajú horný riadok; celkové alokované úsilie využíva celú šírku pod nimi. Na menších obrazovkách sa ovládacie prvky skladajú pod seba. Položky používajú rovnaké kompaktné odsadenie buniek, štýl názvu, farby a zvýraznenie spodného okraja pri prejdení myšou alebo zameraní klávesnicou ako Scope Items. CSV export obsahuje aj tieto riadky faktorov. Prázdne stavy rozlišujú, či treba najprv prijať hodnotenie, alebo ešte nebolo vygenerované žiadne rozdelenie. Berte ich ako plánovaciu pomôcku pre audit a kontrolu, nie ako záväzok doručenia.
Tab Estimation Profiles na stránke Tenant¶
Estimation Profiles určujú, ako Planning premieňa extrahované faktory na hrubé odhady úsilia v človekodňoch alebo človekohodinách. Tab je dostupný zo stránky Tenant. Ide o deterministickú konfiguráciu, nie o prompty pre AI extrakciu faktorov. Admini aj Planneri môžu vidieť dostupné verzie profilov a vybrať profil pri vytváraní alebo úprave Planu. Profil označený ako Default sa predvyberie pre nové Plany, ale každý Plan si stále ukladá konkrétny odkaz na profil. Admin môže duplikovať existujúci profil, nastaviť predvolený profil, upraviť Key, Name a Description zo zoznamu profilov, upraviť jednotku a pravidlá vybraného vlastného profilu priamo v tabe, uložiť zmeny ako novú verziu alebo vymazať profily, ktoré nie sú priradené k Planom. Rozsahy Scope sa interpretujú vo vybranej jednotke; zmena jednotky neprepočíta uložené číselné rozsahy. Vstavaný systémový profil je interný fallback a v tabe sa nespravuje; musí zostať aspoň jeden tenant profil. Ak sa vymaže aktuálny Default profil, Default sa presunie na iný zostávajúci profil.
Ovládacie prvky ? pri nadpisoch sekcií profilu odhadu vysvetľujú metódu, sadzby úloh, rozsahy Scope, úpravy prácnosti a pravidlá istoty. Nápovedy objasňujú desatinné hodnoty úprav aj ich použitie pri jednotlivých metódach.
Budúce hodnotenia používajú profil priradený k Planu. Existujúce hodnotenia si ponechajú key, verziu a snímku profilu zachytenú pri generovaní, takže ich význam sa po úpravách profilu nemení.
Tab Delivery Role Profiles na stránke Tenant¶
Delivery Role Profiles určujú, ako Planning rozdelí prijatý odhad assessmentu medzi delivery roly. Tab je dostupný zo stránky Tenant vedľa Estimation Profiles. Vstavané delivery roly a systémový profil sú vo V1 iba na čítanie. Admini aj Planneri môžu vidieť roly, váhy rolí, označenie tenant default, úpravy faktorov, ako aj efektívne normalizované percento pre každý faktor, úroveň a oprávnenú rolu. Tieto odvodené percentá zobrazujú výsledok uloženej verzie profilu po skombinovaní globálnych váh rolí a prídavných úprav; nejde o samostatne uloženú konfiguráciu. Admin môže profil duplikovať a vytvoriť tenantový vlastný profil, upravovať číselné váhy rolí a úpravy faktorov, nastaviť vlastný profil ako tenant default, vymazať vlastné profily, ktoré nie sú priradené k Planom, a uložiť zmeny ako novú verziu. Key, názov a popis profilu sa upravujú cez akciu Edit v riadku profilu; vymazanie profilu je tiež akcia v riadku.
Tab používajte v tomto poradí:
- Vyberte profil a skontrolujte jeho uloženú konfiguráciu. Vstavané profily sú iba na čítanie; ak potrebujete upraviteľný vlastný základ, profil duplikujte.
- Nastavte hodnoty Base Role Weight pre bežnú preferenciu rozdelenia. Ide o relatívne hodnoty, nie percentá. Ich celkový súčet nemá samostatný význam: nie je to 100 % ani hodnota celkového úsilia.
- Additive Weight Adjustment použite iba vtedy, keď konkrétny Planning Factor a Factor Complexity Level majú zmeniť počiatočnú váhu uvedenej Affected Delivery Role.
- Profil uložte a potom v tabuľke iba na čítanie overte Normalized Delivery Role Shares. Profil nastavte ako Default iba vtedy, ak sa má predvybrať pre nové Plany.
Pre každý faktor a úroveň používa Planning iba doručovacie roly oprávnené pre daný faktor. Kombinovaná efektívna váha role je jej základná váha plus uvedená prídavná úprava; záporný výsledok sa obmedzí na nulu. Planning potom vydelí každú kladnú efektívnu váhu súčtom všetkých kladných váh oprávnených rolí a vytvorí normalizované podiely so súčtom 100 %. Efektívna tabuľka je odvodený náhľad uloženého profilu a obnoví sa po uložení; nejde o druhú sadu upraviteľných konfiguračných hodnôt. Keďže úpravy sú prídavné, na mierke základných váh záleží: ak vynásobíte všetky základné váhy bez rovnakého preškálovania úprav, zmení sa sila ich vplyvu na konečné podiely.
Factor Complexity Level je klasifikácia komplexity low, medium alebo
high priradená danému faktoru na položke Scope; nejde o confidence.
Confidence opisuje kvalitu dôkazov, na ktorých je assessment založený. Faktor
klasifikovaný ako none neprispieva žiadnym úsilím do Role Allocation.
Role Allocation používa iba faktory úsilia UI, Backend, Data, Integration, Security a Test. Ambiguity zaznamenáva mieru nejasnosti alebo neúplnosti očakávaného správania, hraníc, závislostí či akceptačných dôkazov. Reuse potential zaznamenáva príležitosť znovu použiť existujúce aktíva. Oba sú signálmi assessmentu, nie košmi úsilia pre rozdelenie podľa rolí, preto sa ich hodnoty v tomto tabe profilu nezobrazujú ani neupravujú.
Role Allocation ukladá key, verziu a snapshot Delivery Role Profile ku každej sade allocation. Budúce Role Allocations používajú Delivery Role Profile priradený k Planu. Zmena tenant default mení iba predvýber profilu pre nové Plany; existujúce Plany a história allocation si ponechajú zachytené odkazy na profil, snapshoty a reconciliation dáta.
Stránka AI Usage¶
Udalosti vykonávania zostavenia obsahujú odhad nákladov poskytovateľa: bežný vstup, vstup z vyrovnávacej pamäte, zápisy do nej, výstup, použité ceny a náklady jednotlivých položiek. Účtovaná suma tenanta je uvedená samostatne. Oznámenia o nedostupnej cene a podrobnosti neúplného výpočtu vidia iba používatelia s rolou Admin. Kliknutím na Cena nie je dostupná pre … volaní pri nákladoch za zvolený rozsah alebo mesačnej útrate sa otvorí modal s vysvetlením a ďalšími krokmi. Zobrazí najviac 100 zodpovedajúcich volaní z daného rozsahu alebo mesiaca s dostupnými dôvodmi, časmi, modelmi a referenciami požiadaviek. Zatvoríte ho tlačidlom Zavrieť alebo klávesom Escape. CSV report pre Admina obsahuje aj počet volaní bez určenej ceny; ostatné roly tieto diagnostické údaje nevidia.
Neznáme náklady nie sú zahrnuté v známych súčtoch ani v čerpaní rozpočtu. Obnovenie stránky nedoplní chýbajúce historické údaje; neopakujte AI akciu iba kvôli určeniu jej ceny. Odhady používajú ceny uložené s udalosťou, preto neskoršie zmeny cien neprepočítavajú staršie udalosti.
Účel¶
Stránku AI Usage používajte vtedy, keď chcete rýchlo pochopiť, čo sa deje s používaním AI v tenant-e alebo prostredí. Pomôže vám odpovedať na bežné prevádzkové otázky: ktorá feature zvýšila spotrebu, či rastú náklady a či už tenant prekročil zahrnutý mesačný rozpočet. Pred otvorením stránky nemusíte nič pripravovať a väčšina kontrol zaberie len minútu alebo dve. Stránka nie je určená na úpravu artefaktov.
Súvisiaci "Flow"¶
- Flow analytika: voliteľná prevádzková kontrola
- Flow buildera: voliteľná prevádzková kontrola
Hlavné akcie¶
Táto stránka sa najčastejšie používa na dva druhy kontrol: rýchly prehľad používania a mesačný billing review. Napríklad keď sa tím pýta, prečo sú tento týždeň vyššie náklady, môžete zmeniť rozsah, pozrieť rozpad podľa feature a modelu a potom to porovnať so stavom fakturácie v aktuálnom UTC mesiaci.
- prepínať reporting range
- nastaviť vlastný dátumový rozsah
- obnoviť dashboard
- kontrolovať odhadované náklady v čase, počet volaní, tokeny, breakdown podľa feature a modelu a recent events s dátumom a časom
- sledovať AI fakturáciu tenantu pre zvolený fakturačný mesiac podľa UTC
- stiahnuť CSV report používania agregovaný podľa dňa, projektu a feature pre zvolený fakturačný mesiac podľa UTC vrátane kľúča a názvu projektu
- prepínať fakturačný mesiac podľa UTC pomocou ovládania predchádzajúci, nasledujúci a aktuálny mesiac
- kontrolovať, koľko zo zahrnutého rozpočtu je už využité voči mesačnému rozpočtu
- vidieť zostávajúci zahrnutý rozpočet alebo dodatočne účtovanú sumu za prémiové požiadavky
- sledovať počet prémiových požiadaviek, prémiový poplatok a fakturovanú útratu
- vidieť stav, či je prémiová brokerage už aktívna alebo sa aktivuje až po vyčerpaní zahrnutého rozpočtu
Stránka About¶
Účel¶
Stránku About používajte na potvrdenie toho, čo je v aktuálnom prostredí nasadené.
Súvisiaci "Flow"¶
- Flow analytika: voliteľná kontrola prostredia
- Flow buildera: voliteľná kontrola prostredia
Hlavné akcie¶
- skontrolovať verziu aplikácie a edition
- prezrieť effective feature flagy a ich popisy
Stránka Tenant¶
Účel¶
Stránku Tenant používajte na tenant-scoped administráciu, prehľad autentifikovaných používateľov, správu používateľov tenant-u, správu tenant patternov, správu planning estimation profilov a správu profilov delivery rolí.
Súvisiaci "Flow"¶
- Flow buildera: krok 5a, keď execution alebo pattern setup závisí od tenant administrácie
Hlavné akcie¶
- skontrolovať tenant details
- extrakcia znalostí overuje aj súvisiace sekcie v rámci jednej položky dôkazov; každé tvrdenie medzi sekciami odkazuje na pôvodné podporné pasáže
- pre používateľov s rolou Manager používať Dôkazy o organizácii s rovnakým
spôsobom pridávania ako pri zdrojoch Project Workspace: Pridať súbory
otvorí drag-and-drop výber viacerých súborov s priebehom nahrávania vrátane
zošitov Excel
.xlsx, ktorých hárky a atomické riadky zostanú zachované; voľby Pridať webovú stránku a Pridať text otvoria zamerané formuláre. Materiál prechádza existujúcim Source pipeline. Každá karta dôkazu zobrazuje priebeh spracovania, typ súboru, čas aktualizácie a dostupné počty strán, sekcií, blokov, odkazov, konceptov a tvrdení s vysvetlením po podržaní myši. Nedostupné počty sa vynechávajú. Hlavička zobrazí Pripravené po dokončení všetkých zapnutých fáz bez opakovania v dokončenom pruhu priebehu; pravidlá sprístupnenia asistentom sa nemenia. Rozbaľte AI analýza: 259 pasáží · 21 neistých a prečítajte si vysvetlenie uložených AI interpretácií. Neisté zahŕňajú aj neklasifikované pasáže, nie chýbajúce požiadavky ani zistenia čakajúce na kontrolu. Prehliadače nevypisujú presné označené pasáže ani neumožňujú označiť ich za vyriešené. Staršie zdroje môžu uvádzať Podrobnosti AI analýzy nie sú dostupné. Kontext overte v náhľadoch a výňatkoch dôkazov alebo položte konkrétnu otázku asistentovi povolenému nižšie uvedenými nastaveniami a skontrolujte jeho citácie; otázky počet neznižujú. Štruktúra otvorí rovnaký hierarchický prehliadač zdroja ako AI Workspace a Znalosti otvoria Prieskumník znalostí s vyhľadávaním konceptov, tvrdeniami, výňatkami dôkazov a lokálnym grafom. Každé kliknutie na Rozšíriť o ďalší krok pridá jeden krok bez pevného limitu hĺbky. Môžete opakovať spracovanie, nahradiť alebo odstrániť dôkaz a premenovať jeho čitateľný názov. Voľba Obnoviť analýzu na spracovanom dôkaze analyzuje uložený obsah podľa aktuálnych pravidiel bez odstránenia alebo opätovného nahrávania. Zachová zdroj, štruktúru, embeddingy aj nastavenia sprístupnenia. Asistenti ho môžu znova používať po dokončení spracovania. Priebeh sa obnovuje automaticky; počas analýzy nemožno spustiť ďalšiu obnovu. Akcia môže využívať platené AI volania; dostupné kompatibilné kroky prerušeného behu sa použijú znova. Neimportuje pôvodný súbor a nezaručuje zníženie počtu neistých pasáží. Pridanie súboru s už existujúcim názvom otvorí štandardný potvrdzovací panel AIKOZO; po potvrdení sa existujúci obsah nahradí, jeho extrahovaná štruktúra, embeddingy a údaje znalostného grafu sa odstránia a znova vytvoria z nového súboru - import dôkazov z Excelu uchováva hodnoty buniek a uložené výsledky vzorcov, nie výrazy vzorcov. Bunky bez uloženého výsledku vzorca sa vynechajú. Pred nahratím zošit prepočítajte a uložte; na uplatnenie tohto pravidla nahraďte existujúci dôkaz pôvodným zošitom. Pozrite si import z Excelu.
- extrahované informácie z úplne pripraveného zdroja nezávisle sprístupniť voľbami Dostupné pre AI Assistant, Dostupné pre AI Workspace Assistant a Dostupné pre AI asistenta prípadu podpory. Ide o voliteľné tlačidlové karty namiesto zaškrtávacích polí. Všetky sú predvolene vypnuté; nahradenie obsahu ich vypne, zatiaľ čo zmena iba názvu ich zachová. Dostupnosť vyžaduje pripravené spracovanie zdroja, vektory, štrukturálny graf, aktuálnu extrakciu Project Knowledge a jej grafovú projekciu
- vedieť, že asistenti automaticky vyhľadávajú v dostupných normalizovaných výňatkoch, štrukturálnom kontexte a Project Knowledge. Pôvodné nahraté dokumenty sa asistentovi neposkytujú, používatelia Workspace dokumenty tenanta nevyberajú a nedostupné extrahované informácie zostávajú neviditeľné
- Dostupnosť organizačných dôkazov platí pre každého asistenta: Dostupné pre AI Assistant zahŕňa nastavenie Projektu, kontextové stránky a pracovný priestor podpory; voľby Workspace a prípadu podpory riadia príslušných asistentov. Používajú iba publikovaný a pripravený obsah povolený pre daného asistenta a tenanta. Otázky o ľuďoch, certifikáciách alebo pravidlách tenanta používajú organizačné dôkazy; výslovné obmedzenie na lokálne zdroje má prednosť. Nastavenie Projektu najskôr naplánuje požiadavku, potom vyhľadá dôkazy a odpovie s uvedením zdrojov. Kontrola návrhu a potvrdenie Projektu zostávajú zachované. Prázdny výsledok znamená nedostatok dôkazov, nie nepodporovanú schopnosť asistenta.
- prehliadať tenant users, ich aktuálne tenant roly, status a čas poslednej aktivity
- pre používateľov s rolou Manager vytvoriť nového používateľa tenant-u so zadaním username, emailu, mena, priezviska, dočasného hesla a rolí
- pre používateľov s rolou Manager vykonávať validáciu nového používateľa ešte pred odoslaním: dĺžka a jedinečnosť username v tenant-e, formát emailu, komplexita hesla a zhoda potvrdenia hesla
- pre používateľov s rolou Manager deaktivovať používateľov tenant-u bez ich vymazania
- účty s rolou Admin a servisné účty Keycloak sú chránené pred úpravou profilu, resetovaním hesla, aktiváciou a deaktiváciou zo strany správcu tenant-u; tieto účty spravujte prostredníctvom oprávnenej administrácie Keycloak
- spravovať tenant predvoľby formátu používané projektovými AI prompt parametrami a duplikovať existujúcu predvoľbu, keď je potrebná ďalšia predvoľba; názvy predvolieb sú obmedzené na 16 znakov
- skontrolovať tenantový OpenAI timeout a AI model mapping zdedený z globálnych nastavení, podľa potreby zadať tenantový prepis modelu a resetovať prepis späť na zdedený globálny model
- po potvrdení odstrániť predvoľbu formátu; vždy musí zostať aspoň jedna predvoľba a predvoľby používané projektmi treba pred odstránením presunúť
- vedieť, že zmeny predvoľby ovplyvnia budúce AI generovania; minulé AI runy si ponechajú uloženú históriu promptu
- zobraziť deterministické Planning estimation profily; Admini môžu duplikovať, upravovať, verzovať a vymazávať vlastné profily, ktoré nie sú priradené k Planom
- zobraziť deterministické Delivery Role Profiles; Admini môžu duplikovať, upravovať, nastaviť default, vymazať a verzovať vlastné profily používané pre budúce Plany
- prehliadať shared patterns
- vytvárať, klonovať, upravovať a mazať tenant patterns
Popup modaly¶
- New tenant user: vytvorí nového tenant používateľa, priradí mu jednu alebo viac rolí a vynúti zmenu hesla pri prvom prihlásení
- Edit tenant pattern
Stránka Profile¶
Účel¶
Stránku Profile používajte na kontrolu identity používateľa, claims z aktuálneho access tokenu, zmenu jazyka a témy UI, správu šifrovaných Personal Access Tokenov a správu uložených AI quick phrases.
Súvisiaci "Flow"¶
- Príručka AI pre Architecture: quick phrases podporujú opakované architecture AI akcie
- Flow buildera: podpora pri architecture review a refinement-e
Hlavné akcie¶
- skontrolovať user details
- použiť ľavý navigation tree na prepínanie medzi User details, Security tokens a Architecture workspace phrases
- zmeniť jazyk UI
- prepnúť UI theme medzi Dark a Light
- zobraziť alebo skryť token-derived claims
- uložiť, nahradiť alebo odstrániť pomenované maskované Personal Access Tokeny pre JIRA, GitHub a GitLab; označiť jeden token pre každého providera ako default pre zdieľané Spec Connectiony; uložené hodnoty tokenov sa už nezobrazia
- prepínať záložky Architecture workspace phrases pre modules, entities, values, processes, events, policies, components, interfaces a ADRs
- označiť frázu ako obľúbenú alebo ju odstrániť
Vzhľad počas prihlasovania¶
Prihlásenie spustené z AIKOZO automaticky použije posledný vzhľad Dark alebo Light použitý na danej stránke AIKOZO v rovnakom prehliadači. Voľba zostáva zachovaná po odhlásení, pri opakovanom pokuse o prihlásenie aj v ďalších krokoch autentifikácie na rovnakej karte. Mení sa v Profile; prihlasovacia stránka nemá samostatný prepínač témy. Po prihlásení má prednosť nastavenie vášho účtu.
Bez zapamätanej voľby sa použije Dark. Samostatné odkazy na Keycloak a odkazy na obnovu hesla z e-mailu bez informácie o téme z aplikácie tiež začínajú v Dark. V zdieľanom prehliadači zodpovedá úvodný vzhľad poslednej relácii prehliadača, nie nevyhnutne osobe, ktorá sa práve prihlasuje.
Po vydaní tejto funkcie môže prvé prihlásenie s už vypršanou reláciou ešte použiť Dark, kým sa raz nenačíta aktualizovaná stránka AIKOZO. Vymazanie alebo blokovanie úložiska prehliadača môže tiež zabrániť zapamätaniu voľby; prihlasovanie zostáva dostupné.
Default bezpečnostných tokenov¶
Bezpečnostné tokeny sa ukladajú pre konkrétneho autentifikovaného používateľa a
tenant. Názov tokenu, napríklad sync_bot, je iba label, podľa ktorého
vyberáte token na osobných Spec Connectionoch alebo Delivery targetoch. Označenie
default je samostatný atribút zobrazený ako pill pri jednom uloženom tokene
pre každého providera.
AIKOZO udržiava práve jeden default token pre každého providera, keď existuje aspoň jeden token:
- prvý token uložený pre providera sa automaticky stane default
- Make default presunie označenie default na daný uložený token
- keď vymažete default token a pre rovnakého providera zostane iný token, AIKOZO označí jeden zo zostávajúcich tokenov ako default
- hodnoty tokenov sa po uložení maskujú a už sa nezobrazia
Toto označenie default je dôležité pre zdieľané Spec Connectiony. Zdieľaný Spec Connection ukladá provider routing, napríklad JIRA project alebo GitHub repository, ale nikdy neukladá Personal Access Token a nikdy nepoužíva token používateľa, ktorý connection vytvoril. Keď cez zdieľaný connection validujete, importujete alebo spúšťate Sync SPEC, AIKOZO vyhľadá váš vlastný token označený ako default pre daného providera a provider volanie vykoná ako vy. Ak vo vašom profile pre providera nie je default token, zdieľaný connection zostane viditeľný, ale provider akcie nebudú dostupné, kým token neuložíte alebo neoznačíte ako default.
Osobné Spec Connectiony používajú vybraný názov tokenu z vášho profilu a vidíte ich iba vy. Tento režim použite, keď má samotný connection zostať súkromný alebo keď má používať konkrétny pomenovaný token namiesto provider defaultu.
Nastavenie JIRA tokenu¶
AIKOZO používa šifrované JIRA tokeny uložené v používateľskom profile pri validácii Spec Connectionov, importe source issues a downstream synchronizácii Requirements alebo Use Cases. Osobné Spec Connectiony používajú vybraný názov tokenu. Zdieľané Spec Connectiony vždy používajú JIRA token aktuálneho používateľa označený ako default, takže každý používateľ pracujúci so zdieľaným connectionom potrebuje vlastný použiteľný predvolený token pre daného providera. Uložené tokeny sa zobrazujú iba maskovane; plná hodnota tokenu sa už nezobrazí.
Pre JIRA Cloud:
- Otvorte stránku Atlassian API tokenov: https://id.atlassian.com/manage-profile/security/api-tokens.
- Vyberte Create API token alebo Create API token with scopes.
- Pomenujte token pre AIKOZO, vyberte dátum expirácie a token vytvorte.
- Token ihneď skopírujte. Atlassian ho neskôr už nezobrazí.
- V AIKOZO otvorte Profile > Security tokens, vyberte názov secretu,
napríklad
jira_sync, a vložte hodnotu v tvare<atlassian-email>:<api-token>, napríkladanalyst@example.com:token. Ak sa má tento token používať pre zdieľané JIRA Spec Connectiony, použite Make default. AIKOZO tak použije JIRA Cloud basic autentifikáciu voči URL JIRA stránky nastavenej na Spec Connectione.
JIRA Cloud používa pre tento flow Atlassian account API tokeny. Ak ich váš tím nazýva PAT, použite vyššie uvedenú stránku API tokenov a nehľadajte menu Personal access tokens priamo v produkte JIRA Cloud.
Pre JIRA Data Center alebo Server:
- V JIRA otvorte menu avatara, vyberte Profile a potom Personal access tokens.
- Vyberte Create token, dajte tokenu jasný názov, voliteľne nastavte expiráciu a token vytvorte.
- Token ihneď skopírujte.
- V AIKOZO otvorte Profile > Security tokens, vyberte názov secretu,
napríklad
jira_sync, a vložte iba surovú hodnotu PAT. Ak sa má tento token používať pre zdieľané JIRA Spec Connectiony, použite Make default. AIKOZO posiela Data Center PAT ako Bearer token.
Oficiálna Atlassian dokumentácia pre Data Center PAT je dostupná na https://confluence.atlassian.com/enterprise/using-personal-access-tokens-1026032365.html.
JIRA účet, ku ktorému token patrí, musí vedieť prehliadať cieľový projekt a vytvárať alebo upravovať issues v tomto projekte. Ak vaša organizácia blokuje vytváranie tokenov alebo obmedzuje scoped tokeny, požiadajte JIRA alebo Atlassian administrátora o kontrolu token policy a oprávnení.
Nastavenie GitHub a GitLab tokenu¶
AIKOZO používa aj GitHub a GitLab tokeny uložené v Profile > Security
tokens pri validácii týchto Spec Connectionov, importe source issues a pri
synchronizácii Requirements alebo Use Cases do downstream issues. Osobné Spec
Connectiony používajú vybraný názov tokenu. Zdieľané Spec Connectiony vždy
používajú provider token aktuálneho používateľa označený ako default. Pred
použitím zdieľaného alebo osobného connectionu uložte token, ktorý vie čítať
nakonfigurovanú repository alebo projekt a vytvárať alebo upravovať issues.
GitHub connectiony používajú owner/repository; GitLab connectiony používajú
buď project ID alebo encoded repository path, napríklad group/project.
Pre GitHub repository-backed buildy použite token účtu, ktorý vie pushovať branche a otvárať pull requesty v cieľovej repository. Odporúčané repository permissions pre GitHub fine-grained PAT sú:
- Metadata: read
- Contents: read and write
- Pull requests: read and write
- Issues: read and write, keď sa ten istý token používa aj na issue sync
- Workflows: write, keď AIKOZO môže vytvárať alebo upravovať súbory pod
.github/workflows/
Pre classic GitHub PAT použite repo pre private repositories alebo
public_repo pre public repositories. Pridajte classic scope workflow vždy,
keď generovaný build výstup môže vytvoriť alebo upraviť GitHub Actions workflow
súbory pod .github/workflows/. Bez workflow oprávnenia GitHub odmietne push s
chybou, že token nemôže vytvárať alebo upravovať workflow súbory.
Po vytvorení alebo nahradení tokenu ho uložte v Profile > Security tokens. Pre osobné GitHub alebo GitLab Spec Connectiony a Delivery targety vyberte na connectione alebo targete názov uloženého tokenu. Pre zdieľané Spec Connectiony použite Make default na tokene, ktorý sa má používať pre váš účet. Pred spustením repository-backed buildov spustite validáciu connectionu alebo targetu.