Záložky a pracovné priestory¶
Táto stránka vysvetľuje viditeľné používateľské plochy produktu. Záložka Settings je zámerne vynechaná. Otvorte ju vtedy, keď sa chcete rýchlo zorientovať, na čo slúži každá hlavná záložka ešte predtým, než začnete pracovať v konkrétnom workflow. Najviac pomáha novým používateľom, ktorí už majú prístup do aplikácie, ale ešte nevedia, kam ísť ďalej. Krátke prečítanie zaberie asi tri až päť minút.
Note
Niektoré záložky sú viditeľné iba pre určité roly alebo konfigurácie feature flagov.
Ako používať túto príručku¶
Každá stránka príručky odpovedá na trochu inú otázku:
- Účel a pracovný model pre základné koncepty a roly artefaktov
- Flow projektového pracovného priestoru, "Flow" analytika, Planning flow a "Flow" buildera pre odporúčanú pracovnú postupnosť
- Referencia stránok pre účel konkrétnych stránok, hlavné akcie a popup modaly
Hlavné záložky¶
Projekty (Projects)¶
V záložke Projects vytvoríte projekt, vyberiete jazyk projektu a nastavíte režim prístupu. Zo stránky projektu sa dostanete k systémovej mape:
- časť Specification (What) ukazuje špecifikácie, Epics, Use Cases a Requirements
- ak je zapnuté Planning, karta Planning (Ready) ukazuje spec-scoped Plans, Scopes, Estimates, Risks a Effort drivers
- časť Implementation (How) ukazuje implementácie, features, Architecture alebo buildy, Delivery packagey, Targets a sady inštrukcií
Detail projektu je zároveň miestom, odkiaľ otvoríte projektové zoznamy špecifikácií, implementácií a Plans. V praxi je to často prvá záložka, ktorú ľudia otvoria, keď sa potrebujú zorientovať v novom tenant-e alebo si overiť, v ktorom projekte majú pokračovať.
Špecifikácie (Specifications)¶
V záložke Specifications prehliadate položky špecifikácií v rámci dostupného projektového rozsahu. Pri väčšine analytickej práce najprv otvorte Workspace v riadku špecifikácie; poskytne guided prípravu pred tým, než vás pošle do detailných nástrojov pre Epics, Requirements, Use Cases, Test Cases, Ubiquitous Language a Gap analysis. V cross-project pohľade sú specifications zoskupené podľa projektu a zobrazujú svoj key aj description, aby sa dali ľahšie rozoznať. Vyhľadávanie filtruje dostupný výsledkový set ešte pred stránkovaním a Load more pokračuje cez ďalšie zhody.
Implementácie (Implementations)¶
V záložke Implementations prehliadate alebo vytvárate implementačné kontajnery. Z implementation potom spravujete features a podľa možností aj build joby. Builder-side práca zvyčajne začína práve tu, pokiaľ ste do implementation nevošli cez detail projektu. V cross-project pohľade sú implementations zoskupené podľa projektu a zobrazujú svoj key, prepojenú specification a description, ak je dostupný. Vyhľadávanie filtruje dostupný výsledkový set ešte pred stránkovaním a Load more pokračuje cez ďalšie zhody.
Plány (Plans)¶
V záložke Plans prehliadate plánovacie kontajnery. Nové Plans sú viazané na
Specification a obsahujú jeden Planning Scope pre každý vybraný Epic. Každý
Scope vlastní AI-backed hodnotenia pre danú plánovanú časť a má vlastnú stránku
pre generovanie, kontrolu, prepísania a prijatie baseline. Plans sú dostupné
iba vtedy, keď je Planning zapnutý a vaša rola to povoľuje. Hodnotenia bežia na
pozadí, vytvárajú samostatné analýzy Full a Active Scope aj kanonický effort
split položiek. Prijaté Scope estimates a nemenné revízie Minimum Baseline
zobrazujú freshness a explicitné reconciliation. Ukladajú použitú verziu
profilu odhadu a pri zlyhaní alebo nahradení zostávajú auditovateľné.
Keď potrebujete krok za krokom prejsť od specification scope k prijatému
planning baseline a voliteľnému effort allocation, použite
Planning flow. Plans vyžadujú CAP_PLANNING a sú viditeľné
pre roly Admin a Planner.
Použitie AI (AI Usage)¶
Záložku AI Usage otvorte vtedy, keď si potrebujete rýchlo overiť, ako sa AI v tenant-e používa. Je to miesto pre praktické otázky typu: „Vyskočilo dnes používanie?“, „Ktorá feature alebo model to spôsobila?“ alebo „Je už tento mesiac vyčerpaný zahrnutý rozpočet?“ Nepotrebujete žiadnu špeciálnu prípravu, stačí mať prístup na stránku, a bežná kontrola zaberie jednu až dve minúty.
V tejto záložke môžete:
- sledovať odhadované náklady v čase
- skontrolovať vstupné a výstupné tokeny spolu s odhadovanými nákladmi
- porovnať rozpad podľa funkcionality a podľa modelu
- sledovať AI fakturáciu tenantu pre zvolený fakturačný mesiac podľa UTC
- prepínať predchádzajúci, nasledujúci a aktuálny fakturačný 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
- stiahnuť mesačný report používania so stĺpcami kľúč a názov projektu
- vidieť, či je prémiová brokerage už aktívna alebo sa aktivuje až po vyčerpaní zahrnutého rozpočtu
- prezrieť posledné AI udalosti
Táto záložka slúži na prehľad, nie na úpravu artefaktov.
O aplikácii (About)¶
V záložke About si overíte nasadenú verziu, edition a aktívne feature flagy. Hodí sa to hlavne vtedy, keď sa správanie líši medzi prostrediami a potrebujete si potvrdiť, či naozaj pozeráte na rovnaké capabilities ako iný tím alebo deployment.
Tenant (Tenant)¶
V záložke Tenant vidíte aktívny tenant kontext. Pre oprávnených používateľov tu sú:
- používatelia tenant-u
- aktuálne tenant roly, active alebo inactive status a čas poslednej aktivity pre každého zobrazeného používateľa
- pre používateľov s rolou Manager flow na vytvorenie používateľa s validáciou username, emailu, mena, priezviska, dočasného hesla a priradených rolí
- pre používateľov s rolou Manager akcia na deaktiváciu aktívnych používateľov tenant-u
- tenant predvoľby formátu, ktoré definujú výstupné štandardy pre budúce AI generovania; ďalšia predvoľba sa vytvára duplikovaním existujúcej a názov predvoľby môže mať najviac 16 znakov; odstránenie sa uloží po potvrdení, ak predvoľbu ešte nepoužíva projekt
Táto záložka je prevažne administratívna, takže väčšina end userov ju otvára len vtedy, keď potrebuje spravovať používateľov, predvoľby formátu alebo zdieľanú tenant-level konfiguráciu.
Výber AI promptov používa nastavenia aktívneho tenanta. Bez explicitného výberu používa každá akcia vlastný predvolený prompt (napríklad generovanie a vylepšenie Use Case majú samostatné predvoľby). Vylepšenie použije predvoľbu formátu projektu alebo predvoľbu tenanta, ak projekt nemá vlastný výber.
Profil (Profile)¶
V záložke Profile vidíte svoje používateľské údaje, jazykové nastavenie, claims odvodené z aktuálneho access tokenu a aj uložené AI rýchle frázy. Frázy sú zoskupené v Architecture workspace phrases podľa akcie a záložky pracovného priestoru Architecture a v Specification workspace phrases podľa Requirements, Use cases a Test cases. Práve tu ich môžete označiť ako obľúbené alebo ich odstrániť. Je to krátka stránka, ale časom je veľmi užitočná, ak opakujete podobné AI prompty a nechcete ich písať stále odznova.
Dôkazy kontextového asistenta¶
Asistenti špecifikácie a implementácie vyhodnotia otázku, nadväzujúce otázky a opravy pred výberom dôkazov. Načítajú iba naplánované rodiny artefaktov a podľa potreby ich podrobný obsah. Publikované organizačné dôkazy vyhľadávajú iba vtedy, keď ich otázka vyžaduje. Pred odpoveďou sa posúdi relevantnosť získaných úryvkov; citácie odkazujú na dôkazy dodané pre danú odpoveď.
Počty kolekcií sú úplné iba vtedy, keď stránkovanie potvrdí načítanie celej kolekcie. Čiastočný výsledok nie je celkový počet a skrátené detaily nepotvrdzujú úplné pokrytie obsahu. Odpovede uvádzajú cielený, úplný rozsah metadát kolekcie, čiastočný alebo nedostatočný rozsah dôkazov. Nejasná požiadavka môže vyžadovať spresnenie pred vyhľadávaním.
Implementácia najprv overí vybraný artefakt a jeho nadradené artefakty. Potom môže sledovať vybrané väzby, napríklad Funkcia → Prípad použitia → Požiadavka alebo odkaz na aktuálnu architektúru. Prechádzanie má limit dvoch krokov a spoločný rozpočet vyhľadávania. Nedostupné odkazy, nerozlíšené ľudské odkazy a vyčerpané limity sa označia ako neúplné reťazce. Samotná väzba nepotvrdzuje faktickú správnosť. Zmeny naďalej podliehajú existujúcej kontrole a schváleniu návrhov.
Prompty AI asistenta¶
Asistenti projektového pracovného priestoru, nastavenia projektu, kontextoví asistenti (vrátane pracovného priestoru podpory) a asistent prípadu podpory zobrazujú pod odoslaným promptom tenký stavový pásik s menším písmom a animovanými bodkami počas celého spracovania. Animácia zostáva aktívna pri obnovení obsahu konverzácie a zastaví sa po dokončení alebo zlyhaní operácie. Projektový pracovný priestor v pásiku uvádza aj aktuálnu fázu a počty pokrytia. Výsledky otvoríte symbolom ▤, dostupným aj pri dokončenej odpovedi. Ovládacie prvky so symbolmi majú popisy pri prejdení myšou aj pre čítačky obrazovky. Pri zlyhaní zostáva viditeľná chyba a ovládací prvok ↻ na opakovanie. Pásik nikdy nepresiahne šírku svojho promptu. Stav aj chyby sú zarovnané doprava, text sa zalamuje v rámci tejto šírky a vodorovné pretečenie je skryté.
Rozpoznaný Zámer sa zobrazí pod každou požiadavkou hneď po získaní overeného výsledku plánovania. Animovaný stav pokračuje počas vyhľadávania aj tvorby odpovede. Pri zakladaní projektu sa zámer odvodzuje v rovnakej odpovedi modelu ako samotná odpoveď a zobrazia sa spoločne. Zámer sa zobrazuje iba pod požiadavkou používateľa; rozhranie skrýva nadbytočné nadpisy odvodeného zámeru a ich metadáta JSON v existujúcich aj nových odpovediach asistenta vrátane kopírovaných odpovedí.
Asistenti vyhodnocujú aktuálnu požiadavku podľa posledných úplných výmen v konverzácii a aktuálneho stavu návrhu. V podporovanom postupe kontroly môžu pokyny „vytvor“, „ulož“ alebo „uprav“ pripraviť zmenu na posúdenie; jej použitie alebo zverejnenie naďalej vyžaduje schválenie. Ak cieľ zostáva nejednoznačný, asistent pred vyhľadávaním či zmenou položí jednu konkrétnu otázku. Pri nedostupnej akcii uvedie iba konkrétny dôvod. Nastavenie projektu pri nejasnej alebo nepodporovanej požiadavke zachová návrh bez zmeny; asistent pracovného priestoru podpory zostáva iba na čítanie.
V odpovedi kontextového asistenta kliknite na citáciu alebo jej kartu Načítané dôkazy, aby ste zobrazili text zdroja zachytený pre danú odpoveď. Podklady organizácie zobrazujú názov zdroja a pôvodný úryvok. Staršie citácie zachovávajú vlastný zachytený text aj vtedy, keď novšia odpoveď použije rovnaké označenie citácie.
Odoslané správy asistenta sa ukladajú do vašej osobnej knižnice promptov v aktuálnom tenantovi. V Profile → Prompty AI asistenta ich môžete označiť ako obľúbené alebo odstrániť. K dispozícii sú štyri skupiny: Projektový pracovný priestor, Nastavenie projektu, Kontextový a Prípad podpory. Projektový pracovný priestor a nastavenie projektu majú samostatnú históriu a obľúbené prompty. Karta Kontextový zoskupuje prompty podľa kontextu spustenia, napríklad Špecifikácia, Požiadavky, Epiky, Implementácia, Funkcia, Architecture alebo Podpora. Výber promptov kontextového asistenta zobrazuje len prompty jeho vlastného kontextu. Súvisiace zobrazenia rovnakého kontextu zdieľajú skupinu (napríklad Implementácia a pracovný priestor implementácie). Staršie kontextové prompty bez údaja o spustení zostávajú spravovateľné v skupine Neklasifikované a nezobrazujú sa vo výbere konkrétneho kontextu. Každá skupina (aj každý kontext spustenia na karte Kontextový) uchováva 20 najnovších neobľúbených promptov a všetky obľúbené. Zrušenie označenia staršieho obľúbeného promptu ho môže vyradiť z nedávnej histórie.
Prázdna konverzácia zobrazuje najviac päť uložených promptov, najskôr obľúbené, a samostatné Príklady. Kliknutím na malý symbol ▴ nad poľom správy alebo stlačením šípky hore pri úprave správy otvoríte zoznam promptov s vyhľadávaním. Symbol má trvalé orámovanie v tvare karty napojené na deliacu čiaru nad poľom správy a pri otvorenom zozname smeruje nadol (▾). Opätovným kliknutím zoznam zatvoríte. Šípka dole alebo Escape ho zatvorí a vráti kurzor do správy; výber promptu ho tiež zatvorí. Výber vloží text na poslednú pozíciu kurzora alebo nahradí označený text bez odoslania. Spravovať prompty v otvorenom zozname otvorí príslušnú skupinu Profilu na novej karte. Ak chcete uložiť upravený prompt, upravte ho v poli správy a odošlite.
Ukladajú sa len vaše nové, úspešne odoslané správy. História konverzácie, správy iných používateľov, odpovede a vyhľadané dôkazy sa neimportujú. Opätovné použitie zachováva kontext a oprávnenia aktuálneho asistenta. Chyba ukladania promptu správu nezruší ani znova neodošle. Pri vypnutej autentifikácii sa knižnica ukladá v tomto prehliadači. Prihlásené relácie používajú Profil a pri chybe neprechádzajú na lokálne úložisko.