Skip to main content
openai tutorialOpenAI tutorial

Tutorial 09: Custom Legal Skills, Guardrails & Agents (OpenAI)

Build custom skills for your firm's workflows, create compliance guardrails, and deploy multi-agent systems for complex legal tasks.

Wat je leert

Deze tutorial laat zien hoe je aangepaste juridische skills bouwt, veiligheidscontroles (guardrails) toevoegt en multi-agent-workflows uitvoert met OpenAI. Enige technische vaardigheid is vereist.

Expertniveau

Ontwikkelvaardigheden aanbevolen. Geschatte duur: 120 minuten.

Leerdoelen

Aan het einde van deze tutorial kun je:

  • De architectuur van OpenAI begrijpen (Assistants, Custom GPTs, Moderation, aangepaste guardrails)
  • Aangepaste juridische skills bouwen voor de workflows van je kantoor
  • Guardrails creëren voor kwaliteitscontrole en naleving
  • Multi-agent-systemen inzetten voor complexe juridische taken

Deel 1: De OpenAI-stack begrijpen

Architectuuroverzicht

Custom GPTs, Assistants API, Moderation, Function Calling. Use cases voor legal.

Custom GPTs voor playbooks en standaarden; Assistants API voor pipelines; Moderation API voor filtering; wrappers voor audit en compliance.


Wat zijn skills in de OpenAI-context?

Gespecialiseerde instructies en kennis opgeslagen in Custom GPTs of Assistants. Persistentie en automatische activering.

Implementatie via Custom GPT

Custom GPT aanmaken, instructies schrijven (SKILL.md-equivalent), kennisdossiers toevoegen (playbook JSON, clause library), testen en kalibreren.

Voorbeeld: NDA-triage skill

Dedicated Custom GPT voor NDA-triage: classificatie, niet-standaard voorwaarden, vergelijking met template, GREEN/YELLOW/RED.


Deel 3: Compliance-guardrails bouwen

Wat zijn guardrails?

Controles op specifieke punten in de workflow. Moderation API voor content; custom wrappers voor audit, PII, goedkeuringspoorten.

Voorbeeld juridische compliance-guardrail

Moderation API, custom API-wrapper, post-processing script. Doel: ongeautoriseerde wijzigingen aan privileged documenten voorkomen.

Aanvullende guardrail-use cases

Citaatverificatie, vertrouwelijkheidscontrole, privilegebescherming.

Guardrail-implementatiechecklist

Input/output-moderation, citaatverificatie, audit logging, vertrouwelijkheid, goedkeuringspoorten, PII-detectie, rate limiting.

Moderation API-quickreference

openai.moderations.create({ input }) om content te filteren vóór verzending naar het model.


Multi-agentpatronen begrijpen

Assistants API, Agents SDK, orkestratie via je code.

Voorbeeld: Parallelle due diligence-review

Meerdere assistants (contracten, IP, arbeid, litigatie); parallelle threads; synthese via Chat Completions.

Voorbeeld: Research + Draft-workflow

Fasen: research, draft, review. Ketting van API-aanroepen.


Deel 5: Skills verpakken voor distributie

Custom GPT-delen

Privé, Organisatie, Publiek (met voorzichtigheid voor juridische workflows).

Assistants API voor programmatisch gebruik

Assistants aanmaken via API, IDs opslaan, threads voor isolatie, file search voor knowledge base.

Skillpakketstructuur

instructions.md, playbook.json, clause-library.md, examples/, README.md.

Distributiechecklist

Instructies up-to-date, geen klantnamen, passend deelscope, versie/datum genoteerd.

Beveiligingsoverwegingen

Bronverificatie, codereview, geen klantgegevens, versiebeheer, toegangscontrole.


Deel 6: Beveiliging en compliance

Skill- en GPT-beveiliging

Bronverificatie, codereview, geen klantgegevens, versiebeheer, toegangscontrole.

Gegevensbeschermingspatronen

API-wrapper voor audit en sanitization (PII-redactie vóór retour).

Compliance-vereistenchecklist

Skills/GPTs beoordeeld door IT-beveiliging, guardrails getest in sandbox, audit logging ingeschakeld, gegevensscheiding geverifieerd, toegangscontroles geconfigureerd, back-up- en herstelprocedures gedocumenteerd.

Skill-beveiligingschecklist

Bron geverifieerd, code beoordeeld, geen klantgegevens, versiebeheer, toegang beperkt.


Deel 7: Probleemoplossing

Veelvoorkomende problemen

Skill activeert niet, inconsistente output, guardrail omzeild, Assistants-timeout, afwijkend modelgedrag, tokenlimiet overschreden, Custom GPT negeert kennisdossiers, Moderation false positives.

Assistants API-debugtips

Controleer run.status, run.last_error, include, tool definitions, usage, file search.

Custom GPT-debugtips

Test met minimale instructies, verifieer referenties naar kennisdossiers.

Custom GPT vs Assistants API: wanneer wat gebruiken

Ad-hoc → Custom GPT; kantoorworkflow → Custom GPT (Org); geautomatiseerde pipelines → Assistants API; multi-step orkestratie → Assistants API; audit/compliance-vereisten → Assistants API + wrapper.

Voorbeeld: outputformaat-instructie

Voeg Output Format-sectie toe met vereiste structuur (samenvatting, tabel, clausule-voor-clausule-analyse, risicoscore, prioriteiten, vragen).


Doe dit nu

  • Maak een aangepaste skill (Custom GPT) voor een van de reviewprocessen van je kantoor
  • Voeg minimaal één guardrail toe (audit logging of outputverificatie)
  • Test een multi-step workflow voor documentverwerking
  • Documenteer je skill zodat je team het kan gebruiken
  • Overweeg verpakking als gedeelde Custom GPT voor distributie


Quick reference: OpenAI-commando's

# Custom GPTs
chat.openai.com -> Create GPT -> Instructies en kennis configureren

# Assistants API
openai.beta.assistants.create({ instructions, model, tools })
openai.beta.threads.create()
openai.beta.threads.runs.create(thread_id, { assistant_id })

# Moderation
openai.moderations.create({ input: user_content })

Gerelateerde familiepagina's


Bronnen

Aanvullende lectuur

On this page