Guides utilisateur

Bienvenue sur InfoLens ! Ce guide vous permettra d'exécuter votre première requête RAG en moins de 5 minutes. Tout d'abord, assurez-vous que Docker est installé et en cours d'exécution. Clonez le dépôt, copiez .env.example vers .env et ajoutez votre clé API Gemini. Ouvrez http://localhost:24001 dans votre navigateur, connectez-vous, importez un document, puis allez dans Discussion pour poser votre première question.

Les agents sont le composant principal d'InfoLens. Chaque agent est un assistant alimenté par l'IA qui répond aux questions en utilisant un ensemble spécifique de collections de documents. Pour créer votre premier agent, accédez à la page Agents et cliquez sur "Nouvel agent". Donnez-lui un nom et une description, puis sélectionnez les collections de documents auxquelles il doit avoir accès. Une fois créé, accédez à la page de détails de l'agent pour configurer son comportement, créer des clés API et obtenir le code d'intégration.

InfoLens prend en charge une large gamme de formats de documents : PDF, TXT, DOCX, HTML, CSV, JSON, PPTX, XLSX et Markdown. Pour importer des documents, accédez à la page Documents et cliquez sur "Importer" ou glissez-déposez des fichiers directement. Pour de meilleurs résultats, utilisez des documents bien structurés avec des titres et paragraphes clairs.

Le widget InfoLens est un fragment JavaScript léger qui ajoute une interface de chat alimentée par l'IA à n'importe quel site web. Pour obtenir le code d'intégration, ouvrez la page de détails de votre agent et accédez à l'onglet "Intégration et SDK". Le widget prend en charge la personnalisation : changez le message d'accueil, le texte indicatif, les couleurs et la position.

Chaque agent dans InfoLens peut être ajusté via son panneau de configuration. Les paramètres clés incluent le prompt système, la température, la sélection du modèle et les tokens maximum. Le prompt système est la configuration la plus importante. Il indique à l'IA comment se comporter et quel ton utiliser. Les limites d'utilisation peuvent être définies par agent pour contrôler l'utilisation quotidienne et mensuelle.

InfoLens utilise un système RBAC dynamique propulsé par Casbin. Le modèle de permissions comprend 14 ressources et 35 permissions. En tant qu'administrateur, vous pouvez inviter des utilisateurs dans votre tenant et leur attribuer des rôles. Les rôles par défaut incluent propriétaire, administrateur, enseignant, étudiant et auditeur. Pour gérer les utilisateurs, allez dans Administration > Utilisateurs. Pour configurer les rôles, allez dans Administration > Rôles.

InfoLens s'intègre à pratiquement n'importe quel site web ou plateforme. La méthode la plus simple est le widget d'intégration. Pour WordPress : installez un plugin comme "Insert Headers and Footers". Pour Shopify : allez dans Boutique en ligne > Thèmes > Modifier le code. Pour les applications React/Next.js, utilisez le package TypeScript @infolens/sdk pour une intégration plus approfondie.

InfoLens prend en charge deux méthodes d'authentification : les jetons Bearer JWT et les clés API. Les deux fonctionnent sur tous les endpoints de l'API. Pour obtenir un jeton JWT, connectez-vous avec le flux e-mail sans mot de passe : envoyez une requête POST à /v1/users/login/otp/request avec votre e-mail, puis POST /v1/users/login/otp/verify avec le code à 6 chiffres reçu par e-mail. La réponse inclut un access_token à placer dans l'en-tête Authorization sous la forme "Bearer {token}". Les jetons expirent après le TTL configuré. La connexion OAuth Google et GitHub est également disponible lorsqu'elle est configurée — découvrez les méthodes activées via GET /v1/users/auth/methods. Les clés API sont idéales pour les intégrations serveur à serveur et le serveur MCP.

InfoLens peut ingérer du contenu directement depuis des pages web. Pour scraper un site web, utilisez l'API d'importation de documents avec une URL au lieu d'un fichier. Pour le scraping en masse, vous pouvez fournir plusieurs URLs via l'API. Chaque URL devient un document séparé. Notez que le scraping web respecte robots.txt et nécessite que le site cible soit accessible depuis votre serveur.

InfoLens comprend plusieurs fonctionnalités pour la conformité RGPD et la confidentialité des données. L'architecture multi-tenant assure l'isolement complet des données entre les organisations. Le journal d'audit suit toutes les actions significatives : création d'utilisateurs, modifications de rôles, importations de documents et modifications de paramètres. Pour la rétention des données, configurez les limites par tenant via Administration > Paramètres.