Modul 4 – Verktyg, agenter och automation

Tillbaka till kursens startsida. Föregående modul: Modul 3 – Designa din bundle.

Denna modul visar hur agenter och verktyg kan skapa, validera och konsumera OKF-bundles, samt hur CI-checks automatiserar kvalitetskontroll.

1. Agenter och verktyg kring OKF

En referens-agent kan typiskt hantera fyra operationer på en bundle:

  • create – generera nya koncept-filer från en källa (t.ex. en

BigQuery-tabell eller en Confluence-sida) med korrekt frontmatter.

  • validate – kontrollera att alla koncept har ett giltigt

type-fält och parsebar YAML.

  • enrich – komplettera befintliga koncept med länkar, taggar

eller beskrivningar, baserat på nya källor.

  • visualize – rendera bundlens korslänkningar som en graf, för

mänsklig granskning.

Google Cloud Knowledge Catalog-repot innehåller ett proof-of-concept för en sådan agent samt en enkel grafvisualisering, se README för OKF-verktygen.

2. CI-pipelines och validering

Lab-repot innehåller en minimal bundle i lab/okf-minimal-bundle/ och en workflow-fil i .github/workflows/validate-okf.yml som kör ett valideringsskript mot bundlen vid varje push och pull request. 

name: Validate OKF bundle
on: [push, pull_request]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"
      - name: Install dependencies
        run: pip install pyyaml
      - name: Validera OKF-bundle
        run: ./scripts/validate_okf.sh lab/okf-minimal-bundle

Valideringsskriptet kontrollerar bland annat:

  • Att all frontmatter är parsebar YAML.
  • Att type inte är tomt i något koncept.
  • Att index.md och log.md följer sina reserverade regler.

3. Labbövning: arbeta med bundlen

  1. Klona kursens repo och gå till lab/okf-minimal-bundle.
  2. Skapa en ny branch, t.ex. git checkout -b lab/mitt-koncept.
  3. Lägg till ett nytt koncept, t.ex. metrics/conversion_rate.md

med frontmatter enligt exemplet i Modul 2.

  1. Kör valideringsskriptet lokalt: ./scripts/validate_okf.sh lab/okf-minimal-bundle.
  2. Committa och pusha branchen, öppna en pull request.
  3. Läs CI-resultatet i pull requesten och åtgärda eventuella fel

innan merge.

4. Integration med Knowledge Catalog och andra plattformar

OKF-bundles kan konsumeras direkt av Google Cloud Knowledge Catalog, men även av andra verktyg som redan hanterar hierarkisk markdown, som Obsidian, Notion eller MkDocs. Eftersom formatet är fristående från plattform krävs ingen SDK för att läsa eller skriva bundles.

Kursen är nu genomgången. Gå tillbaka till startsidan för en översikt över samtliga moduler.