Vos clés IA, pas les nôtres.
Kastel ne vend pas d’IA et ne revend jamais l’inférence : votre Kastel travaille avec la clé de votre entreprise, chez le fournisseur de votre choix, qui vous facture en direct. Une seule clé est nécessaire, pour construire : retrouver se calcule dans votre Kastel.
Deux rôles, une seule clé
Votre Kastel appelle un modèle pour deux choses, et deux seulement. Construire : lire vos documents, mener l’entretien d’organisation, synthétiser votre contexte - c’est ce que votre clé paie. Retrouver : indexer vos pages pour que la recherche trouve la bonne information - ce calcul se fait dans votre Kastel, avec un modèle qu’il embarque, et ne demande aucune clé. Vous pouvez toujours désigner un modèle de recherche externe si vous en préférez un : c’est un réglage, pas une obligation.
La clé vit dans le fichier .env de votre déploiement, jamais dans un fichier versionné, jamais chez nous. Vous décidez ce que chaque IA a le droit de voir ; ce que votre clé envoie au fournisseur relève du contrat que vous avez avec lui.
La clé de construction
Dans le .env de votre déploiement :
Pour l’adresse OpenAI par défaut, c’est tout (le modèle par défaut est gpt-4o-mini). Pour toute autre adresse compatible OpenAI - Mistral, DeepSeek, un vLLM auto-hébergé - ajoutez cette adresse et le modèle :
Le nom de la variable ne change pas selon le fournisseur : c’est la clé de l’adresse compatible OpenAI que vous visez, quelle qu’elle soit.
La recherche, sans clé
L’index de recherche a son propre modèle, séparé du chat. Votre Kastel l’embarque : il tourne dans le moteur, sur votre serveur, sans appel réseau et sans clé. Il n’y a rien à configurer, et rien de plus à payer.
Vous préférez un autre modèle de recherche ? C’est une opération de configuration, pas de code : le bloc retrieval.embeddings de kastel.config.yaml (fournisseur, modèle, dimension - les alternatives documentées sont listées en commentaire dans le fichier), la clé correspondante dans .env si ce modèle en demande une, puis :
Tout le corpus est ré-indexé sur le nouveau modèle : deux espaces de recherche ne sont jamais mélangés. Tant que le reindex n’a pas tourné, la recherche refuse avec un message explicite plutôt que de mêler l’ancien et le nouveau. La règle vaut dans les deux sens : un Kastel déjà installé avec un modèle de recherche externe garde le sien tant que vous ne demandez rien. Une mise à jour ne change jamais votre espace de recherche toute seule.
Sans clé, que se passe-t-il ?
Ce qui manque se dit, plutôt que de se deviner : sans clé, chaque fonction concernée refuse avec son motif. Sur un corpus déjà construit, un Kastel sans aucune clé se lit et se cherche entièrement ; ce qu’il ne peut pas faire, c’est construire. Le détail :
Fonctionne. La lecture directe ne dépend d’aucun modèle.
Fonctionne. Le modèle de recherche est embarqué : il n’a besoin d’aucune clé. Si vous avez désigné un modèle de recherche externe, c’est sa clé qu’il faut.
Exige la clé de construction.
log_trace)Refusé, systématiquement. Voir ci-dessous.
Une trace est du texte libre écrit par un agent sur une vraie session de travail : avant toute écriture, votre Kastel la classifie pour empêcher qu’une donnée personnelle atterrisse dans la mémoire d’entreprise. Sans clé, pas de classifieur - et le choix est de refuser l’écriture plutôt que d’écrire de l’inclassifié. Il n’existe volontairement aucun réglage pour désactiver cette porte : un interrupteur qui l’éteindrait serait un interrupteur qui écrit des données personnelles non classées sur le disque. Même prudence quand la clé existe mais ne répond plus (révoquée, quota atteint) : la classification échoue du côté sûr et le contenu concerné est écarté, sans erreur bruyante. Une clé de construction en panne se surveille.