Gå till innehållet

Dokument och canvas

Canvas (redigeringsytan) är dokumenteditorn som ligger vid sidan av chatten. Du skriver i den, agenten skriver i den, och ni ser samma text. Här sker det mesta av det verkliga arbetet i Colleag.

Varje dokument är en vanlig Markdown-fil i produktens Git-repo. Det du ser i canvas är den filen, formaterad.

Öppna canvas

Något av det här öppnar den:

  • Klicka på Documents överst i chatten, eller tryck Ctrl+Shift+D.
  • Be en agent öppna eller ändra ett dokument — canvas öppnas av sig själv.
  • Klicka på ett dokument i Execution plan.

Stäng den med × längst upp till vänster i canvas. Chatten breddas igen.

Hitta ett dokument

Panelen till vänster om canvas har rubriken PRODUCT DOCUMENTS. Högst upp finns Import documents, + New och väljaren Switch product. Produkter som ingår i en familj är grupperade i väljaren: familjen först, som EverTag Station · platform, och sedan medlemmarna indragna under den, som ↳ 232011 EverTag Station bat US.

Under väljaren kommer sektionerna. Var och en har en ▶-pil att fälla ut, en räknare och en ⓘ-knapp som förklarar vad sektionen innehåller.

Sektion Vad den innehåller
Engineering documents Produktens egna dokument som ett mappträd: product-level/ med en mapp per disciplin och assemblies/ med en mapp per assembly.
Shared documents · familjens namn Bara på en medlemsprodukt. Familjens dokument, lästa rakt igenom. Öppnar du ett byter arbetsytan till familjeprodukten — det är där filen hör hemma. Raderna har ett litet märke, shared.
Family members Bara på en familjeprodukt. Dess medlemsprodukter; klicka på en för att byta till den.
Expected documents De dokument Colleag förväntar sig för produktens typ och fas — dokumentmodellen. Ett som saknas visas som en platshållare med två utvägar: Create skapar det från den inbyggda mallen, N/A markerar det som inte tillämpligt med en motivering. Ett dokument som finns men ännu inte har nått den status som rutinen kräver — ett utkast där godkännande krävs — listas under Not yet at required status.
Imported originals Källfilerna under imported/ — PDF, Word, Excel, STEP, ritningar — sparade för spårbarhet. Ladda ner för att öppna; de redigeras inte i canvas. Deras extraherade text är sökbar.
ERP assemblies Strukturen som ert ERP har för den kopplade artikeln. Visas bara när organisationen har en ERP-koppling. Se ERP assemblies.

Vad arbetsytan är till för

Alla arbetsytor är inte produkter ni utvecklar. En arbetsyta som skapas för en ERP-artikel börjar som det ERP:et säger att artikeln är, och listan över förväntade dokument följer med:

Typ Vad som förväntas
Produkt vi utvecklar Hela listan: krav, konstruktion, verifiering, regulatoriskt, produktion, kunddokument. Förvalet, och det en arbetsyta utan ERP-artikel får.
Köpt artikel Leverantörens datablad eller specifikation, godkänd leverantör, materialintyg (RoHS, REACH), säkerhetsdatablad och UN 38.3-dokumentation om den innehåller batterier, samt en ankomstkontrollinstruktion.
Legoartikel Specifikation eller ritning, godkänd leverantör, kvalitetsavtal med leverantören, ankomstkontroll och ändringsmeddelanden.
Strukturnivå (fiktiv) eller tjänst Inget.

Väljaren Kind högst upp i Expected documents visar vilken lista arbetsytan följer, och ERP: purchased bredvid säger vad ERP:et kallar artikeln. När de två inte stämmer överens — en produkt ni utvecklat som kopplats till en artikel ERP:et kallar köpt — säger en ruta det och erbjuder bytet. Inget byts av sig självt, och ett byte rör aldrig något dokument: bara det som förväntas av arbetsytan ändras.

Product properties. Ja-eller-nej-fakta om produkten — innehåller batterier, har radio, säljs i EU — som lägger till de villkorade dokumenten i listan. För en köpt artikel spelar bara Contains batteries roll: den lägger till säkerhetsdatablad och UN 38.3. De andra styr dokument som bara finns i produktlistan.

Cybersecurity (CRA)

Med modulen CRA monitoring har en produkt som säljs i EU och har en dataförbindelse en rad Cybersecurity (CRA) ovanför sitt dokumentträd. Den öppnar produktens sida under Security i ikonraden, inte ett dokument: produktens tekniska akt i ett svep, och det enda stället för SBOM-uppladdning och kontroll. Själva dokumenten ligger kvar i trädet under product-level/security/; öppnar ni ett från sidan kommer ni tillbaka till chatten med dokumentet bredvid. En medlemsprodukt visar familjens översikt, där SBOM:er, logg och rapporter hålls, med en länk till familjen.

Security i ikonraden öppnar alla era produkter som omfattas: hur många träffar som väntar på bedömning, hur många som utnyttjas aktivt, varje produkts läge, modulens rutiner och statusrapporterna. Status report där skriver en CRA-statusrapport för de produkter ni väljer och sparar den som utkast bland företagsdokumenten; kryssa i Repeat every Monday för att göra den till en rutin hos den regulatoriska kollegan.

Översikten börjar med tre siffror: hur många träffar som väntar på er bedömning, hur många som utnyttjas aktivt och hur många SBOM:er som finns. Under dem finns ett kort för var och en av följande. Rader med en pil går att fälla ut för att visa mer, och de är alltid ihopfällda när ni öppnar översikten.

Varje rubrik, siffra och rad har ett litet (i) intill sig. Håll muspekaren över det för att läsa vad delen är till för — vad regelverket kräver — och hur Colleag uppfyller det. Samma text är det första en utfälld rad visar, och dokumenten under en skyldighet bär beskrivningen från dokumentmodellen. Manual intill sidrubriken öppnar det här avsnittet.

  • Obligations — riskbedömningen, SBOM per firmware-image, sårbarhetshanteringen, säkerhetsinformation till användare och EU-försäkran om överensstämmelse. Fäll ut en rad för att se dokumenten som bär den, var och ett bedömt mot den status rutinen kräver. Ett som saknas har Draft with the colleague, som skapar dokumentet från dess disposition och lämnar det till disciplinens agent.
  • Vulnerabilities — hur många träffar som väntar på er bedömning och på vilket underlag. Compiled code by subsystem fäller ut träffarna i kod som ert bygge kompilerar, grupperade per delsystem. Review with the colleague öppnar loggen och ber firmware-agenten gå igenom träffarna med er. Varje rads status förblir proposed tills ni ändrar den, eller tills ni trycker Confirm N. Då markeras alla träffar som föreslagits som ej berörda (meddelandets fil finns inte i ert bygge) som not affected i ett steg, och ert namn och datumet skrivs in på varje rad. En rad som en senare release har öppnat igen lämnas åt er att titta på.
  • SBOMs — en rad per firmware-image och release. Fäll ut en rad för att se vad den körs på, när den importerades och om byggets lista över kompilerade filer finns sparad. Lägg till en med Upload SBOM:
  • välj filen som ert bygge skriver (CycloneDX JSON, SPDX JSON eller SPDX 3 JSON-LD);
  • ange image och version;
  • ange om ni vill de medlemsprodukter som kör den;
  • lägg till byggets compile_commands.json om ni har den. Kontrollen använder den som bevis.

Originalet sparas under imported/security/sbom/ och en sammanfattningssida under product-level/security/sbom/. Publicera båda från commit-panelen. - Firmware colleague — kollegans senaste nattkörningar. - Regulation — vad som gäller och när. RED:s cybersäkerhetsregler gäller radioprodukter, CRA:s rapporteringsplikt har gällt sedan 11 september 2026 och hela CRA gäller från 11 december 2027. Fäll ut ett steg för att se vad det kräver. - Art. 14-klockan, när en träff är en sårbarhet som CISA listar som utnyttjad. Den visar fristerna för tidig varning, anmälan och slutrapport, räknade från när kontrollen hittade träffen, med utkastet ett klick bort. Inget skickas: en människa bedömer och skickar in på ENISA:s plattform.

Ask the colleague högst upp frågar i chatten vad som saknas, vad som väntar på er och vad ni bör göra först; Colleag tar in firmware-kollegan vid behov.

Check now slår upp varje komponent med version och CPE i amerikanska National Vulnerability Database. Nya träffar läggs till i sårbarhetsloggen som föreslagna rader, en per komponent, version och CVE. En träff vars meddelande namnger en källfil som ert bygge aldrig kompilerade föreslås som ej berörd, med filen angiven; resten väntar på er bedömning. En rad som redan finns i loggen läggs aldrig till igen, så det ni avfärdat förblir avfärdat; en senare release som levererar samma komponentversion läggs i stället till i radens Affected releases, med en notering när den releasen kompilerar kod som bedömningen sa saknades.

Samma kontroll körs av sig själv varje natt för varje produkt som har en SBOM. Den som laddade upp SBOM:en får firmware-kollegans morgonbriefing som en notis — vad som slogs upp, vad som är nytt, vad som väntar på bedömning, eller att körningen misslyckades — och ett klick på den öppnar översikten. En ny utnyttjad träff får också ett utkast till tidig varning under product-level/security/reports/, med tidsfristerna i Cyber Resilience Act ifyllda.

Längre ner finns rubriken COMPANY DOCUMENTS med Standards (ert bibliotek av inköpta standarder), Processes (era rutiner och SOP:er) och General documents (övriga företagsdokument). Se Standarder och SOP:er.

Små markeringar i trädet visar varje fils tillstånd:

Markering Betydelse
Röd punkt Osparat — du redigerar just nu
New Skapat men aldrig publicerat
Unpublished Sparat men inte publicerat än
Published Med i den publicerade versionen
Deleted Borttaget, väntar på publicering

Familjer och medlemmar

På en medlemsprodukt räknas familjens dokument också för medlemmen, utom de artikelbundna typerna — CE declaration of conformity, FCC filing, label artwork och sales datasheet — som varje medlem måste ha själv. Vilka typer som förväntas följer medlemmens egna egenskaper: en EU-medlem med dataförbindelse förväntas ha cybersäkerhetsdokumenten, en medlem som bara säljs i USA gör det inte. Chattens rubrik visar ett märke så att du vet var du är: family på en familjeprodukt, member of … på en medlem. Se Produktfamiljer.

Om du öppnar ett dokument från en annan disciplin byter chatten till den disciplinens agent och fortsätter i dess senaste konversation. Agenten du pratar med äger alltså alltid dokumentet du har framför dig.

Redigera och föreslå ändringar

Knappen längst upp till höger i canvas växlar mellan två lägen:

  • Editing — dina ändringar går rakt in i dokumentet.
  • Suggesting — dina ändringar märks som förslag att acceptera eller avvisa.

Samma två lägen gäller för agenten. När en agent föreslår en ändring får du en inbäddad diff: borttagen text överstruken i rött, ny text markerad i blått. Acceptera eller avvisa den. När en agent redigerar direkt uppdateras dokumentet helt enkelt och canvas laddas om.

Använd Suggesting på allt som är godkänt

På ett släppt eller godkänt dokument håller Suggesting originalet intakt tills någon har godkänt varje ändring. På en tidig draft är Editing snabbare och helt riskfritt.

Fråga agenten om det du läser

Markera text i canvas och fråga agenten om den. Din fråga går till chatten tillsammans med dokumentets sökväg och exakt det stycke du markerade, och agenten får instruktionen att bara ändra det stycket. Det här är det mest precisa sättet att få en ändring gjord — mycket bättre än att i löptext beskriva var problemet finns.

Verktygsraden i canvas

Kontroll Vad den gör
× Stänger canvas
Titel Dokumentets namn, med märket Draft när det är opublicerat och en orange punkt när det finns osparade ändringar
ⓘ Visar dokumentets egenskaper — de strukturerade fälten som ägare, status och revision
‹ Version n of m › Stega genom tidigare versioner av dokumentet
A− / A+ / 100% Zoom för visning. Bara visning — det ändrar inte vad som sparas eller exporteras
Copy Kopierar hela dokumentet till urklipp
Download Laddar ner filen
Editing / Suggesting Byter redigeringsläge

Dokumentegenskaper

Klicka på ⓘ för att öppna egenskapspanelen. Det här är de strukturerade fälten som ligger högst upp i filen — sådant som ägande disciplin, status och revision — och de styr revisionsnumreringen när du publicerar. Fält som går att redigera kan ändras direkt här.

Importera befintliga dokument

Klicka på Import documents högst upp i panelen PRODUCT DOCUMENTS för att ta in filer från Word, Excel, PDF och ritningar. Colleag läser varje fil, konverterar den till Markdown, föreslår vilken disciplin den hör till och visar en granskningsvy innan något skrivs. Originalfilen sparas under Imported originals, så att ett svar alltid kan kontrolleras mot källan.

Du bestämmer var dokumenten hamnar:

  • Innan du laddar upp kan du välja Dokumenten hamnar i: en assembly (artikeln själv, en assembly från ERP-strukturen eller en mapp som redan finns) och en disciplin. Väljer du till exempel artikeln och quality hamnar allt under assemblies/<artikel>/quality/. Lämnar du Låt Colleag föreslå gissar Colleag per fil, och väljer då bland produktens egna assemblies. Valet kommer ihåg till nästa import i samma produkt.
  • I granskningen kan du ändra typ, assembly och disciplin på varje rad. Sökvägen till höger följer med direkt. Med Sätt för markerade ändrar du alla markerade rader på en gång. Pennan bredvid sökvägen låter dig skriva den helt själv. Rader du har ändrat märks ändrad.

Det som står i sökvägskolumnen är det som sparas.

Standards i canvas

Under COMPANY DOCUMENTS visar canvas också ett träd, Standards, med de standarder som din organisation har laddat upp. Poster kan ha varningar — till exempel att ett dokument har lästs in med OCR från en skanning och bör kontrolleras mot originalet, eller att extraheringen slog i en storleksgräns och är ofullständig. Se Standarder och SOP:er.

Rapporter från chatten

En agent kan också ge dig en Word-, Excel-, PDF- eller PowerPoint-fil att ladda ner. Sparar du den rapporten i produkten behålls markdown, inte Office-filen. Se Rapporter och nedladdningar.

Spara och publicera

Att spara är inte att publicera. Dina ändringar sparas medan du arbetar, men dokumentet ligger kvar som draft tills du publicerar det. Den orange räknaren n drafts i sidopanelen visar hur mycket som väntar. Se Publicering och granskning.

Felsökning

Problem Vad du gör
Canvas öppnas inte Du måste ha en produkt vald. Agenter i Commercial, Corporate och Quality System har inga produktdokument.
En agent ändrade fel del av dokumentet Markera exakt text först och fråga sedan. Utan markering avgör agenten själv vad som ska ändras.
Din ändring försvann Kontrollera versionsstegningen — du kan titta på en äldre version.
Texten ser för liten eller för stor ut Det är zoomen. Klicka på procentsatsen för att återställa till 100 %. Den påverkar aldrig den sparade filen.

Nästa: Publicering och granskning →