Ga naar inhoud

Delen en hergebruik

Je hebt voor één klant een supportassistent gebouwd: een agent, zijn prompt, twee skills en een toolset. Je volgende klant wil dezelfde assistent. Organisaties delen niets vanzelf, dus kopiëren met de hand zou betekenen dat je elke verbetering bij elke klant opnieuw doorvoert. Daarvoor zijn publicaties: je bouwt iets één keer, publiceert het, en installeert het bij elke klant die het nodig heeft.

Hoe het werkt

flowchart LR
    lib["Je bibliotheek<br/>agents, prompts, skills, tools, kennis"] -->|"versie publiceren"| pub["Publicatie"]
    pub -->|"abonnement"| a["Klant A<br/>kopieën"]
    pub -->|"abonnement"| b["Klant B<br/>kopieën"]
    pub -.->|"nieuwe versie: synchroniseren"| a
    pub -.->|"nieuwe versie: synchroniseren"| b
Begrip Wat het is
Publicatie een bundel met een naam, in jouw organisatie. Je kiest wat erin zit en wie hem mag zien
Versie wat de bundel op één moment bevat. Een publicatie zonder versie deelt niets
Abonnement de installatie van een publicatie in één organisatie. Staat daar onder Geïnstalleerd
Kopie wat het abonnement in de bibliotheek van de abonnee zet. Elke kopie vermeldt uit welke publicatie hij komt (Gedeeld via)

Een abonnee krijgt kopieën en geen verwijzingen. Een geïnstalleerde agent is een gewone agent van de abonnee: hij staat in diens bibliotheek, valt onder diens sleutelbeleid en wordt op diens verbruik geboekt.

Een kopie neemt mee wat het onderdeel definieert, niet hoe jij het hebt geclassificeerd. Labels reizen nooit mee, dus elke kopie komt ongeclassificeerd binnen. Metadata reist wel mee, bij een prompt, een agent of een koppeling net zo goed, en elke synchronisatie die de kopie bijwerkt, vervangt die door de metadata van de uitgever.

Wat je kunt delen

Prompts, skills, agents, workflows, toolsets, API-koppelingen, SQL-koppelingen, MCP-servers, collecties, pipelines, indexen, zoektools, evaluaties, aliassen en scripts. Een kennisgraaf en een mailkoppeling kunnen niet in een publicatie.

Bij een API-koppeling of MCP-server kies je wat er met de inloggegevens gebeurt: niet meesturen, de abonnee vult ze zelf in, of je eigen gegevens meesturen. Dat laatste kan alleen naar onderliggende organisaties.

Wie een publicatie mag zien

Zichtbaarheid Wie zich kan abonneren Voor
Onderliggende organisaties elke organisatie onder de jouwe je eigen klanten
Gekozen organisaties alleen de organisaties die je noemt een beperkte groep
Marktplaats elke organisatie, nadat Artific als operator van het platform de bundel heeft beoordeeld een product dat je breed aanbiedt

Met Automatisch installeren, bij Onderliggende organisaties, abonneert elke nieuwe organisatie onder de jouwe zich meteen. Zo begint een nieuwe klant met je standaardopzet zonder dat je iets installeert.

Per klant anders

Klanten verschillen: een andere bedrijfsnaam in de instructie, een ander model, een eigen CRM. Een versie kan daarom parameters hebben die de installeerder invult:

  • een tekst, zoals de bedrijfsnaam, die in de instructies van een agent wordt ingevuld;
  • een model, een getal of een keuze;
  • een MCP-server of API-koppeling van de abonnee zelf, zodat jouw agent met het systeem van de klant werkt;
  • inloggegevens, of een collectie, index of sleutel van de abonnee.

Een onderdeel kan ook alleen meegaan bij een bepaalde keuze. Een bundel met een agent voor HubSpot en een voor Salesforce installeert dan alleen de agent die bij de keuze van de klant hoort.

Bijwerken: synchroniseren en losmaken

Publiceer je een nieuwe versie, dan krijgt elk abonnement dat de laatste versie volgt die vanzelf: Core synchroniseert de kopieën. Een abonnement kan ook op één versie blijven staan.

Zolang een kopie gekoppeld is, kan de abonnee hem niet wijzigen. Wil een klant een onderdeel zelf aanpassen, dan maakt hij het los: daarna is het van hem en volgt het geen nieuwe versies meer. Losmaken is niet terug te draaien.

Als uitgever stel je per versie voorwaarden: of losmaken mag, of de inhoud van de kopieën verborgen blijft voor de abonnee, of de abonnee de onderdelen mag doorverspreiden, of alleen de agents uit jouw bundel de prompts en skills ervan mogen gebruiken, en een licentietekst. Verborgen inhoud en losmaken sluiten elkaar uit.

Inhoud die verborgen is geïnstalleerd, blijft verborgen, en een abonnee kan een verborgen kopie nooit in een eigen bundel publiceren, wat de voorwaarde over doorverspreiden ook zegt. Een latere versie met andere voorwaarden toont wat die versie meebrengt, niet wat eerdere versies installeerden, en een kopie die wordt losgemaakt blijft verbergen waarmee ze is geïnstalleerd. Mogen alleen jouw eigen agents een prompt of skill gebruiken, dan wordt een eigen agent van de abonnee, of een kopie van jouw agent die de abonnee heeft losgemaakt, geweigerd zodra die het probeert. Die voorwaarde bepaalt wie een prompt of skill mag uitvoeren, niet wie hem mag lezen: verberg ook de inhoud als de abonnee de tekst niet moet kunnen kopiëren.

Bij een prompt is verborgen inhoud de template, de variabelen en de invulwaarden. De rol, de versienummers en de metadata blijven leesbaar.

Wanneer gebruik je dit

  • Je bedient meerdere klanten met dezelfde of bijna dezelfde oplossing.
  • Je wilt een verbetering op één plek maken en overal uitrollen.
  • Je wilt dat elke nieuwe klantorganisatie met een basisset begint.
  • Je biedt een oplossing aan organisaties buiten je eigen boom aan, via de marktplaats.

Voor één klant met een unieke opzet heb je geen publicatie nodig: bouw dan rechtstreeks in de organisatie van die klant.

Hoe het samenhangt

  • Publiceren gaat langs de boom van organisaties: standaard van boven naar beneden.
  • Een kopie valt onder de policy van de abonnee. Een voorvoegsel bij het installeren, zoals acme-, maakt het eenvoudig om alle kopieën met één regel te raken.
  • De bundels van Artific Connect installeer je op dezelfde manier vanaf de marktplaats.
  • Een bundel op de marktplaats kan een recht vereisen; de betaling daarvoor loopt buiten Core.

Verder

Tutorial: Bouw als partner één oplossing die je bij meerdere klantorganisaties kunt gebruiken.