Ordre 20260912T193441Z-7358817909. Steg 1 var ikke transformen, men å rette
roadmapens R13-gate og få den ratifisert. Gaten `grep -rl "Cosmo"
skills/*/references -> 0` var usann på to uavhengige måter:
1. Ordren fanget den første: 451 av forekomstene er Azure Cosmos DB, ekte
produktinnhold. Diskriminatoren er ikke bokstaven «s» — `Cosmos <norsk
substantiv>` er genitiv av personaen (`### Cosmos tonalitet`), mens
`Cosmos DB`/`CosmosClient`/`cosmos_ru` er produkt.
2. Denne økten fant den andre: 132 persona-forekomster ligger i prosa,
tabeller, dialog-replikker og proveniens-linjer. Heading-nøytralisering
kan ikke nå dem, så «0 persona» er uoppnåelig også under den ratifiserte
formen. Operatøren ratifiserte alternativ A: gaten speiler formen, og de
132 bokføres til R13b/R14.
Tre korreksjoner av premisser som sto i ordren og STATE:
«ca 320 produkt» -> 451 (case-sensitivt nett manglet 327 lowercase
TOC-ankre + 99 identifikatorer; sann nevner 1 638)
«169 headinger» -> 401. 169 var `^## For Cosmo`-prefikset (168) og var
internt inkonsistent med sin egen topp-variant (204)
«417 matcher ingen
populasjon» -> 417 er cosmo-headinger utenfor kodefences; briefens
nevner var reell hele tiden
Fence-bevissthet er målt skadelig, ikke nødvendig: begge toggle-regler er
gale på dette korpuset (naiv toggle skjuler en ekte heading i
chain-of-thought-prompting.md, CommonMark-regelen ubalanserer
service-level-documentation-dr.md). Fence-agnostisk deteksjon finner 401
heading-linjer i nøyaktig de samme 40 variantene som fence-bevisst finner
400 i — ingen kodeblokk-linje er byte-identisk til en persona-heading. Derfor
nøkles transformen på 40 enumererte heading-tekster og ignorerer fences. En
ukjent variant kaster; en slug-kollisjon kaster. Ingenting auto-fikses.
TOC-en regenereres ikke, den rettes kirurgisk: alle 327 persona-lenker hadde
lenketekst lik én av de 40 heading-tekstene og anker lik slugify av den
(327/327, 0 avvik), så heading og TOC-entry skrives i samme operasjon og
ingen mellomtilstand etterlater en død lenke.
Ratifisert målform: `For Cosmo`, `For Cosmo Skyberg` og `For arkitekten
(Cosmo)` konvergerer på `For arkitekten`. To filer kolliderte og er adjudisert
ved å lese dem, ikke ved regel.
Verifisering (alle 7 kriterier fra ordren):
G1 persona på heading-linjer 401 -> 0
G2 døde fragmentlenker 1 -> 1 (pre-eksisterende, unntatt)
G3 produkt-forekomster 451 -> 451; `Cosmos DB|Azure Cosmos` 308 = 308
de 3 kun-produkt-filene byte-identiske
nettet validert begge veier injisert persona feller G1; genitiv feller G1;
produkt-heading og de 3 filene passerer
hele diffen 802 heading-linjer + 654 TOC-linjer, ANNET = 0
linjeantall 728 lagt til = 728 slettet
suite 1120/1120 (1097 + 23 nye)
validate-plugin 250 PASS / 0 FAIL
stikkprøve 10 filer, alle 5 skills, inkl. de 3 mest
produkt-tunge (26/20/19) — kun heading+TOC
Utenfor scope, urørt: de 4 SKILL.md, de 23 commands, CLAUDE.md, README.md,
NOTICE.md, docs/ (alt R14).
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
390 lines
14 KiB
Markdown
390 lines
14 KiB
Markdown
# Document Intelligence and Vision Processing
|
|
|
|
**Last updated:** 2026-02
|
|
**Status:** GA
|
|
**Category:** Multi-Modal AI
|
|
**Type:** reference
|
|
|
|
---
|
|
|
|
## Innhold
|
|
|
|
- [Introduksjon](#introduksjon)
|
|
- [Kjernekomponentar](#kjernekomponentar)
|
|
- [Document Layout Analysis](#document-layout-analysis)
|
|
- [Tabell- og skjemaekstraksjon](#tabell--og-skjemaekstraksjon)
|
|
- [Handskriftgjenkjenning](#handskriftgjenkjenning)
|
|
- [Pre- og postprosessering](#pre--og-postprosessering)
|
|
- [Implementeringsmønstre](#implementeringsmønstre)
|
|
- [Norsk offentleg sektor](#norsk-offentleg-sektor)
|
|
- [Beslutningsrammeverk](#beslutningsrammeverk)
|
|
- [For arkitekten](#for-arkitekten)
|
|
|
|
## Introduksjon
|
|
|
|
Azure AI Document Intelligence (tidlegare Form Recognizer) er ein spesialisert teneste for automatisert dokumentbehandling som kombinerer bransjeleiande OCR med djuplæringsmodellar for å ekstrahere tekst, tabellar, strukturar og felt frå dokument. Tenesta støttar eit breitt spekter av dokumenttypar — PDF, bilete, Office-filer og HTML — med ein enkelt API-kall, og leverer resultat i Markdown-format som er optimalisert for integrasjon med LLM-ar i RAG-pipelines.
|
|
|
|
For norsk offentleg sektor er Document Intelligence særleg relevant for digitalisering av arkiv, automatisert saksbehandling, fakturahåndtering og analyse av regulatoriske dokument. Tenesta støttar 309 trykte og 12 handskrivne språk, inkludert norsk, og gir confidence scores for kvar ekstraksjon slik at ein kan bygge robuste kvalitetskontrollrutinar.
|
|
|
|
Microsoft Foundry tilbyr no også Content Understanding som eit komplementært alternativ for meir semantisk dokumentanalyse. Valet mellom Document Intelligence og Content Understanding avheng av bruksscenarioet: Document Intelligence for presis, strukturert ekstraksjon med låg latency, og Content Understanding for meir generaliserande, LLM-driven analyse.
|
|
|
|
---
|
|
|
|
## Kjernekomponentar
|
|
|
|
| Komponent | Formål | Teknologi |
|
|
|-----------|--------|-----------|
|
|
| **Read OCR** | Tekst-ekstraksjon frå trykte og handskrivne dokument | Document Intelligence Read API v4.0 |
|
|
| **Layout Analysis** | Strukturanalyse med tabellar, avsnitt, seksjonshovud | Document Intelligence Layout API |
|
|
| **Prebuilt Models** | Ferdig trena modellar for faktura, kvittering, ID, skatt | Document Intelligence Prebuilt API |
|
|
| **Custom Models** | Trenable modellar for eigendefinerte dokumenttypar | Custom Template / Neural Models |
|
|
| **Classification** | Identifisering og splitting av dokumenttypar | Document Intelligence Classifier |
|
|
| **Batch Analysis** | Bulkbehandling av store dokumentmengder | Batch Analysis API |
|
|
|
|
---
|
|
|
|
## Document Layout Analysis
|
|
|
|
### Korleis Layout-modellen fungerer
|
|
|
|
Layout-modellen analyserer dokumentstruktur gjennom to typar roller:
|
|
|
|
1. **Geometriske roller** — Tekst, tabellar, figurar og avkryssingsfelt
|
|
2. **Logiske roller** — Titlar, overskrifter, sidefot og seksjonar
|
|
|
|
Modellen returnerer resultat i Markdown-format, noko som gjer det enkelt å mate innhaldet direkte inn i LLM-ar for vidare analyse.
|
|
|
|
### Python-implementering
|
|
|
|
```python
|
|
from azure.ai.documentintelligence import DocumentIntelligenceClient
|
|
from azure.core.credentials import AzureKeyCredential
|
|
|
|
endpoint = "https://<resource>.cognitiveservices.azure.com/"
|
|
credential = AzureKeyCredential("<api-key>")
|
|
client = DocumentIntelligenceClient(endpoint, credential)
|
|
|
|
# Analyser layout frå ein PDF-fil
|
|
with open("dokument.pdf", "rb") as f:
|
|
poller = client.begin_analyze_document(
|
|
"prebuilt-layout",
|
|
body=f,
|
|
content_type="application/pdf",
|
|
output_content_format="markdown"
|
|
)
|
|
|
|
result = poller.result()
|
|
|
|
# Markdown-output optimalisert for LLM-inntak
|
|
print(result.content)
|
|
|
|
# Iterer over tabellar
|
|
for table in result.tables:
|
|
print(f"Tabell: {table.row_count} rader x {table.column_count} kolonnar")
|
|
for cell in table.cells:
|
|
print(f" [{cell.row_index},{cell.column_index}]: {cell.content}")
|
|
```
|
|
|
|
### C#-implementering
|
|
|
|
```csharp
|
|
using Azure;
|
|
using Azure.AI.DocumentIntelligence;
|
|
|
|
var client = new DocumentIntelligenceClient(
|
|
new Uri("https://<resource>.cognitiveservices.azure.com/"),
|
|
new AzureKeyCredential("<api-key>")
|
|
);
|
|
|
|
var content = new AnalyzeDocumentContent()
|
|
{
|
|
UrlSource = new Uri("https://example.com/document.pdf")
|
|
};
|
|
|
|
var operation = await client.AnalyzeDocumentAsync(
|
|
WaitUntil.Completed,
|
|
"prebuilt-layout",
|
|
content,
|
|
outputContentFormat: ContentFormat.Markdown
|
|
);
|
|
|
|
AnalyzeResult result = operation.Value;
|
|
|
|
// Strukturert Markdown-output
|
|
Console.WriteLine(result.Content);
|
|
|
|
// Prosesser tabellar
|
|
foreach (var table in result.Tables)
|
|
{
|
|
Console.WriteLine($"Tabell: {table.RowCount}x{table.ColumnCount}");
|
|
foreach (var cell in table.Cells)
|
|
{
|
|
Console.WriteLine($" [{cell.RowIndex},{cell.ColumnIndex}]: {cell.Content}");
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Tabell- og skjemaekstraksjon
|
|
|
|
### Tabellekstraksjon
|
|
|
|
Document Intelligence identifiserer tabellar automatisk og ekstraherer:
|
|
|
|
- **Celleinnhald** med tekst og bounding boxes
|
|
- **Rad- og kolonnespenn** (merged cells)
|
|
- **Overskriftsrader** og kolonne-hovud
|
|
- **Confidence scores** per celle
|
|
|
|
### Skjemaekstraksjon med Prebuilt Models
|
|
|
|
| Modell | Bruksområde | Nøkkelfelt |
|
|
|--------|-------------|-----------|
|
|
| `prebuilt-invoice` | Fakturabehandling | Leverandør, beløp, forfallsdato, linjeposter |
|
|
| `prebuilt-receipt` | Kvitteringsanalyse | Butikk, dato, totalbeløp, varer |
|
|
| `prebuilt-idDocument` | ID-verifisering | Namn, fødselsdato, dokumentnummer |
|
|
| `prebuilt-tax.us` | Amerikanske skatteskjema | W-2, 1098, 1099, 1040 |
|
|
| `prebuilt-healthInsuranceCard.us` | Helseforsikring | Medlem, gruppe, forsikringsgivar |
|
|
| `prebuilt-bankStatement` | Bankkontoutskrift | Saldo, transaksjonar, kontoinformasjon |
|
|
|
|
### Custom Neural Models
|
|
|
|
For eigendefinerte dokumenttypar kan ein trene custom models:
|
|
|
|
```python
|
|
# Trening av custom extraction model
|
|
from azure.ai.documentintelligence import DocumentIntelligenceAdministrationClient
|
|
|
|
admin_client = DocumentIntelligenceAdministrationClient(endpoint, credential)
|
|
|
|
# Start trening med labelerte eksempel
|
|
poller = admin_client.begin_build_document_model(
|
|
build_request={
|
|
"modelId": "vedtak-modell",
|
|
"description": "Ekstraksjon av vedtaksfelt",
|
|
"buildMode": "neural",
|
|
"azureBlobSource": {
|
|
"containerUrl": "<sas-url-til-treningsdata>"
|
|
}
|
|
}
|
|
)
|
|
|
|
model = poller.result()
|
|
print(f"Modell-ID: {model.model_id}, Status: {model.status}")
|
|
```
|
|
|
|
---
|
|
|
|
## Handskriftgjenkjenning
|
|
|
|
Document Intelligence har bransjens beste handskriftgjenkjenning med støtte for 12 handskrivne språk. Systemet identifiserer automatisk om tekst er handskriven eller trykt og returnerer confidence scores.
|
|
|
|
### Handskriftsdeteksjon i JSON-respons
|
|
|
|
```json
|
|
{
|
|
"styles": [
|
|
{
|
|
"confidence": 0.95,
|
|
"spans": [
|
|
{
|
|
"offset": 509,
|
|
"length": 24
|
|
}
|
|
],
|
|
"isHandwritten": true
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
### Avkryssingsfelt (Selection Marks)
|
|
|
|
Layout-modellen identifiserer også avkryssingsfelt i skjema:
|
|
|
|
```python
|
|
if page.selection_marks:
|
|
for mark in page.selection_marks:
|
|
print(
|
|
f"Avkryssingsfelt: '{mark.state}' "
|
|
f"innanfor polygon '{mark.polygon}' "
|
|
f"med confidence {mark.confidence}"
|
|
)
|
|
```
|
|
|
|
---
|
|
|
|
## Pre- og postprosessering
|
|
|
|
### Pre-prosessering
|
|
|
|
| Steg | Teknikk | Formål |
|
|
|------|---------|--------|
|
|
| **Bildekvalitet** | Oppløysingssjekk (min 50x50 px) | Sikre lesbar input |
|
|
| **Formatvalidering** | JPEG, PNG, PDF, TIFF, DOCX, XLSX, PPTX, HTML | Verifiser støtta format |
|
|
| **Filstorleik** | Max 500 MB for standard, 25 MB for gratis tier | Unngå API-avvisning |
|
|
| **Siderotasjon** | Automatisk rotasjonsdeteksjon | Korriger skannarar |
|
|
| **Dokumentklassifisering** | Custom Classifier | Rut til rett modell |
|
|
|
|
### Postprosessering
|
|
|
|
```python
|
|
def postprocess_extraction(result, confidence_threshold=0.85):
|
|
"""Kvalitetskontroll av Document Intelligence-resultat."""
|
|
|
|
high_confidence = []
|
|
needs_review = []
|
|
|
|
for document in result.documents:
|
|
for name, field in document.fields.items():
|
|
if field.confidence >= confidence_threshold:
|
|
high_confidence.append({
|
|
"felt": name,
|
|
"verdi": field.value_string or field.content,
|
|
"confidence": field.confidence
|
|
})
|
|
else:
|
|
needs_review.append({
|
|
"felt": name,
|
|
"verdi": field.value_string or field.content,
|
|
"confidence": field.confidence,
|
|
"grunn": "Låg confidence"
|
|
})
|
|
|
|
return {
|
|
"godkjende": high_confidence,
|
|
"til_manuell_gjennomgang": needs_review,
|
|
"automatiseringsgrad": len(high_confidence) /
|
|
(len(high_confidence) + len(needs_review)) * 100
|
|
}
|
|
```
|
|
|
|
### RAG-integrasjon med Semantic Chunking
|
|
|
|
Document Intelligence sin Markdown-output eignar seg godt for semantic chunking i RAG-pipelines:
|
|
|
|
```python
|
|
from azure.ai.documentintelligence import DocumentIntelligenceClient
|
|
|
|
def chunk_document_for_rag(result):
|
|
"""Chunk Document Intelligence Markdown-output for RAG."""
|
|
|
|
chunks = []
|
|
current_chunk = ""
|
|
current_heading = ""
|
|
|
|
for line in result.content.split("\n"):
|
|
if line.startswith("#"):
|
|
if current_chunk:
|
|
chunks.append({
|
|
"heading": current_heading,
|
|
"content": current_chunk.strip(),
|
|
"type": "section"
|
|
})
|
|
current_heading = line
|
|
current_chunk = ""
|
|
else:
|
|
current_chunk += line + "\n"
|
|
|
|
# Legg til tabellar som separate chunks
|
|
for table in result.tables:
|
|
table_md = f"| {'|'.join(['---'] * table.column_count)} |\n"
|
|
for cell in table.cells:
|
|
table_md += f"| {cell.content} "
|
|
chunks.append({
|
|
"heading": "Tabell",
|
|
"content": table_md,
|
|
"type": "table"
|
|
})
|
|
|
|
return chunks
|
|
```
|
|
|
|
---
|
|
|
|
## Implementeringsmønstre
|
|
|
|
### Mønster 1: Intelligent Document Processing Pipeline
|
|
|
|
```
|
|
Dokument → Classification → Routing → Extraction → Validation → Output
|
|
↓ ↓ ↓ ↓
|
|
Custom Classifier Prebuilt/ Layout/ Confidence
|
|
Custom Neural Threshold
|
|
Model Model Check
|
|
```
|
|
|
|
### Mønster 2: Hybrid OCR + LLM
|
|
|
|
For komplekse dokument der rein ekstraksjon ikkje er nok:
|
|
|
|
1. **Document Intelligence** for presis OCR og strukturekstraksjon
|
|
2. **GPT-4o** for semantisk forståing og oppsummering
|
|
3. **Kombinert pipeline** som brukar styrken til begge
|
|
|
|
### Mønster 3: Batch Processing
|
|
|
|
```python
|
|
# Batch-analyse av mange dokument
|
|
poller = client.begin_analyze_batch_documents(
|
|
"prebuilt-invoice",
|
|
body={
|
|
"azureBlobSource": {
|
|
"containerUrl": "<sas-url>",
|
|
"prefix": "fakturaer/"
|
|
},
|
|
"resultContainerUrl": "<resultat-sas-url>",
|
|
"resultPrefix": "resultat/"
|
|
}
|
|
)
|
|
```
|
|
|
|
---
|
|
|
|
## Norsk offentleg sektor
|
|
|
|
### Relevante bruksområde
|
|
|
|
- **NAV**: Automatisert behandling av legeerklæringar, søknader og vedlegg
|
|
- **Skatteetaten**: Ekstrahering av data frå skatteskjema og næringsoppgåver
|
|
- **Kommunar**: Byggesaksbehandling med automatisk ekstraksjon frå teikningar
|
|
- **Arkivverket**: Digitalisering av historiske dokument og handskrivne protokollar
|
|
|
|
### Compliance-omsyn
|
|
|
|
| Krav | Løysing |
|
|
|------|---------|
|
|
| **GDPR** | Data prosessert i EU-regionar (Norway East, West Europe) |
|
|
| **Schrems II** | Ingen dataoverføring til USA med EU-deployment |
|
|
| **Arkivlova** | Markdown-output kan lagrast som arkivverdig format |
|
|
| **Offentleglova** | Automatisk sladding av persondata med postprosessering |
|
|
| **Sikkerheitslova** | Customer Managed Keys for kryptering |
|
|
|
|
### Dataminimering
|
|
|
|
Document Intelligence returnerer berre etterspurte felt. Ved bruk av prebuilt models kan ein filtrere output til berre relevante felt, i tråd med GDPR sin dataminimeringsprinsipp.
|
|
|
|
---
|
|
|
|
## Beslutningsrammeverk
|
|
|
|
| Scenario | Anbefaling | Begrunnelse |
|
|
|----------|------------|-------------|
|
|
| Standardiserte faktura/kvitteringar | Prebuilt Invoice/Receipt | Høg nøyaktigheit utan trening |
|
|
| Eigendefinerte norske skjema | Custom Neural Model | Fleksibel, generaliserande |
|
|
| Historiske handskrivne dokument | Layout + GPT-4o hybrid | OCR + semantisk tolking |
|
|
| Stor-skala dokumentdigitalisering | Batch API + Layout | Skalerbar, kostnadseffektiv |
|
|
| RAG-pipeline inntak | Layout med Markdown output | LLM-vennleg format |
|
|
| Klassifisering av blanda dokument | Custom Classifier → Router | Automatisk dokumenttype-ruting |
|
|
| Sensitive dokument (helse, rettsvesen) | On-premises container + CMK | Maksimal datakontroll |
|
|
|
|
---
|
|
|
|
## For arkitekten
|
|
|
|
- **Document Intelligence v4.0 GA** er bransjeleiande for OCR og strukturekstraksjon — 309 trykte og 12 handskrivne språk, inkludert norsk, med Markdown-output optimalisert for LLM-integrasjon
|
|
- **Prebuilt models** (invoice, receipt, ID, tax) gir umiddelbar verdi utan treningskostnad, medan Custom Neural Models handterer eigendefinerte norske dokumenttypar
|
|
- **Batch Analysis API** muliggjer kostnadseffektiv prosessering av store dokumentmengder — kritisk for digitaliseringsprosjekt i offentleg sektor
|
|
- **Hybrid-mønsteret Document Intelligence + GPT-4o** kombinerer presis ekstraksjon med semantisk forståing — bruk DI for strukturdata og GPT-4o for tolking og oppsummering
|
|
- **Content Understanding** er det nye alternativet for meir generalisert dokumentanalyse — evaluer begge for kvar brukscase og vel basert på behov for presisjon vs. fleksibilitet
|