AIGetMetaData

Syntaxe

Paramètres

Description

Cette fonction permet de récupérer les métadonnées d'un point de terminaison AI configuré. Elle retourne des informations sur la configuration du point de terminaison et, éventuellement, des détails plus précis si demandé.

Remarques

• La fonction AIGetMetaData() est conçue pour interroger un point de terminaison d'intelligence artificielle configuré et obtenir des informations sur sa configuration. Elle permet aux développeurs de vérifier l'état et les capacités d'un point de terminaison avant de l'utiliser pour des traitements IA, garantissant ainsi que les appels ultérieurs seront cohérents et sans erreur.
• Le paramètre name est essentiel, car il identifie le point de terminaison AI dont on souhaite récupérer les métadonnées. Il peut s'agir d'un nom de point de terminaison directement configuré dans l'administrateur Lucee, d'une référence par défaut (comme "default:exception"), ou même d'un objet de session AI. Cette flexibilité permet de gérer plusieurs points de terminaisons dans un environnement multi-modèles.
• Le paramètre detailed permet d'inclure des informations supplémentaires sur le point de terminaison, notamment la liste des modèles disponibles et leurs fichiers associés. Lorsqu'il est défini à true, le développeur obtient non seulement la configuration de base, mais aussi des détails précis comme les labels, descriptions, paramètres personnalisés et informations sur les fichiers, ce qui est utile pour la documentation ou le diagnostic.
• Le retour de la fonction est une structure (Struct) contenant les métadonnées. Cette structure peut être facilement parcourue et manipulée dans Lucee, permettant d'extraire des informations comme le nom du modèle, ses capacités, ses fichiers associés, et même l'état ou la date de création de ces fichiers. Cela facilite l'automatisation et l'intégration avec d'autres services.
• AIGetMetaData() est particulièrement utile dans des environnements où plusieurs modèles AI coexistent, car elle permet d'identifier rapidement lequel est actif, sa configuration, et quelles versions sont disponibles. Cela aide à éviter les erreurs d'appel vers un modèle incompatible ou obsolète et à s'assurer que le traitement IA est dirigé vers le bon point de terminaison.
• La fonction peut également être utilisée pour vérifier la disponibilité des fichiers associés aux modèles AI, ce qui est crucial pour les moteurs capables de traiter des fichiers. Les informations sur les fichiers incluent l'ID, la taille, la date de création et l'état, permettant ainsi de gérer efficacement les ressources et de diagnostiquer des problèmes liés aux fichiers manquants ou corrompus.
• Sur le plan de la sécurité et de la gestion, AIGetMetaData() permet de centraliser les informations sur un point de terminaison AI sans exécuter de traitement sur les données réelles. C'est un moyen sûr de s'assurer que le point de terminaison est correctement configuré avant d'envoyer des requêtes qui pourraient contenir des données sensibles ou volumineuses.
• Enfin, cette fonction renforce la transparence et la maintenance des intégrations IA. En récupérant systématiquement les métadonnées, les développeurs peuvent générer des tableaux de bord ou des rapports sur l'état des points de terminaisons AI, suivre l'évolution des modèles et de leurs fichiers, et planifier les mises à jour ou modifications nécessaires pour optimiser les performances des services intelligents.