Citer un document

Quand vous savez exactement quel document vous voulez faire lire au modèle (une facture, une fiche, une note, un enregistrement), inutile de passer par une recherche : citez-le directement dans votre message. Son contenu est résolu et injecté avant l’appel modèle — zéro tour de recherche, réponse plus rapide et moins de tokens.

Deux façons de citer, au choix. Les deux donnent le même résultat.

1. Le token texte [[kb:slug:ref]]

Écrivez, n’importe où dans le texte de votre message, un token lisible :

[[kb:<slug-de-la-base>:<référence-du-document>]]

• slug-de-la-base = l’identifiant de la base (ex. factures-clients).
• référence-du-document = l’external_id (votre identifiant métier : réf facture, id CRM…) ou l’UUID interne du document.

Exemple :

{
  "model": "mistral-small",
  "messages": [
    {
      "role": "user",
      "content": "Résume les points clés de la facture [[kb:factures-clients:FAC-2025-089]]."
    }
  ]
}

Le token est volontairement lisible : vous pouvez l’écrire dans une procédure, un message Slack ou tout texte libre, et il reste compréhensible par un humain comme par le modèle.

2. La partie de contenu kb_document

Pour un appel construit par programme, une partie de contenu structurée fait la même chose (comme une pièce jointe, mais qui pointe un document déjà indexé) :

{
  "model": "mistral-small",
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "Résume les points clés de cette facture." },
        {
          "type": "kb_document",
          "kb_document": { "knowledge_base": "factures-clients", "id": "FAC-2025-089" }
        }
      ]
    }
  ]
}

id accepte l’external_id ou l’UUID (comme le token).

Documents volumineux

• Un document court est injecté en entier.
• Un document volumineux est réduit à ses extraits pertinents pour votre question (recherche sur ses propres passages) → le contexte reste borné sans perdre l’essentiel. Sans question précise, seul le début du document est injecté.

Bon à savoir

• Fonctionne aussi bien en RAG statique qu’en mode agentique — c’est un choix explicite de votre part, pas un outil que le modèle décide d’appeler.
• Le périmètre de vos bases est respecté (mêmes droits que la recherche). Un document introuvable ou hors périmètre est signalé au modèle, jamais inventé.
• Vous pouvez citer plusieurs documents dans un même message.

Dans le portail

Dans le bac à sable, l’assistant et l’éditeur de tâches programmées, tapez @ dans la zone de saisie : une liste propose les documents des bases actives. Sélectionnez-en un et le token [[kb:…]] est inséré pour vous.

Pour une tâche programmée, sélectionnez d’abord la base dans Ressources : le @ ne propose que les documents des bases déclarées par la tâche (le document cité est fourni au modèle à chaque exécution).