Contextes

Utiliser des index dans les agents

Les index permettent aux agents d'accéder aux bases de connaissances nécessitant une autorisation. Cela aide les agents à raisonner en utilisant des données spécifiques au métier. Pour obtenir des conseils sur l'exploitation efficace du contexte, consultez la section Meilleures pratiques en matière d'ingénierie contextuelle.

Pour ajouter du contexte à votre agent, procédez aux étapes suivantes dans la section Contextes :

1. Sélectionnez Add context (Ajouter un contexte).
2. Sélectionnez un index dans la liste disponible ou sélectionnez Create new (Créer nouveau) pour créer un nouvel index dans Orchestrator. Pour de plus amples informations, consultez la section Index.
3. Fournissez une Description de votre contexte.
4. Configurez la stratégie de recherche à l’aide du panneau Propriétés. Vous pouvez contrôler le type de requête, la précision et la pertinence du contexte à l’aide des paramètres suivants :
   • Semantic (Sémantique) : sélectionnez cette option pour les requêtes sémantiques si vous utilisez des sources de données textuelles.
     • Relevance score threshold (Seuil de la note de pertinence) : désigne le seuil de la note de similarité appliqué après la récupération et le reclassement des blocs pertinents. Les blocs pertinents dont la note est inférieure à ce seuil ne sont pas retournés. Utilisez ce champ pour obtenir des résultats plus précis. Lorsque vous augmentez ce nombre, l'ancrage dans le contexte filtre et ancre uniquement les requêtes qui possèdent les meilleures notes.
     • Résultats maximaux générés : fait référence au nombre de segments renvoyés par ancrage dans le contexte à partir de la requête d'un utilisateur. Cela permet de réduire la charge utile d'ancrage dans le contexte de la génération LLM (taille globale du jeton de l'appel LLM) et peut servir de filtre supplémentaire sur les résultats que vous obtenez du service Ancrage dans le contexte. L'augmentation du nombre de résultats augmente le nombre de blocs retournés.
     • Requête : la requête de la stratégie de recherche. Ce champ prend en charge les valeurs statiques, ainsi que les modes Statique, Argument et Dynamique.
   • Structuré (Aperçu) : sélectionnez cette option pour les requêtes structurées si vous utilisez des sources de données tabulaires. Prend en charge le format de données CSV.
   • DeepRAG : sélectionnez cette option pour activer la synthèse et la récupération avancées de plusieurs documents. Pour des détails, reportez-vous à Utilisation de DeepRAG.
     • Activer les citations – Activer les citations pour les requêtes DeepRAG.
     • Invite : L'invite utilisée pour la requête DeepRAG. Ce champ prend en charge les valeurs statiques, ainsi que les modes Statique, Argument et Dynamique.
5. Limitez l'étendue de la recherche à l'aide des paramètres suivants :
   • Préfixe du chemin de dossier : utilisez ce champ pour spécifier le chemin du dossier dans lequel vos documents cibles sont stockés. Vous pouvez entrer manuellement un chemin statique, tel que /documents/project, ou utiliser un argument dynamique, ce qui permet à l’agent de rechercher différents dossiers en fonction des entrées d’exécution.
   Remarque :

   Par défaut, seuls les fichiers situés directement dans le dossier spécifié sont indexés. Les fichiers stockés dans les sous-dossiers ne sont pas inclus automatiquement. Pour inclure des fichiers de sous-dossiers, ajoutez /** au chemin (par exemple, /documents/project/**).Si les fichiers dans les sous-dossiers ne sont pas inclus, l'erreur suivante peut s'afficher: « Aucun fichier valide à utiliser pour DeepRAG.Veuillez mettre à jour et resynchroniser votre index ou utiliser un modèle de correspondance différent. »

   • Extension de fichier : sélectionnez les types de fichiers contenus dans l'index. Pour DeepRAG, seuls les fichiers PDF sont pris en charge.

Contexte juste à temps à l’aide de fichiers

Le contexte juste à temps vous permet de fournir des fichiers à un agent lors du Runtime sans gérer les index longue durée ou les sources de données persistantes.Au lieu de synchroniser les fichiers dans un index permanent, l’agent utilise directement les fichiers. Cette approche réduit les frais généraux opérationnels, améliore le débit et évite les coûts de stockage inutiles. Utilisez le contexte juste à temps chaque fois que votre incident d’utilisation nécessite que l’agent travaille avec les fichiers fournis lors du Runtime et que vous n’avez pas besoin de maintenir les données indexées par la suite.

1. Sélectionnez Ajouter un contexte et choisissez Utiliser les entrées de fichier.Cette option est disponible uniquement lorsque des arguments de type Fichier sont définis pour votre agent dans le Gestionnaire de données.

2. Utilisez le champ Nom pour définir un nom descriptif pour votre index de fichiers.
3. (Facultatif) Dans Description, documentez le type de document que ce contexte fournira.
4. Dans Fichiers, liez l'entrée qui contient les fichiers ou les pièces jointes (par exemple, un Array de documents provenant de la conversation ou d'un outil).
5. Configurez les paramètres restants comme vous le feriez pour un index standard.

Lors de l’exécution, l’index temporaire est créé, interrogé en fonction de votre configuration, puis écarté. L’agent reçoit le contexte extrait pertinent dans le cadre de son processus de raisonnement sans que vous ayez à gérer les sources de données, les synchronisations d’index ou le nettoyage.

Exigences et limites

Lors de l’utilisation du contexte juste à temps, les contraintes suivantes s’appliquent :

• Pièces jointes d’entrée : jusqu’à 25 pièces jointes par exécution avec une taille totale maximale de 128 Mo.
• Types de fichier pris en charge : tous les types de fichier pris en charge par l'ancrage dans le contexte.
• Format de sortie : correspond aux formats de sortie standard des outils d’ancrage dans le contexte existants.
• TTL (mise en production) : les index temporaires sont automatiquement supprimés 24 heures après la dernière utilisation.Cela permet de réutiliser le même index pendant le débogage sans réingestion.
• Jusqu’à 1 000 index temporaires par locataire peuvent être actifs à la fois. Un quota plus élevé peut être demandé incident par incident.