Knowledge Lists

Qu'est-ce qu'une liste de connaissances?

Une liste de connaissances est un tableau typé et persistant limité à votre espace de travail. Considérez-le comme une table de base de données légère dans laquelle chaque flux de travail peut lire et écrire. Contrairement à un one-off CSV attaché à une seule exécution, une liste existe entre les exécutions — un workflow de notation des leads peut lire prospects, notez chaque ligne et réécrivez les résultats avec un nouveau statut. Le flux de travail suivant reprend là où il s'est arrêté.

Chaque liste a une stable clé de liste (par ex. investors) auquel les workflows font référence. La clé ne change jamais même si vous renommez la liste, afin que les flux de travail ne soient pas interrompus lorsque vous mettez à jour les métadonnées.

Créer une liste

Trois chemins pour créer une liste, tous aboutissant au même modèle schéma + lignes:

CSV Télécharger

Aller à Connaissance > Listes dans le tableau de bord et cliquez sur Importer CSV. AgentLed détecte automatiquement les types de colonnes et les mappe aux types de champs. Vous pouvez consulter et ajuster le schéma avant de vous engager.

Tableau de bord

Cliquez Nouvelle liste, donnez-lui un nom et une clé, puis définissez les colonnes manuellement. Ajoutez des lignes une par une ou en masse à partir de l'éditeur de lignes.

MCP / API

create_knowledge_list({
  key: "investors",
  name: "Investor Contacts",
  fields: [
    { name: "name",   type: "text",   required: true },
    { name: "firm",   type: "text" },
    { name: "email",  type: "email" },
    { name: "stage",  type: "select", options: ["Pre-Seed","Seed","Series A","Growth"] },
    { name: "score",  type: "number" }
  ],
  syncToKg: true
})

create_knowledge_list est idempotent - l'appeler à nouveau avec la même clé renvoie la liste existante avec un avertissement au lieu de créer un doublon.

Types de champs

Lecture de lignes dans un workflow

Utilisez le Lire la liste étape (ou get_knowledge_rows via MCP) pour charger des lignes dans un workflow. Vous pouvez filtrer par statut pour traiter uniquement un sous-ensemble.

// Read List step config
{
  listKey: "investors",
  status: "pending",    // filter to rows with this status
  limit: 100
}
// Returns: { listEntries: [...rows], count: 87 }

Pour les blobs de texte (notes long-form, documents, intégrations), utilisez get_knowledge_text avec une clé pour récupérer le contenu non structuré stocké à côté de la liste.

get_knowledge_text({ key: "icp-definition" })
// Returns the raw text blob stored under that key

Écrire des lignes dans un workflow

Utilisez le Ajouter des lignes étape pour réinsérer les résultats dans une liste. Les lignes correspondent à des champs d'identité; de nouvelles lignes sont créées, les lignes existantes sont mises à jour.

// Add Rows step config
{
  listKey: "prospects",
  rows: "{{steps.score.results}}",
  status: "scored"
}
// Returns: { addedCount: 43, rowIds: [...], listCreated: false }

Jusqu'à 500 lignes par appel. Pour les lots plus importants, paginez en plusieurs étapes ou utilisez le modèle de traitement par lots.

Statut de la ligne

Chaque ligne porte un status champ que les flux de travail utilisent pour vérifier la progression des points. Cela vous permet de créer des pipelines incrémentiels qui reprennent uniquement là où ils se sont arrêtés.

Knowledge Graph Synchronisation

Activer Synchroniser avec KG sur une liste pour promouvoir les lignes en nœuds d'entité dans le Knowledge Graph. Une fois synchronisées, les lignes deviennent des nœuds de graphique first-class que les étapes AI peuvent rechercher et parcourir aux côtés d'autres entités, des bords de notation et de l'historique d'exécution.

La synchronisation est fire-and-forget: l'étape d'ajout de lignes se termine immédiatement et la mise à jour KG s'effectue en arrière-plan. Si le Knowledge Graph n'est pas disponible, les lignes sont toujours enregistrées; ils seront synchronisés lors de la prochaine connexion réussie.

Lorsque la synchronisation KG est activée, vous configurez un configuration de l'entité: quel champ est le nom d'affichage et quels champs identifient de manière unique l'entité. Ceux-ci sont utilisés pour la déduplication lorsque la même entreprise ou contact apparaît dans plusieurs listes.

Gestion des listes

Ajouter ou supprimer des champs

Vous pouvez ajouter de nouveaux champs ou supprimer ceux existants Connaissance > Listes > Modifier le schéma. Les lignes existantes conservent les anciennes valeurs; les champs supprimés sont supprimés des lectures futures, mais les données sous-jacentes sont conservées jusqu'à ce que vous exécutiez un nettoyage.

Supprimer une liste

La suppression d'une liste supprime définitivement le schéma et toutes les lignes. Il n'y a pas de gestion de version ou soft-delete — assurez-vous qu'aucun flux de travail en direct ne dépend de la liste avant de la supprimer. Workflows qui fait référence à une clé de liste supprimée échouera à l’étape de lecture de la liste.

Limites

• •Jusqu'à 500 lignes par appel upsert. Paginez des ensembles de données plus volumineux en plusieurs étapes.
• •Aucune limite de lignes per-list stricte, mais les listes supérieures à environ 10 000 lignes doivent utiliser le filtrage d'état pour éviter de charger la table complète en une seule étape.
• •Nombre de champs: pas de limite stricte, mais gardez les schémas concentrés: les schémas larges ralentissent les lectures de lignes.

Exemples de cas d'utilisation

Prochaines étapes

• KG API — Interrogez les lignes de la liste en tant que nœuds de graphique en utilisant kg_search et kg_traverse
• Business Memory — Contexte partagé au niveau de l'espace de travail (ICP, rubriques) stocké à côté des listes
• Notation et commentaires - Réécrivez les scores dans les listes et améliorez-les au fil du temps
• Knowledge Graph Présentation — Comment les entités de liste s'intègrent dans l'architecture plus large de KG