Assistant IA

L’assistant répond à vos questions en consultant les données d’AquasManager. Il est facultatif et désactivé par défaut : AquasManager n’embarque aucun modèle d’IA, vous branchez celui de votre choix. Une fois activé, il s’ouvre depuis l’icône de discussion.

Ce qu’il sait faire

L’assistant dispose d’outils qui interrogent l’application :

lister vos aquariums ;
lire la dernière valeur d’un paramètre d’eau ;
lire la valeur actuelle d’un capteur ;
donner l’état d’un équipement ;
calculer un dosage.

« Quel est le dernier KH du récif ? » « Le chauffage est-il allumé ? » « Mon produit relève 100 L de 1 °dKH pour 10 mL : combien en ajouter pour remonter le KH du récif à 8 ? »

Un calcul de dosage fiable

Le calcul de dosage n’est jamais laissé au modèle : c’est un outil déterministe du serveur que l’assistant appelle.

La valeur actuelle du paramètre et le volume du bac sont lus dans l’application.
Le taux de dosage du produit (indiqué sur l’étiquette) vous est demandé s’il n’est pas connu : l’assistant ne l’invente jamais.

Vérifiez toujours la proposition avant de doser.

Brancher un modèle

Tout se règle dans Configuration › Assistant IA (administrateurs) :

choisissez un service, pré-rempli d’un clic ;
indiquez la clé d’API si le service en demande une ;
cliquez sur Liste pour voir les modèles proposés, ou tapez le nom d’un modèle ;
Testez la connexion, puis activez l’assistant et enregistrez.

Service	Type	Où vont vos questions
Ollama	local, gratuit	restent chez vous
LM Studio, llama.cpp, vLLM…	local, gratuit	restent chez vous
Mistral AI, OpenAI, OpenRouter…	externe, payant à l’usage	envoyées au service

Deux types d’API sont pris en charge : l’API d’Ollama et toute API compatible OpenAI (adresse se terminant en général par /v1).

Réglages

Accès aux données : désactivez-le pour un assistant qui répond seulement de façon générale, sans rien lire dans l’application.
Délai de réponse : sans carte graphique, un modèle local peut mettre une minute ou plus.
Clé d’API : chiffrée sur votre serveur avec la clé secrète de l’installation, jamais réaffichée. Si la clé secrète change, ressaisissez la clé d’API.

Choisissez un modèle qui sait appeler des outils (tool calling), sinon l’assistant ne pourra pas lire vos données. Vérifiez aussi que la licence du modèle autorise votre usage.

Brancher votre propre assistant (MCP)

AquasManager est aussi un serveur MCP (Model Context Protocol) : Claude, Home Assistant ou tout assistant compatible peut consulter vos aquariums, sans passer par l’assistant intégré.

Dans le menu de votre compte, ouvrez Accès pour assistants IA et créez un jeton. Il n’est affiché qu’une fois : copiez-le et gardez-le comme un mot de passe.
Dans votre assistant, ajoutez un serveur MCP HTTP à l’adresse indiquée sur la page (celle de l’API suivie de /mcp), avec l’en-tête Authorization: Bearer <jeton>.

Exemple avec Claude Code :

claude mcp add --transport http aquasmanager https://api.example.org/mcp \
  --header "Authorization: Bearer aqm_..."

Avec Home Assistant : ajoutez l’intégration Model Context Protocol. Elle n’accepte qu’une adresse, sans en-tête : mettez le jeton dans l’URL, https://api.example.org/mcp?token=aqm_.... Dans votre agent de conversation (Ollama, Google…), cochez ensuite AquasManager dans « Contrôler Home Assistant ».

L’accès est en lecture seule : aquariums et population, paramètres d’eau avec leur tendance et leur historique, capteurs, équipements, alertes, tâches, stock, carnet de bord, changements d’eau et calcul de dosage. L’assistant ne peut rien modifier ni piloter. Un jeton se révoque à tout moment depuis la même page.