Documentation IYALNA

Tout ce qu'il faut pour créer, tester et déployer vos agents IYALNA. Pas encore de compte ? Créer mon agent gratuitement.

Démarrage

Créez un compte : une organisation est créée automatiquement et vous en êtes propriétaire.
Des crédits de bienvenue sont ajoutés à votre solde : aucune clé API n'est nécessaire.
Dans Agents, cliquez sur « Créer un agent » : décrivez-le, ajoutez vos documents, testez-le.
Une fois l'agent testé, déployez-le et partagez-le : aucuns frais d'activation, aucun abonnement.

Gestion des données

Formats acceptés : .txt, .md, .csv, .json, .html, .htm, .pdf, .docx, .xlsx, .png, .jpg, .jpeg, .webp, .mp3, .wav, .m4a, .ogg, .mp4, .webm. Taille maximale par fichier : définie par l'administrateur de la plateforme (20 Mo par défaut).

Après l'import, chaque fichier suit les états : En attente → Traitement en cours → Indexation en cours → Disponible, ou Échec avec un message explicatif. Un traitement en échec peut être relancé jusqu'à trois fois.

Excel (.xlsx) : chaque ligne est indexée avec les en-têtes de ses colonnes, pour que l'agent retrouve et cite une ligne précise. Les formules ne sont pas exécutées : seules les valeurs enregistrées sont lues.
PDF scannés et photos de documents (PNG, JPEG, WebP) : le texte est reconnu automatiquement (OCR), puis indexé comme un document ordinaire. La reconnaissance est facturée à la page ; le solde est vérifié avant de commencer.
Pages web : depuis Données, collez l'adresse d'une page publique. IYALNA en garde une copie ; « Relire la page » la met à jour quand elle change.
À l'import, IYALNA signale les données sensibles détectées (e-mails, téléphones, IBAN, cartes bancaires, numéros d'identité…).

Supprimer une source efface le fichier, ses passages indexés et ses liens avec les agents.

Choix des modèles

Fournisseurs intégrés : Anthropic, OpenAI, Google Gemini, xAI, DeepSeek, Mistral AI, Moonshot AI (Kimi), Qwen (Alibaba Cloud), Ollama (local).

Pour chaque agent, cochez les modèles qu'il peut utiliser. À chaque message, IYALNA identifie le type de demande (conversation, raisonnement, lecture d'image, création d'image, recherche web) et choisit le modèle le plus adapté parmi ceux cochés.
Préférence de routage, réglée agent par agent : « Économique » (toujours le modèle le moins coûteux qui sait faire la tâche), « Équilibré » (par défaut) ou « Qualité maximale » (le plus puissant d'abord).
Si un fournisseur ne répond pas, le message est automatiquement confié au modèle suivant de l'agent. Ce relais peut être désactivé agent par agent : le message échoue alors plutôt que de changer de modèle.
Le modèle utilisé et les crédits consommés sont indiqués sous chaque réponse.
Offre Entreprise : branchez vos propres clés API ou un serveur Ollama depuis la page Modèles ; ces appels ne consomment pas de crédits.

Crédits et paiements

Un seul solde de crédits pour toute l'organisation, utilisable par tous les agents et tous les modèles.
Le coût d'un message dépend du modèle et de la longueur du texte traité ; une image créée et une page web lue ont un coût fixe.
Rechargez depuis la page Crédits : choisissez un pack ou le montant de votre choix et votre moyen de paiement, puis réglez sur la page de paiement sécurisée du prestataire (mobile money ou carte bancaire). IYALNA ne voit jamais votre code secret ni votre numéro de carte.
Tous les pays peuvent payer : par le mobile money de leur pays quand il est proposé, et par carte bancaire partout. Une organisation dont la monnaie n'est pas proposée paie en dollars américains, ou en euros dans la zone euro.

Création d'agents

L'assistant de création avance une page à la fois, une décision par page : identité, apparence, réponses, apprentissage, modèles, capacités, données, accès, protection, entraînement, puis test. Vous pouvez partir d'une solution métier officielle.

Instructions : l'agent répond à partir de ses consignes et des connaissances générales du modèle.
RAG : l'agent recherche d'abord les passages pertinents dans les sources autorisées et cite les extraits utilisés. La recherche combine les mots-clés (BM25) et le sens (vecteurs sémantiques) : une question formulée autrement que le document trouve quand même le bon passage.
Façonnage (fine-tuning) : avec un modèle ouvert (open source, open-weight), le modèle s'entraîne sur les questions-réponses de l'organisation, ses exemples et celles repérées dans ses documents (10 au moins). Le jeu d'entraînement est figé et chiffré ; l'entraînement se suit dans l'onglet « Entraînement » de l'agent.
Pseudonymisation : activée par défaut sur chaque nouvel agent, à l'étape Protection, où vous pouvez la désactiver. Avant chaque envoi au modèle, les e-mails, téléphones, IBAN, cartes bancaires, numéros d'identité, dates de naissance, noms précédés d'une civilité et les termes que vous déclarez sont remplacés par des jetons ([EMAIL_1]…) ; la réponse est rétablie avant de vous être affichée.

Actions : un agent peut agir dans vos logiciels (suivre une commande, créer un ticket…). Une action à valider est préparée par l'agent puis attend, dans la page Demandes, qu'un propriétaire ou un administrateur la valide ; elle n'est marquée « faite » que si votre logiciel a confirmé son exécution.
Passage à un humain : quand une demande sort de son périmètre ou exige une personne, l'agent la transmet à votre équipe, qui la retrouve dans la page Demandes avec la conversation.

Chaque modification de la configuration crée une nouvelle version de l'agent ; changer seulement son apparence, sa description ou son projet n'en crée pas.

Déploiement

Déployer un agent met en service sa dernière version testée. Un seul déploiement est actif par agent ; déployer une nouvelle version remplace la précédente. Un déploiement peut être arrêté à tout moment.

Partage et marketplace

Collaborateurs : invitez-les depuis Paramètres → Membres ; ils reçoivent un lien (e-mail ou WhatsApp) et utilisent les agents selon leur rôle.
Lien public : depuis l'onglet « Partager » d'un agent déployé, créez un lien utilisable sans compte. Les messages consomment vos crédits ; le lien peut être désactivé à tout moment.
Marketplace : depuis l'onglet « Publier », soumettez l'agent. Après vérification par IYALNA, d'autres organisations peuvent en installer une copie : consignes et modèles, jamais vos documents.
Vendre un agent : publiez-le gratuitement, à prix unique ou en abonnement mensuel, dans la devise de votre organisation. À chaque vente, IYALNA retient sa commission et le reste s'ajoute à votre solde éditeur, visible dans la page Revenus ; renseignez-y votre compte de versement (mobile money ou banque) et demandez un versement.

Conversations et confidentialité

Chaque échange avec un agent (espace client, test, lien public, API) est enregistré dans le journal des conversations : question, réponse, sources citées, modèle et crédits.
Les propriétaires et administrateurs voient toutes les conversations de l'organisation ; les autres membres, les leurs.
Les conversations sont chiffrées au repos et supprimées automatiquement après la durée choisie dans Paramètres → Confidentialité (de 1 jour à 1 an, 90 jours par défaut).
L'historique est conservé par IYALNA, jamais renvoyé par le navigateur : un visiteur d'un lien public ne peut ni réécrire la conversation ni la gonfler pour consommer vos crédits.

API

Appelez vos agents déployés depuis vos applications. Créez une clé dans l'espace client (menu API) : elle n'est affichée qu'une fois, peut être limitée à certains agents et à un plafond de crédits par 24 heures, et se révoque instantanément.

POST https://app.iyalna.com/api/public/v1/agents/<agent>/chat
Authorization: Bearer iyk_…
Content-Type: application/json

{ "message": "Combien de jours de congé pour un mariage ?", "conversationId": "…" }

Réponse : conversationId (à renvoyer pour poursuivre l'échange), text, sources, model, credits, usage.
GET /api/public/v1/agents : agents déployés accessibles avec la clé.
Limites : 60 requêtes par minute et par clé, 8 000 caractères par message. Codes : 401 clé invalide ou révoquée, 402 crédits insuffisants, 403 agent non autorisé, 409 agent non déployé, 429 limite atteinte.
Gardez la clé côté serveur : jamais dans une application mobile ou une page web.

Sécurité et bonnes pratiques

Attribuez le rôle le plus restreint suffisant : lecteur pour les utilisateurs qui se contentent d'interroger les agents.
Associez à chaque agent uniquement les sources nécessaires.
Pour les documents contenant des données personnelles, gardez la pseudonymisation activée (elle l'est par défaut) et déclarez les noms à protéger ; elle réduit l'exposition sans remplacer un cadre juridique adapté.
Les comptes s'ouvrent après confirmation de l'adresse e-mail ; l'équipe IYALNA se connecte au back office avec une double authentification.
Vérifiez les conditions de chaque fournisseur de modèles concernant le traitement des données envoyées.
Les réponses d'un agent peuvent être inexactes : vérifiez les extraits cités avant toute décision.

Dépannage

« Crédits insuffisants pour la reconnaissance de texte » : un document scanné est facturé à la page ; rechargez puis relancez la lecture.
« Cet agent a atteint sa limite d'utilisation pour aujourd'hui » : un plafond quotidien du lien public ou de la clé d'API est atteint ; augmentez-le dans l'onglet Partager ou la page API.
« a refusé la clé API (HTTP 401) » : la clé est invalide, révoquée ou n'a pas accès au modèle choisi.
« limite le nombre de requêtes (HTTP 429) » : quota ou débit atteint chez le fournisseur ; réessayez plus tard.
Ollama injoignable : vérifiez que le serveur est démarré et accessible depuis la machine qui exécute IYALNA.
L'agent ne trouve pas l'information : vérifiez que la source est « Disponible » et associée à l'agent, et reformulez avec les termes employés dans le document.