Packs d'exemple

Ce sont des Process Flows pré-créés packagés sous forme de Scrydon Packs (.scrydon-pack.tar.gz). Chacun regroupe un process flow avec une ontologie — téléchargez, inspectez, puis téléversez via /api/packs/import. Les exemples ne sont pas auto-installés ; vous les optez en important l'archive dans votre organisation.

Parcourir les packs d'exemple

Le catalogue d'exemples — chaque scénario, son guide pas à pas complet, ses données d'exemple et le téléchargement .scrydon-pack.tar.gz — se trouve dans la section Exemples. Cette page explique comment ces packs sont construits, importés en ligne de commande, personnalisés et contribués.

Comment importer un exemple

bunx @scrydon/sdk-authoring pack inspect ~/Downloads/iso-quarterly-review-1.0.0.scrydon-pack.tar.gz

curl -X POST "$AGENTIC_URL/api/packs/import?organizationId=$ORG_ID" \
  -H "Cookie: $SESSION_COOKIE" \
  -F "file=@~/Downloads/iso-quarterly-review-1.0.0.scrydon-pack.tar.gz"

Personnaliser avant le téléversement

La plupart des équipes voudront ajuster les personas, les jours de décalage d'échéance, ou remplacer les entrées actionType: workflow par leurs propres workflowId. Trois options :

1. Modifier le manifeste, reconstruire. Clonez la source de l'exemple depuis packages/sdk-authoring/src/process-flows/examples/<slug>/index.ts, modifiez, puis bun run --cwd packages/sdk-authoring build:examples pour reconstruire chaque pack. Ou assemblez un répertoire de pack créé manuellement et bunx @scrydon/sdk-authoring pack build path/to/pack.json --outDir dist.
2. Forker le manifeste en TypeScript. Créez votre propre defineProcessFlow(...) dans votre dépôt, en copiant-collant l'exemple comme point de départ. Recommandé quand les changements sont non triviaux.
3. Modifier process-flow/manifest.json à l'intérieur de l'archive. Extraire → modifier → ré-emballer avec tar -czf. Rapide pour des ajustements ponctuels ; pas recommandé pour la maintenance continue.

Les manifestes d'exemple sont versionnés (package.version dans pack.json et dans le manifeste de process-flow) — incrémentez-le quand vous forkez pour que votre organisation suive la divergence.

Ajouter un nouvel exemple

Pour contribuer un nouvel exemple :

1. Créez packages/sdk-authoring/src/process-flows/examples/<votre-slug>/index.ts exportant un résultat defineProcessFlow(...).
2. Ajoutez-le à exampleTemplates dans examples/index.ts.
3. (Optionnel) Si votre exemple a besoin d'une vraie ontologie, déposez le sous-répertoire d'ontologie sous packages/sdk-authoring/src/packs/examples/<votre-slug>/ontology/ et enregistrez-le dans ONTOLOGY_OVERRIDES à l'intérieur de scripts/build-examples.ts. Les modèles sans remplacement reçoivent une ontologie vide auto-générée au moment du build.
4. Exécutez bun run --cwd packages/sdk-authoring build:examples — le script découvre et package automatiquement chaque entrée.
5. L'archive atterrit à apps/docs/public/static/process-pack-examples/<slug>-<version>.scrydon-pack.tar.gz et est servie par le site de documentation.
6. Ajoutez le pack au catalogue dans la section Exemples — une carte sur l'index des exemples et une page de guide sous content/docs/examples/.

Le script de build est vocal en cas d'échec : si un manifeste ne valide pas contre son schéma, l'exemple est rejeté et le build échoue avec le chemin Zod de la violation.

Ce qui N'EST PAS dans un exemple

Les Packs sont des données pures — ils ne peuvent pas contenir de code exécutable. La logique personnalisée est référencée par workflowId contre des workflows système ou organisationnels. Les exemples ISO référencent compliance-quarterly-prefetch, compliance-monitoring-snapshot, compliance-evidence-sync et compliance-vanta-final-check — ce sont des workflows système prévus. Jusqu'à leur distribution, ces actions de type workflow se dégradent en listes de contrôle manuelles dans l'interface runtime.

Connexes