Hoppa till innehållet
POLARISAI ACADEMY
R05-301 · Navigatör

Gränssnitt för AI: streaming, osäkerhet och godkännanden

Efteråt kan du reservera en svarsruta på 192 px så att en färdig ström får layoutförskjutning 0, hålla uppläsningen till två statusbyten, märka en mening vars faktum saknas i båda källorna, och hålla en radering avstängd tills kryssrutan för sammanfattningen är ibockad.

Nivå
Navigatör
Tid
25 h (uppskattning)
Förkunskap
R05-201, R02-201
Kurs 3 av 4
Hoppa till

Efter kursen kan du

Eleven kan bygga ett gränssnitt för en AI-arbetsyta som implementerar deterministiska tillståndsövergångar genom strömning, citatgranskning, diff-förhandsvisning, avbrott från användaren, återhämtning från upstream-fel och obligatorisk bekräftelse före destruktiva åtgärder.

Reservera rutan, strömma inuti den

Tokenströmning, streaming, målar svaret en bit i taget. Svarsrutan är en tom låda redan i första målningen, 1280 px bred, med min-height 192 px. Åtta rader på 24 px är 8 × 24 = 192. Åtgärdsraden under rutan är 1280 gånger 56, och de två lådorna delar vänsterkant. Bitarna läggs till inuti rutan. Rutan finns redan i kolumnen, så första biten skjuter inte in en ny låda ovanför raden.

En förflyttning räknas som påverkansandel gånger avståndsandel, samma produkt som i tisdagsdiagrammet. Påverkansandelen är fönstrets andel av unionen av den gamla lådan och den nya, för varje element vars startposition ändrats. Avståndsandelen är den största förflyttningen delad med den längre sidan av fönstret. En låda som växer nedåt och behåller sin startposition står utanför den unionen. Sidan använder ett fönster på 1280 gånger 800. Arean är 1280 × 800 = 1024000, och den längre sidan är 1280.

Utan reserverad höjd är det färdiga svaret 192 px högt och åtgärdsraden flyttas ned 192 px. Flytten är större än radens höjd, så den gamla rutan och den nya rutan överlappar inte. Unionens area är summan av de två rutorna, 1280 × 56 × 2 = 143360. Påverkansandelen är 143360 / 1024000 = 0,14, alltså 7/50. Avståndsandelen är 192 / 1280 = 0,15. Poängen är 0,14 × 0,15 = 0,021, alltså 21/1000. Det ligger över gränsen 0,02 från tisdagssidan. Med min-height 192 px satt före första biten behåller åtgärdsraden sin startposition, inget element flyttas, och poängen är 0. Över 192 px rullar rutan internt, med overflow-y satt till auto. En nionde rad ändrar text inuti rutan och lämnar åtgärdsraden kvar, så poängen stannar på 0.

Statusraden talar två gånger

Tokenlådan har aria-live satt till off. Texten i den ändras vid varje bit. En uppläst tokenlåda skulle läsa varje bit. Statuselementet är samma role status som du redan använde för hållningsmeningen. Det ligger i första målningen, tomt. Role status betyder aria-live polite och aria-atomic true, så en skärmläsare väntar in en paus och läser sedan hela strängen. I den fulla spårningen lägger sidan till 48 bitar. Statussträngen ändras två gånger. Den blir Writing a reply när tillståndet går till streaming, och Reply ready när bit 48 för tillståndet till ready. Tokenlådan ger 0 uppläsningar. Räknaren för markeringar är ett vanligt element, utanför varje live-region, så en senare ändring i räknaren lägger inte till någon uppläsning.

Rutans aria-busy är true medan tillståndet är streaming, och false när tillståndet lämnar streaming. Stop är en knapp med namnet Stop, synlig bara i streaming. Ett klick för streaming till stopped, lämnar de målade bitarna i rutan, och sätter status till Stopped at 18 tokens efter 18 bitar. Den vägen har fortfarande två statusbyten. Den lagrade anteckningen är orörd, och Apply ligger avstängd, eftersom spårningen stannade före bit 48. Ett avbrott i förbindelsen efter samma 18 bitar för streaming till error och sätter status till Reply failed at 18 tokens. The note was not changed. Läsaren hör hela den strängen i ett svep. Retry tömmer rutans text till tomt inne i samma låda på 192 px, för tillståndet tillbaka till streaming, och sätter status till Writing a reply igen. Åtgärdsraden flyttas inte av den tömningen.

Märk ett faktum som båda källorna saknar

Två källor ligger i fönstret. U är användarens meddelande. N är anteckningen. Ett faktum på den här sidan är ett av fyra slag: en klocktid skriven som siffror, ett kolon och siffror; en veckodag från Monday till Sunday; ett personnamn från den slutna listan Dana, Sam och Rio; eller ett heltal som står som ett eget ord, avgränsat av mellanslag eller skiljetecken. En klocktid tar sina siffror, så 14:00 är ett faktum, och bitarna 14 och 00 står utanför faktlistan. Ett faktum är täckt när samma sträng finns i U eller i N. Varje otäckt faktum sätter ordet check på sin mening, och räknaren ökar med ett för den meningen.

Källraden öppnas under meningen, inuti rutan som rullar. Knappens synliga text och dess tillgängliga namn är samma sträng, Sources for sentence 3, med siffran som hör till meningen. Raden citerar U, citerar N och namnger det otäckta faktumet. När raden stängs försvinner den. Raden lämnar åtgärdsradens startposition i fred, eftersom de extra raderna rullar inne i rutan på 192 px.

U är Move the Tuesday hold for Dana to 14:00 and keep the note. N är Desk 14, Dana, Tuesday, projector. Mening 1 lyder Hold moved to 14:00 for Dana. Faktalen 14:00 och Dana finns båda i U, så mening 1 saknar markör. Mening 2 lyder The projector stays on Desk 14. Heltalet 14 som eget ord finns i N. Projector ligger utanför de fyra faktslagen, så mening 2 saknar markör. Mening 3 lyder The room fee is 40. Heltalet 40 som eget ord finns i ingen av källorna, så mening 3 märks check. Mening 4 lyder Sam confirmed the move. Sam finns i ingen av källorna, så mening 4 märks check. Räknaren står på 2. Källraden för mening 3 säger att 40 saknas i båda citaten. Källraden för mening 4 säger att Sam saknas i båda citaten.

Diff, rollback och grinden för radering

En anteckning går att ångra, så sidan visar en diff innan den skriver. En diff är listan över ord som tillkommer och ord som försvinner. Review bygger diffen och lämnar den lagrade anteckningen som den är. Ta bort kommatecken och punkter, dela vid mellanslag och släpp tomma bitar. Tillagda ord är de extra exemplaren i den föreslagna listan, i den listans ordning. Borttagna ord är de extra exemplaren i den nuvarande listan. Den nuvarande anteckningen är Desk 14, Dana, Tuesday, projector. Den föreslagna är Desk 14, Dana, Tuesday 14:00, projector. Nuvarande ord är Desk, 14, Dana, Tuesday, projector: 5 ord. Föreslagna ord är Desk, 14, Dana, Tuesday, 14:00, projector: 6 ord. Tillagt är det enda ordet 14:00. Borttaget är 0. Förhandsvisningen visar båda hela strängarna, det tillagda ordet och antalet borttagna. Den lagrade anteckningen är fortfarande Desk 14, Dana, Tuesday, projector. Mening 3 och mening 4 ligger kvar i svaret med sina check-markörer. De förs inte in i den föreslagna anteckningen. Räknaren stannar på 2 som en varning på svaret. Apply är påslagen i preview, eftersom den här redigeringen bara byter anteckningens sträng och Rollback kan skriva tillbaka den föregående strängen.

Apply kopierar den föreslagna strängen till anteckningen och behåller den föregående strängen bredvid. Tillståndet går från preview till applied. Rollback är knappen med namnet Rollback, den skriver tillbaka den sparade texten. Ett klick skriver den sparade strängen och för tillståndet tillbaka till preview. Efter Apply och därefter Rollback är anteckningen Desk 14, Dana, Tuesday, projector. Förskjutningen för det textbytet är 0, eftersom anteckningen ligger i en låda vars höjd redan var reserverad och vars startposition ligger stilla.

Delete hold tar bort posten, så sidan behandlar den som oåterkallelig. Klicket raderar ingenting. Det öppnar en dialog och för tillståndet från preview till blocked. Antalet hållningar är fortfarande 1. Dialogen lyder Delete 1 hold for Dana at Desk 14 on Tuesday? Kryssrutan lyder I have read the one-line summary. Medan kryssrutan är tom ligger bekräftelseknappen Delete hold now avstängd, och ett klick på den ändrar antalet hållningar med 0. Cancel stänger dialogen, för tillståndet tillbaka till preview och lämnar antalet hållningar på 1. En ibockad ruta slår på Delete hold now. Bekräftelsen sätter antalet hållningar från 1 till 0 och för tillståndet tillbaka till preview. I den räknade vägen trycker läsaren Cancel, så antalet hållningar stannar på 1. Tillstånden på anteckningens väg är idle, streaming, ready, preview, applied och preview igen: Send, bit 48, Review, Apply, Rollback. Det är 5 övergångar, och anteckningen slutar på den ursprungliga strängen.

Ett exempel

Tisdagssvaret, räknat rakt igenom

Rutan är 1280 gånger 192 i första målningen, i ett fönster på 1280 gånger 800 med arean 1024000. Ett oreserverat fall där åtgärdsraden 1280 gånger 56 flyttas 192 px ger poängen 0,021. Den reserverade rutan ger 0, och en nionde rad som rullar inuti rutan ger också 0. Tokenlådan har aria-live off. aria-busy är true bara medan tillståndet är streaming.

Den fulla spårningen lägger till 48 bitar. Statussträngen ändras två gånger, först till Writing a reply och sedan till Reply ready. Tokenlådan läser upp 0 gånger. Räknaren är vanlig text. Mening 3 och mening 4 märks check, för de otäckta faktalen 40 och Sam, så räknaren står på 2. Varje källrad citerar U och N.

Diffen lägger till det enda ordet 14:00 och tar bort 0. Apply skriver Desk 14, Dana, Tuesday 14:00, projector. Rollback återställer Desk 14, Dana, Tuesday, projector. En andra spårning trycker Stop efter 18 bitar. Status blir Stopped at 18 tokens, Apply ligger avstängd, och anteckningen ligger kvar på den ursprungliga strängen. Ett avbrott vid samma antal sätter Reply failed at 18 tokens. The note was not changed. Delete hold och därefter Cancel lämnar antalet hållningar på 1.

Övning

Kolla på papper

Använd samma fönster 1280 gånger 800, samma åtgärdsrad 1280 gånger 56 och samma faktaregler. Rutan reserverades på 144 px och svaret målar 192 px, så raden flyttas 48 px. Räkna unionens höjd, påverkansandelen, avståndsandelen och poängen. U är Add Rio to the Tuesday note. N är Desk 14, Dana, Tuesday, projector. Märk varje mening och säg vad räknaren står på: Rio is added to the Tuesday note. The fee becomes 40. Dana keeps Desk 14. Skriv diffen från N till Desk 14, Dana, Tuesday, projector, Rio. Ta sedan en ström som Stop avbryter vid 9 bitar. Ange de två statussträngarna, antalet uppläsningar från tokenlådan, om Apply är påslagen, anteckningen efter Stop, och antalet hållningar efter Delete hold följt av Cancel.

Flytten är mindre än radens höjd, så unionens höjd är 56 + 48 = 104. Unionens area är 1280 × 104 = 133120. Påverkansandelen är 133120 / 1024000 = 0,13, alltså 13/100. Avståndsandelen är 48 / 1280 = 0,0375. Poängen är 0,13 × 0,0375 = 0,004875, alltså 39/8000. Mening 1 har Rio och Tuesday, båda i U, så den saknar markör. Mening 2 har heltalet 40 som eget ord, i ingen av källorna, så den märks check. Mening 3 har Dana och heltalet 14 som eget ord, båda i N, så den saknar markör. Räknaren står på 1. N har 5 ord. Den föreslagna listan är Desk, 14, Dana, Tuesday, projector, Rio: 6 ord. Tillagt är Rio. Borttaget är 0. Statussträngarna är Writing a reply och därefter Stopped at 9 tokens. Tokenlådan läser upp 0 gånger. Apply ligger avstängd. Anteckningen ligger kvar som Desk 14, Dana, Tuesday, projector. Antalet hållningar stannar på 1.

Kontrollfrågor

Svara själv först. Öppna sedan frågan för att se svaret.

På sidan med fönstret 1280 gånger 800, vilken layoutförskjutning ger åtgärdsraden 1280 gånger 56 när den flyttas ned 192 px, och vilken poäng har rutan när 192 px var reserverat före första biten?

0,021 när raden flyttas 192 px, och 0 när rutan var reserverad. Den reserverade poängen stannar på 0 när en nionde rad rullar inuti rutan.

Den fulla spårningen lägger till 48 bitar och når ready. Hur många gånger ändras statussträngen, vilka är de två strängarna, och hur många uppläsningar ger tokenlådan?

Statussträngen ändras två gånger: Writing a reply, sedan Reply ready. Tokenlådan ger 0 uppläsningar, eftersom aria-live är off.

I tisdagssvaret med fyra meningar, vilka fakta är otäckta, vilka meningar märks check, och vad står räknaren på?

40 är otäckt i mening 3, och Sam är otäckt i mening 4. De två meningarna märks check. Räknaren står på 2.

Efter Apply och därefter Rollback, vad är den lagrade anteckningen? Efter Delete hold och därefter Cancel, vad är antalet hållningar, och vad gör bekräftelseknappen medan kryssrutan är tom?

Anteckningen är Desk 14, Dana, Tuesday, projector. Antalet hållningar stannar på 1. Delete hold now ligger avstängd, och ett klick på den ändrar antalet hållningar med 0.

Ta med dig

Rutan på 192 px håller den här strömmens förskjutning på 0, statusraden ändras två gånger, en mening märks check när dess faktum saknas i både U och N, Apply skriver bara strängen som diffen visade, och Delete hold now ligger avstängd tills kryssrutan är ibockad.

Slutuppgift

Lämna in ett AI-gränssnitt som testas med 30 automatiska tillståndsmaskintester i Playwright som verifierar rendering av SSE-ström, avbrott av strömmen med 1 klick, diff-förhandsvisning före apply, ARIA-liveuppdateringar och blockerad körning tills grinden för mänskligt godkännande är bekräftad.

Slutuppgiften rättas av fasta facit och automatiska tester när proven öppnar.

Begrepp i kursen

Kursen har inga egna begrepp i ordlistan ännu. Begrepp från tidigare kurser används här också.

Fler lektioner kommer

Första lektionen är öppen att läsa. Resten av kursens lektioner skrivs, och prov och diplom kommer senare. Till väntelistan