Aller au contenu

Codebase Index

Sur cette page

Vue d'ensemble

Codebase Index permet au chat IA de rechercher dans votre projet ouvert par le sens plutôt que par le texte exact. Une fois l'index construit, vous pouvez poser des questions comme « où les connexions OPC UA sont-elles ouvertes ? » et l'assistant trouve le code le plus pertinent, classé par similarité, puis répond à partir de celui-ci. Cela fonctionne aussi bien pour le code automate que pour les langages généralistes de votre espace de travail. Pour le code automate, il prend en charge les fichiers SCL (.scl), les fichiers Structured Text (.st) et les exports PLCopenXML (.xml), et les découpe en blocs, méthodes, propriétés, types de données et listes de variables globales, de sorte qu'une recherche trouve le bloc exact plutôt qu'un fichier entier. Les autres fichiers XML ne sont pas indexés. Les fichiers d'automate jusqu'à 16 MB sont indexés, ce qui couvre l'export d'un projet entier ; les autres fichiers de plus de 1 MB sont ignorés.

L'index privilégie le local : votre code est transformé en une forme consultable par un point de terminaison d'embeddings que vous configurez (généralement un serveur de modèles qui tourne sur votre propre machine), et le résultat est stocké localement. Avec un point de terminaison local, rien ne quitte votre machine. Codebase Index est une fonctionnalité Pro et reste désactivé tant que vous ne l'activez pas.

Configuration

  1. Ouvrez les paramètres AnyAutomation (Ctrl+,) et sélectionnez la catégorie Codebase Index (l'icône de base de données).
  2. Activez Activer l’indexation.
  3. Saisissez l'URL d’embedding (l'adresse d'un point de terminaison d'embeddings compatible OpenAI, par exemple un serveur de modèle local) et le Modèle d’embedding à utiliser. Ajoutez une Clé API si votre point de terminaison exige une clé API.
  4. (Facultatif) Sous Stockage, choisissez le Magasin de vecteurs : LanceDB (un stockage local, par défaut, sans serveur) ou Qdrant (un serveur externe, pour des index plus volumineux ou partagés). Pour Qdrant, renseignez l'URL Qdrant et, si nécessaire, la Clé API Qdrant.

La section Recherche et réglage vous permet d'ajuster le nombre de résultats renvoyés par une recherche et le degré de proximité requis pour une correspondance. La section Reranking est facultative : indiquez dans URL du reranker l'adresse d'un serveur de reranking (et renseignez un Modèle de reranking / une Clé API du reranker s'il en a besoin) pour réévaluer les résultats et obtenir une pertinence plus fine, ou laissez ce champ vide pour ignorer le reranking. Chaque paramètre est enregistré automatiquement.

Portée de la configuration

En haut de la page des paramètres de Codebase Index, un sélecteur Global | Local détermine les paramètres que vous modifiez :

  • Global : s'applique à tous les espaces de travail que vous ouvrez.
  • Local : s'applique uniquement au projet en cours. Désactivé lorsqu'aucun dossier n'est ouvert.

La clé API et les adresses des points de terminaison restent toujours globales et ne peuvent pas être remplacées par projet. Un petit badge à côté de chaque champ (PAR DÉFAUT, LOCAL ou GLOBAL) indique d'où provient la valeur actuelle, et une flèche de réinitialisation rétablit la valeur par défaut d'un champ.

Activer l'indexation dans la portée Global indexe tous les espaces de travail que vous ouvrez ; l'activer uniquement dans la portée Local n'indexe que ce projet.

Indexation

Pour construire ou actualiser l'index du projet ouvert, exécutez Codebase Index : indexer l’espace de travail depuis la palette de commandes (Ctrl+Shift+P), ou cliquez sur l'icône de base de données dans la zone de saisie du chat et choisissez Indexer l’espace de travail.

Lorsque l'indexation est activée globalement, Studio indexe aussi en arrière-plan chaque dossier que vous ouvrez. Il suffit que vous ayez marqué l'espace de travail comme approuvé. Pendant une indexation en arrière-plan, un indicateur Indexation du code… apparaît dans la barre d'état ; sinon, la barre d'état affiche une entrée Codebase Index sur laquelle vous pouvez cliquer pour accéder aux actions rapides.

Recherche depuis le chat IA

Une fois l'index construit, l'assistant y effectue automatiquement des recherches avec l'outil Semantic Code Search chaque fois que vous posez une question sur votre code. Vous pouvez aussi y faire référence explicitement dans un message avec #semantic_code_search. Chaque résultat comprend l'extrait de code correspondant, son fichier et sa plage de lignes, ainsi qu'un score de pertinence, de sorte que l'assistant répond à partir de votre code réel plutôt que de mémoire.

Activez Auto-contexte dans les paramètres de Codebase Index pour que Studio joigne automatiquement le code le plus pertinent à chaque message du chat : pendant la saisie, les meilleures correspondances apparaissent sous forme de puces amovibles au-dessus de la zone de saisie, et vous pouvez retirer celles dont vous ne voulez pas avant l'envoi. Utilisez Résultats max. de l'auto-contexte pour définir combien il en joint.

L'auto-contexte fonctionne aussi dans la Fenêtre des agents (la fenêtre distincte où s'exécutent les sessions d'agents) : lorsque vous rédigez un nouveau prompt pour le projet que vous y avez choisi, les mêmes puces amovibles s'ajoutent au-dessus du message, et une petite icône d'état près de la zone de message indique si l'index est inactif, en cours de travail ou indisponible.

État et gestion

  • L'entrée Codebase Index de la barre d'état, ainsi que l'icône de base de données de la zone de saisie du chat, ouvrent un menu rapide : Indexer l’espace de travail, Effacer l’index ou Ouvrir les paramètres.
  • Codebase Index : effacer l’index supprime l'index stocké du projet en cours.
  • Codebase Index : afficher l’état ouvre le même menu rapide depuis la palette de commandes.

Remarques

  • Codebase Index n'indexe qu'un dossier local que vous avez ouvert, et l'indexation en arrière-plan ne s'exécute que pour un espace de travail que vous avez marqué comme approuvé.
  • Si l'indexation est désactivée, ou si l'URL et le modèle d'embedding ne sont pas définis, les commandes et l'outil du chat vous indiquent ce qu'il faut configurer.
  • Cette fonctionnalité nécessite une licence Pro ou supérieure.