Base de connaissances contextuelle entre les étapes
Un pack de démonstration téléchargeable — un process flow dont l'étape de workflow écrit une note dans la base de connaissances propre à l'instance en cours avec <start.processFlow.knowledgeBaseId>, et dont une étape ultérieure la relit. Téléchargez-le, installez-le, démarrez une instance, exécutez les deux étapes.
Chaque instance de process flow possède sa propre base de connaissances par instance. Le pack Contextual Knowledge Base est le plus petit élément qui démontre qu'une étape de workflow peut adresser cette base de connaissances — sans identifiant codé en dur, ce qui serait de toute façon impossible puisque l'identifiant de la base de connaissances de l'instance est généré à chaque exécution.
Le modèle comporte un stage avec deux actions workflow :
- Écrire une note dans la base de connaissances de l'exécution — un bloc Knowledge (Add Data) écrit une note dans
<start.processFlow.knowledgeBaseId>. - La relire depuis la base de connaissances de l'exécution — un bloc Knowledge (Search) portant sur la même
<start.processFlow.knowledgeBaseId>retrouve la note écrite par la première étape — dans la même exécution, sans aucune coordination d'identifiants entre les deux étapes.
Cette référence, <start.processFlow.knowledgeBaseId>, se résout à l'exécution vers la base de connaissances de l'instance à laquelle appartient l'exécution. Téléchargez le pack, installez-le, démarrez une instance et exécutez les deux étapes.
Ce que le pack provisionne
| Élément | Détail |
|---|---|
| Process flow « Contextual Knowledge Base Demo » | Un stage, deux actions workflow (écriture, lecture). Chacune référence un workflow de canevas inline livré dans template.workflows[]. |
Deux workflows inline (kb-write, kb-read) | Chacun est starter → Knowledge. Le champ base de connaissances du bloc Knowledge contient la chaîne littérale <start.processFlow.knowledgeBaseId>. |
| Une ontologie d'emplacement | Un pack doit livrer au moins un type de contenu que le bundler comprend ; celui-ci contient un unique type d'objet inutilisé. La substance de la démonstration est le process flow, pas l'ontologie. |
La base de connaissances de l'instance est une base de connaissances Memex. Add Data (l'opération create_document) est la seule opération d'écriture prise en charge par les deux moteurs de base de connaissances : l'étape d'écriture fonctionne donc avec elle — Memex ingère le texte sous forme de page. L'ingestion est asynchrone : la page est interrogeable un instant après que l'étape d'écriture a signalé sa fin ; exécutez donc l'étape de lecture un peu plus tard, pas au même instant.
Téléchargement
Le pack est un bundle .scrydon-extension.tar.gz téléchargeable — il n'est pas livré préinstallé avec la plateforme.
- contextual-knowledge-base.scrydon-extension.tar.gz — dernière version.
- scrydon-pack-contextual-knowledge-base-1.0.1.scrydon-extension.tar.gz — version figée.
Installation et exécution
.tar.gz sur la zone de dépôt, cochez l'acceptation du pack non signé, puis cliquez sur Téléverser. Le process flow Contextual Knowledge Base Demo est mis à disposition de toute l'organisation.<start.processFlow.knowledgeBaseId>.L'opération Search synthétise une réponse avec le modèle de langage par défaut de l'organisation : l'étape de lecture nécessite donc qu'une intégration LLM soit configurée. Même sans elle, la sortie results de l'étape contient toujours la page récupérée, de sorte que vous pouvez voir la chaîne écriture→lecture dans tous les cas.
Comment la référence est rédigée
Le champ base de connaissances du bloc Knowledge est un sélecteur dans l'interface du canevas, mais dans ce pack les workflows sont rédigés avec le SDK : le champ est donc simplement la chaîne <start.processFlow.knowledgeBaseId> — il n'y a aucune étape en mode avancé à effectuer. Voici à quoi ressemble le workflow inline :
// template.workflows[].definition.blocks["block-kb-write"]
{
type: "knowledge",
subBlocks: {
operation: { id: "operation", type: "dropdown", value: "create_document" },
knowledgeBaseId: { id: "knowledgeBaseId", type: "knowledge-base-selector", value: "<start.processFlow.knowledgeBaseId>" },
name: { id: "name", type: "short-input", value: "Run note - <start.processFlow.instanceName>" },
content: { id: "content", type: "long-input", value: "…" },
},
}Le workflow de lecture est identique, à ceci près qu'il utilise operation: "search" avec une query au lieu de name/content. Le runner injecte un objet de contexte d'exécution processFlow dans le bloc de démarrage lorsque l'action s'exécute dans un process flow, et l'interpréteur résout <start.processFlow.knowledgeBaseId> par rapport à celui-ci. Ce même objet <start.processFlow.*> expose aussi instanceName, startedAt, template.* et entity.* — le nom du document de l'étape d'écriture utilise <start.processFlow.instanceName>.
Sur le canevas (en construisant un workflow à la main plutôt que dans un pack), la même valeur se place dans le champ Advanced → Knowledge Base (reference) du bloc Knowledge, car le sélecteur de base n'accepte pas de référence saisie. Voir Bloc Knowledge → Choisir la base de connaissances.
Pourquoi la référence plutôt qu'un identifiant littéral ? L'identifiant de la base de connaissances de l'instance est généré à chaque exécution : il ne peut donc pas être connu au moment de la rédaction ; un identifiant de base de connaissances d'espace de travail serait propre à un environnement et casserait lorsque le pack passe d'un tenant à l'autre. <start.processFlow.knowledgeBaseId> se résout à l'exécution vers la base de connaissances de cette instance, de sorte qu'un même workflow rédigé se comporte correctement partout.
Uniquement dans un process flow. Exécutez l'un de ces workflows de manière autonome (depuis le canevas ou l'API des workflows) et il n'y a aucun champ de démarrage processFlow — <start.processFlow.knowledgeBaseId> ne se résout vers rien et l'étape Knowledge ne trouve aucune base de connaissances (échec fermé). N'utilisez cette référence que dans des workflows rédigés pour s'exécuter en tant qu'actions workflow de process flow.
Voir aussi
- Bloc Knowledge — les opérations, et le champ avancé Knowledge Base (reference) pour le canevas.
- Workflows intégrés — le mécanisme inline
template.workflows[], le tableau de référence complet de<start.processFlow.*>et le canal de diffusion du contexte de réception. - Rédaction : Process Flows — stages, tâches, actions, et ancrage d'une étape d'IA dans une connaissance gouvernée.