Ga naar inhoud

Microsoft Word add-in (alleen LEO)

De LEO Word add-in is onderdeel van het LEO-product binnen Prudai Platform. Hiermee kun je LEO direct in Word gebruiken, met extra functies die in de webapp niet bestaan (zoals selectie-context en Word-suggesties).

  • LEO draait in een taskpane (iframe) en kan:
    • je huidige selectie als context gebruiken,
    • optioneel (met een toggle) tekst uit het hele document gebruiken (met limiet),
    • output invoegen in Word,
    • comments toevoegen op selectie/anker,
    • suggesties doen (Word-achtige “vervangingsvoorstellen”) als jouw Word-client dit ondersteunt.

De add-in is gevalideerd op:

  • Word voor Windows en Mac (desktop),
  • Word voor het web (word.cloud.microsoft).

Het manifest is expliciet uitgelijnd op https AppDomains, zodat de cloud-Word host correct laadt.

De add-in wordt meestal door IT of beheer beschikbaar gemaakt. Drie distributie-routes:

  • Microsoft AppSource / Partner Center — gepubliceerde versie voor brede uitrol;
  • centrale Microsoft 365-uitrol door je beheerder (aanbevolen voor organisaties);
  • handmatig manifest (.xml) uploaden in Office voor pilots of staging.

Vraag aan je beheerder:

  • welk manifest of welke marketplace-listing je moet gebruiken,
  • welke app-URL bij jullie hoort (prod/staging).

Het manifest verwijst naar de taskpane hostpagina:

  • lokaal (voorbeeld): https://localhost:3002/word-addin/taskpane.html
  • productie (voorbeeld): https://app.prudai.com/word-addin/taskpane.html

Belangrijk: de add-in draait in een iframe. Veel SSO-providers blokkeren login in iframes. Daarom:

  • start login via een Office-dialog (pop-up) wanneer je op “Inloggen” klikt,
  • na succesvolle login synchroniseert het taskpane de sessie (“check-sso”),
  • tokens worden in-memory in de taskpane bewaard; dit voorkomt de Edge-login-loop die ontstond toen Edge derde-partij-cookies in iframes strakker ging blokkeren.

Als je problemen hebt: zie Problemen oplossen & support.

De add-in stuurt je huidige selectie (tekst) door naar LEO. Zo kun je vragen stellen als:

  • “Herschrijf deze alinea in formele stijl.”
  • “Maak hiervan een bullet-lijst met risico’s.”

Technische details (handig om gedrag te begrijpen):

  • De selectie wordt periodiek ververst (ook als Word events een selectie-change missen).
  • De add-in houdt een “laatst verstuurde selectie” bij om spam te voorkomen.

Er is een knop om documentcontext mee te sturen. Dit is bedoeld voor korte/middelgrote documenten en heeft een harde limiet.

Praktisch:

  • gebruik dit niet voor zeer grote stukken; werk dan liever met losse documenten in een project.

Bekende limieten:

  • er is een harde maximumgrootte voor documenttekst (in de huidige implementatie: ~600.000 characters).
  • documenttekst wordt als ephemeral context gebruikt en is niet bedoeld om in chatgeschiedenis opgeslagen te worden.

Bij een assistent-antwoord kun je:

  • exporteren naar Word (.docx), of
  • in add-in context vaak direct “Invoegen in Word” kiezen.

Tip: vraag om koppen en consistente nummering. Dat werkt beter in Word.

Als je in Kennis de tool “Suggesties in Word” aanzet, kan LEO output maken die bedoeld is om als:

  • comment, of
  • suggestie (annotation) in Word te landen.

De annotaties worden teruggeschreven naar de specifieke selectie die je in Word had, niet alleen aan het einde van het document. Het ankermechanisme is robuust gemaakt voor kleine whitespace- en interpunctieverschillen.

Beperkingen om rekening mee te houden:

  • sommige Word clients ondersteunen niet alle review/suggestie-API’s,
  • anker/suggesties kunnen beperkingen hebben (bijv. exact match of binnen één paragraaf).

Meer: Kennis en Chat.