---
title: DOCX-märgistused ja kommentaarid
description: Lisab DOCX-failidele programmiliselt jälgitavad muudatused ja kommentaarid ning ühendab mitme agendi parandused.
category: Legal
sublabel: Lepingud
author: LegalQuants
tags: 
license: Apache-2.0
source: https://github.com/LegalQuants/lq-skills
---

# superdoc-redlines — Mitme agendi DOCX redline’imine

## Millal kasutada

- Mitme agendi õiguslikud töövood, kus erinevad agendid toodavad muudatusi samale dokumendile
- AI-ga loodud jälgitud muudatuste rakendamine DOCX-failidele
- Mitme ülevaataja muudatuste ühendamine konfliktide lahendamisega
- Peata dokumentide teisendamine (Wordi installi pole vaja)
- Deterministlikud dokumendimuudatused stabiilsete ploki-ID-dega

## Kuidas see töötab

### Põhiuuendus

Kasutab **stabiilseid ploki-ID-sid** habraste tekstisobituste asemel. Erinevalt lähenemistest, mis üritavad teksti sisu järgi leida (ja ebaõnnestuvad, kui vorming muutub), omistab Superdoc dokumendiplokkidele stabiilsed ID-d ja rakendab muudatusi viite järgi.

### Arhitektuur

```
AI Agent output → Conflict resolution → Block ID mapping → Native Word revisions
```

### Protsess

1. **Parseeri** — Võta dokumendiplokid välja stabiilsete ID-dega
2. **Võta muudatused vastu** — AI-agent toodab muutmisjuhised
3. **Konfliktide lahendamine** — Kui mitu agenti muudavad sama plokki, lahenda konfliktid
4. **Rakenda** — Lisa Wordi jälgitud muudatused ploki-ID-de abil (mitte tekstisobituse abil)
5. **Väljund** — Natiivne DOCX Wordi revisjonimärkidega

### Kasutamine

```javascript
import { applyRedlines } from 'superdoc-redlines';

const result = await applyRedlines({
  input: './contract.docx',
  edits: agentEdits,
  agentName: 'Claude'
});
```

### Põhifunktsioonid

- **Mitme agendi ühendamine** — Mitu agenti saavad redigeerida; konfliktid märgitakse
- **Konfliktide lahendamine** — Inimese ülevaatus kattuvate muudatuste jaoks
- **Deterministlik** — Samad muudatused → sama väljund (erinevalt tekstisobituse lähenemistest)
- **Natiivsed Wordi revisjonid** — Väljund on kehtiv DOCX, mitte omandiformaat
- **Töötab peata** — Wordi installi pole vaja

## Sihtrühm ja töö kuju

Sihtrühm: advokaadid ja arendajad, kes käitavad mitme agendi DOCX-töövooge, kus mitu AI-agenti pakuvad muudatusi samale dokumendile. Advokaat on viimase abinõuna ühendaja.

Töö kuju: piiratud tehing konfliktide lahendamise kihiga. Oskus ühendab määratletud muudatused stabiilse ploki-ID järgi. Konfliktid tõstetakse esile, mitte ei lahendata vaikides.

## Ulatus ja õiguslik kasutus

See oskus pakub õiguslikku *tuge*, mitte õigusnõuannet. Ühendatud DOCX on AI-ga kokku pandud mustand natiivsete Wordi jälgitud muudatustega — mitte ülevaadatud, aktsepteeritud ega heaks kiidetud versioon.

**Privilege ja konfidentsiaalsus.** Jookseb peata, ilma vajalike võrgukõnedeta. Väli `agentName` salvestatakse Wordi revisjoni XML-i — iga muudatuse AI-päritolu on nähtav dokumendi auditijäljes. Ära maskeeri `agentName` inimülevaatajana; see väärkujutamine võib hiljem mõjutada privilege’i ja avalikustamise analüüsi.

**Vastutus.** Kvalifitseeritud advokaat peab enne aktsepteerimist, saatmist, esitamist või sellele tuginemist üle vaatama iga jälgitud muudatuse ühendatud väljundis. Advokaat otsustab, mida iga agendi muudatus väärt on; konfliktide lahendamise mootor tagab ainult, et ühendamised on deterministlikud, mitte õiged.

## Sisendinõuded

- DOCX-il peab olema stabiilne plokistruktuur (ilma õigustehalduseta, ilma DRM-ita).
- Sisend `edits` peab vastama dokumenteeritud skeemale (agendi ja ploki kaupa).
- Peatu vigase agendi väljundi peal; ära ühenda vaikides parima jõupingutusega.

## Kindlusastmed

- **Kõrge** — ühe agendi mittekattuvad muudatused, igaüks piiratud ühe plokiga.
- **Keskmine** — mitme agendi mittekattuvad muudatused.
- **Madal / Konflikt** — eri agentide kattuvad muudatused samal plokil või ühe agendi vastuolulised muudatused. Tõsta advokaadile; ära lahenda automaatselt.

## Väljaspool ulatust

- Ei sobi **allkirjastatud lepingute** ega **puhasteks lõppversioonideks** (engrossed).
- Ei sobi **litigatsiooni hoidmisel olevatele dokumentidele**.
- Ei sobi **struktuurselt vigastele DOCX-idele** ega õigustehaldusega dokumentidele.
- Ei ole heakskiidu mehhanism — Wordi revisjonimärgid näitavad AI autorlust, mitte inimese ülevaatuse olekut.

## Eskaleerimine

Peatu ja suuna vastutavale advokaadile, kui:
- kaks või enam agenti muudavad sama plokki ühildumatul viisil;
- agent väljastab vigaseid muutmisjuhiseid (skeemirikkumine);
- ühendamine kirjutaks vaikides üle olemasoleva nimetatud inimülevaataja jälgitud muudatuse;
- dokumendi olek on mitmetähenduslik (nt eelmisest voorust juba osaliselt olemas olevad jälgitud muudatused).

## Piirangud

- Keerukad pesastatud tabelid võivad vajada käsitsi ülevaatusi
- Nõuab AI-agentidelt hästi struktureeritud sisendit
- Konfliktide lahendamise kasutajaliides on lihtne