Agents-Flex

Qu’est-ce que Agents-Flex ?

Agents-Flex est un framework open source pour le développement d’applications d’IA et d’agents, destiné aux développeurs Java. Il sépare les appels de modèles, les outils, les agents, RAG, MCP, les compétences, Text2SQL ainsi que les capacités multimodales en modules pouvant être combinés selon les besoins.

Le framework n’est pas obligatoirement dépendant de Spring et peut être utilisé avec du Java classique, Spring Boot et d’autres stacks technologiques JVM. La plupart des modules principaux prennent en charge JDK 8 et des versions ultérieures, tandis que les modules MCP exigent actuellement JDK 17 ou une version supérieure.

Fonctionnalités principales d’Agents-Flex

1. Appel du modèle unifié

Les interfaces ChatModel, EmbeddingModel, ImageModel et RerankModel sont utilisées pour masquer les différences entre les différents fournisseurs de services. Les réponses ordinaires et les réponses en flux partagent les prompts, les options, le contexte ainsi que les mécanismes d’interception.

2. Tool Calling

Les développeurs peuvent exposer les méthodes métier Java à des outils de modélisation par le biais du scan d’annotations ou de la construction de code. Les résultats de l’exécution des outils peuvent retourner des dialogues, et ils peuvent également s’intégrer à un système de configuration en temps réel et à des plugins.

3. Exécution de l’agent

Le framework offre ReAct, le routage, la planification de tâches, des agents secondaires, l’approbation manuelle, le budget, les tentatives de réessai et le flux d’événements. Les tâches en cours peuvent enregistrer des snapshots et se reprendre après une suspension, un rappel externe ou une interruption du processus.

4. Base de connaissances RAG

Le chargement, l’analyse, le découpage, la vectorisation, la recherche et le réarrangement forment la chaîne complète RAG. Le stockage vectoriel s’adapte à des systèmes tels que Redis, Qdrant, Chroma, Pgvector, MariaDB, Milvus, OpenSearch et Elasticsearch.

5. Client MCP

Le module MCP peut se connecter à des services externes via des entrées/sorties standard, HTTP SSE et des connexions HTTP en flux, ainsi qu’convertir des outils distants en outils Agents-Flex. Ce module nécessite un environnement JDK 17 ou supérieur.

6. Pack de compétences

Skills organise les instructions, les scripts et les ressources dans un répertoire de fichiers, qui peuvent être découverts dans le stockage local ou distant et chargés selon les besoins. Les scripts peuvent être exécutés localement, dans OpenSandbox ou dans une sandbox AIO centralisée.

7. Text2SQL

Le module Text2SQL permet de lister les sources de données, de lire progressivement la structure des tables et de générer des requêtes. Le framework offre des vérifications SQL en lecture seule, des contraintes de paramètres, une limite du nombre de résultats, une isolation des locataires et des points d’extension pour l’audit.

8. Multimodalité et documents

Le module d’images couvre la génération et l’édition, le module audio prend en charge la synthèse et la reconnaissance vocale, tandis que le module vidéo utilise des tâches asynchrones. L’OCR peut s’intégrer à Baidu Smart Cloud, Gitee AI et MinerU, et analyser des images ou des PDF.

9. Observabilité et gouvernance de la production

Le cadre peut relier des modèles, des Agents, des outils et des tâches asynchrones, et suivre les retards, les Tokens et les états. La routage des modèles prend en charge le chargement équilibré, les tentatives de réessai, la coupure de circuit et la récupération en mode semi-ouvert, tandis que les capacités d’observabilité sont basées sur OpenTelemetry.

Pour quels développeurs

• Espérer intégrer les équipes backend de plusieurs grands modèles dans un service Java.
• Projets nécessitant la création d’une base de connaissances entreprise, d’un service client intelligent et d’analyses de données en langage naturel.
• Développeurs qui souhaitent utiliser MCP, Skills et des agents secondaires pour organiser des tâches complexes.
• Pour les entreprises ayant des exigences opérationnelles en matière de reprise de tâches longues, d’approbation, de budget et d’observabilité.
• Applications multimodales nécessitant une interface Java unifiée pour les images, la voix, la vidéo et l’OCR.
• Équipes disposant déjà d’un système Spring Boot mais ne souhaitant pas être liées à un seul fournisseur de modèles.

Environnement d’exécution et exigences de modules

• La plupart des modules principaux prennent en charge JDK 8 ou une version ultérieure.
• Le module MCP nécessite JDK 17 ou une version ultérieure.
• Le projet organise les dépendances à l’aide de Maven, ce qui permet d’intégrer une BOM, des dépendances agrégées ou des modules indépendants.
• Les applications Java classiques peuvent fonctionner sans Spring.
• Les projets Spring Boot peuvent utiliser les starters officiels pour effectuer des configurations automatiques courantes.
• JDBC et Redis peuvent être utilisés pour la persistance de l’état des agents et des tâches asynchrones.

Frais et licences

Au 24 août 2026, le framework Agents-Flex lui-même est open source et gratuit, son dépôt officiel étant soumis à la licence Apache 2.0. Le site officiel ne divulgue pas de forfaits cloud hébergés ni de prix de abonnements commerciaux.

En pratique, l’utilisation peut encore entraîner des frais liés à l’API du modèle, aux bases de données vectorielles, aux services de recherche, au stockage d’objets, à l’OCR, à la reconnaissance vocale, à la vidéo et aux ressources de sandbox. Il convient de vérifier séparément les quotas, les prix, les politiques de données et les restrictions géographiques pour chaque service externe.

Postes de coût courants

• Chat, Embedding, réarrangement et appel de modèles d’images.
• Base de données vectorielles gérées et cluster de recherche.
• Services d’OCR, de reconnaissance vocale, de synthèse vocale et de génération vidéo.
• Les serveurs, bases de données et Redis nécessaires au fonctionnement de l’agent.
• Plateforme de conteneur ou de sandbox nécessaire pour exécuter Skills en isolation.
• Journalisation, métriques, suivi des traitements et stockage à long terme des données.

Tutoriel pour commencer rapidement

1. Choisissez la version de JDK en fonction des modules nécessaires ; pour utiliser MCP, prévoyez au moins JDK 17.
2. Intégrer la BOM Agents-Flex ou les dépendances du module cible dans un projet Maven.
3. Sélectionnez l’adaptateur de modèle et configurez l’adresse du service, le nom du modèle et la clé à l’aide des variables d’environnement.
4. Commencez par effectuer une synchronisation simple ou une conversation en flux pour vérifier que l’authentification et le traitement des erreurs fonctionnent correctement.
5. Ajoutez les modules Memory, Outils, RAG, MCP ou Agent selon vos besoins.
6. Définir des délais d’attente, des tentatives de réessai, un contrôle du débit et une limite de frais pour les appels externes.
7. Vérifier les droits des outils, l’injection de messages et la récupération en cas d’échec dans un environnement de test.
8. Activez OpenTelemetry ou des journaux personnalisés pour surveiller les délais, les tokens et l’état des tâches.
9. Verrouiller les versions des dépendances avant le déploiement en production et effectuer une vérification de sécurité.

Tutoriel pour créer une application RAG

1. Déterminer les sources de connaissances, la fréquence de mise à jour et les droits d’accès.
2. Chargement de PDF, Office, HTML ou d’autres documents et extraction du texte.
3. Diviser le contenu en fonction de la structure du document, en conservant les titres, les identifiants de source et les métadonnées d’accès.
4. Sélectionnez le modèle Embedding pour enregistrer les vecteurs dans un stockage vectoriel adapté.
5. Rechercher des fragments candidats en fonction des questions de l’utilisateur, et améliorer la pertinence par un réclassement.
6. Ne transmettre au ChatModel que les fragments et informations de référence nécessaires.
7. Mettre en place un mécanisme de rejet ou d’upgrade manuel pour les réponses à faible niveau de confiance.
8. Utiliser des problèmes réels pour évaluer le rappel, la précision, le délai et le coût du modèle.

Conseils de sécurité pour la construction d’agents

• Par défaut, les outils utilisent les droits minimums ; les actions d’écriture, de suppression et d’envoi vers l’extérieur nécessitent une approbation.
• Définissez le nombre d’étapes, les tokens, le coût et le budget de temps pour chaque tâche.
• Exécuter les fichiers et scripts non fiables dans un sandbox isolé.
• Text2SQL privilégie l’utilisation de comptes de base de données en lecture seule et limite le nombre de résultats.
• Le service MCP doit vérifier l’origine, les droits d’accès et la sécurité de la transmission.
• Évitez d’enregistrer les clés et le texte source sensible dans les snapshots persistants et les événements.
• Des opérations identitaires sont conçues pour permettre des tentatives de réessai et une récupération, afin d’éviter les déductions ou écritures multiples.

Avantages du produit

• Conçu nativement pour Java, les modules principaux peuvent fonctionner sur des versions plus anciennes de JDK.
• La segmentation des modules est claire, permettant d’intégrer uniquement les fonctionnalités réellement nécessaires au projet.
• Pas de dépendance obligatoire envers Spring, tout en permettant une intégration rapide via Spring Boot.
• De la couverture par modèles, RAG et MCP aux agents réparables et aux capacités d’observabilité.
• Prend en charge de nombreux modèles, bases de données et services multimodaux nationaux et internationaux.
• La licence Apache 2.0 convient aux entreprises qui souhaitent l’utiliser et la modifier conformément aux exigences réglementaires.

Restrictions d'utilisation et précautions

• Le framework n’est pas une plateforme d’IA visuelle prête à l’emploi ; il nécessite des compétences en développement et en maintenance en Java.
• Les paramètres des adaptateurs de différents modèles, leurs capacités de réponse en temps réel et leur aptitude à appeler des outils peuvent varier.
• Les exigences JDK pour les modules MCP sont plus élevées que celles de la plupart des modules principaux ; il est nécessaire d’évaluer cela avant de mettre à niveau les projets anciens.
• Les coûts de modèles externes et d’infrastructure ne sont pas inclus dans les frameworks open source.
• Les agents, les scripts et Text2SQL peuvent avoir des effets secondaires réels, il est donc nécessaire de mettre en place un contrôle des permissions.
• Le nombre de modules est élevé ; lors de la mise à niveau, il convient de consulter le journal des modifications et d’effectuer des tests de régression.
• Les licences open source ne couvrent pas automatiquement les modèles connectés, les éléments visuels et les SDK tiers.

Explication sur le logiciel open source

Le code source ouvert du entrepôt principal d’Agents-Flex est explicitement publié sous la licence Apache License 2.0, ce qui permet de qualifier le framework lui-même de logiciel open source. L’utilisation et la redistribution doivent respecter les clauses relatives aux droits d’auteur, aux mentions légales et aux brevets stipulées dans la licence.

Les modèles d’adaptation de cadre, l’OCR, la recherche, les bases de données vectorielles et les services de sandbox disposent chacun de licences et de conditions commerciales indépendantes. L’appel à ces services ne signifie pas pour autant que la plateforme correspondante soit open source ou gratuite.

Questions fréquentes

Agents-Flex doit-il utiliser Spring ?

Ce n’est pas nécessaire. Le module principal peut fonctionner avec du Java classique, tout en offrant Spring Boot Starter pour faciliter l’intégration dans les projets existants.

Quelles versions de JDK sont prises en charge

La plupart des modules prennent en charge JDK 8 ou une version ultérieure, tandis que le module MCP nécessite actuellement JDK 17 ou une version ultérieure.

Est-il possible de créer une base de connaissances RAG ?

Oui. Le framework propose des modules pour l’extraction de documents, le segmentation, les embeddings, le stockage vectoriel, la recherche et le réarrangement.

Agents-Flex est-il gratuit ?

Le framework lui-même est gratuit et open source, mais les modèles, bases de données, services de recherche, OCR et sandbox auxquels il est connecté peuvent être payants.

Peut-il être utilisé pour des projets commerciaux ?

La licence Apache 2.0 autorise l’utilisation commerciale, mais il est nécessaire de conserver les déclarations correspondantes et de vérifier séparément les dépendances tierces ainsi que les conditions d’utilisation des services de modèles.

Résumé

Agents-Flex convient aux équipes de développement qui souhaitent mettre en place des appels de modèles, du RAG et des agents réversibles à l’aide de la modularité Java. Ses capacités sont assez complètes, mais sa mise en production nécessite tout de même un choix approprié du JDK, une gestion adéquate des permissions des outils, le calcul des coûts externes ainsi qu’une maintenance continue des dépendances.