> For the complete documentation index, see [llms.txt](https://cleyrop.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cleyrop.gitbook.io/docs/v4.7/administration/gerer-les-modeles-et-les-cles-api.md).

# Gérer les modèles et les clés API

Configurez les modèles d'IA et les clés API utilisés par la plateforme Cleyrop.

En tant que Platform Manager, vous pouvez connecter vos propres fournisseurs de modèles IA (OpenAI, Mistral, Anthropic, OVH, etc.), définir les modèles par défaut utilisés par Le Druide et les corpus, et rendre les autres modèles disponibles pour les développeurs via la librairie PyAI.

<figure><img src="https://content.gitbook.com/content/Lve2h8CdCFZ7rIwwaoUU/blobs/0kVL2WuCAozaWuszn2nw/image.png" alt=""><figcaption></figcaption></figure>

***

### Types de clés API

Deux types de clés coexistent dans l'interface :

**Clés client** : ajoutées par le Platform Manager, entièrement modifiables et supprimables.

**Clés Cleyrop** : préconfigurées par Cleyrop. Leurs modèles sont utilisables et peuvent être définis comme modèles par défaut. Elles ne peuvent pas être supprimées.

### Ajouter une clé API

1. Cliquez sur **+ Ajouter**
2. Renseignez le **Nom**, l'**Endpoint** (URL de l'API du fournisseur) et la **Clé API**
3. Cliquez sur **Récupérer les modèles** pour importer la liste des modèles disponibles chez ce fournisseur, ou sur **Ajouter manuellement** pour saisir un modèle
4. Ajoutez un **Nom** d'affichage pour chaque modèle si nécessaire
5. Validez

La clé apparaît dans la liste avec ses modèles associés.

{% hint style="info" %}
Le fournisseur doit exposer une API compatible avec le format OpenAI. Le nom technique (techname) d'un modèle n'est modifiable qu'à la création et uniquement pour les modèles ajoutés manuellement.
{% endhint %}

### Configurer les modèles par défaut

Trois modèles par défaut sont définis pour la plateforme, dans la section **Configuration** de la page :

* **Modèle LLM pour l'assistant global** — utilisé par Le Druide et les Agents pour les conversations. Accessible dans PyAI via `"default-instruct"`.
* **Modèle d'embedding du RAG** — utilisé pour la vectorisation des corpus. Accessible dans PyAI via `"default-embedding"`.
* **Modèle pour générer du code** — utilisé notamment pour générer les requêtes SQL du Tool **Cleyrop Dataset**. Accessible dans PyAI via `"default-coder"`.

Pour modifier un modèle par défaut :

1. Dans la section **Configuration**, cliquez sur l'icône **Modifier** de la carte concernée (**Configurer** si aucun modèle n'est encore défini)
2. Sélectionnez le modèle dans la liste
3. Renseignez ses paramètres :
   * **Maximum de tokens par réponse** (obligatoire) pour le modèle de l'assistant global et le modèle de génération de code
   * **Longueur du contexte** (obligatoire), **Taille maximum du batch** et **Maximum de tokens par batch** pour le modèle d'embedding
4. Cliquez sur **Sauvegarder**

Le changement de modèle par défaut est **immédiatement effectif** sur toute la plateforme.

{% hint style="info" %}
Les actions de la section **Configuration** sont désactivées tant qu'aucune clé API n'a été ajoutée.
{% endhint %}

{% hint style="warning" %}
Le Druide est validé avec les modèles de la famille **GPT** fournis par défaut (ex. `gpt-oss-120b`). Vous pouvez définir un autre modèle instruct par défaut, mais sans garantie de bon fonctionnement : appel des Tools, génération de documents et de graphiques, qualité des réponses peuvent être dégradés.
{% endhint %}

{% hint style="warning" %}
Certains modèles raisonnent longuement avant de répondre (par exemple `Qwen3.5-397B-A17B`). Définis comme **Modèle LLM pour l'assistant global** ou **Modèle pour générer du code**, ils peuvent porter le temps de réponse du Druide à plusieurs minutes par question, notamment avec le Tool **Cleyrop Dataset**. Le niveau de raisonnement n'est pas réglable depuis la plateforme : testez le modèle sur quelques questions représentatives avant de le définir par défaut.
{% endhint %}

{% hint style="warning" %}
Le champ **Maximum de tokens par réponse** est enregistré mais n'est actuellement pas appliqué aux requêtes envoyées au modèle : il ne limite pas la longueur des réponses.
{% endhint %}

{% hint style="warning" %}
Un corpus créé avec un modèle d'embedding donné ne peut pas être utilisé avec un autre modèle d'embedding. Veillez à ne pas changer le modèle d'embedding par défaut si des corpus existants en dépendent.
{% endhint %}

### Modifier ou supprimer une clé API

* **Modifier** : cliquez sur l'icône **Modifier** de la clé, modifiez les champs souhaités et sauvegardez. Un modèle défini comme modèle par défaut ne peut pas être retiré de la clé : l'action est désactivée avec le message « Suppression impossible car utilisé dans la configuration. ».
* **Supprimer** : cliquez sur l'icône **Supprimer** de la clé, puis confirmez en saisissant le nom de la clé. La suppression est impossible tant qu'un des modèles de la clé est défini comme modèle par défaut : changez d'abord le modèle par défaut. Les clés Cleyrop ne peuvent pas être supprimées.

### Suivre la consommation de tokens

Depuis **Administration > Monitoring**, onglet **Tokens**, vous pouvez suivre la consommation de tokens de vos modèles LLM.

La page affiche pour la période sélectionnée :

* **Tokens de prompt** : tokens envoyés aux modèles
* **Tokens de complétion** : tokens générés en réponse
* **Total tokens** : somme des deux

Un graphe d'évolution est affiché pour chaque modèle configuré, avec le nom du modèle et le fournisseur associé. Vous pouvez naviguer entre les périodes via les flèches de navigation.