ManageMate Intelligence (BYOK)

ManageMate Intelligence (MMI) est l'assistant intégré de HRTime : il répond aux questions des utilisateurs sur la base des procédures de la plateforme (congés, paie, pointage…), dans le périmètre RH.

MMI est un routeur multi-provider : selon la nature de la demande (raisonnement complexe, appel d'outil RH, classification, contrainte de souveraineté UE…), il choisit le modèle le plus adapté parmi plusieurs providers IA, au lieu de dépendre d'un unique fournisseur configuré.

En on-premise, MMI fonctionne en mode BYOK (Bring Your Own Key) : vous fournissez vos propres clés API auprès des providers pris en charge — Anthropic, OpenRouter, Mistral, Google (Gemini/Vertex AI). Vous payez votre consommation directement au(x) provider(s), sans surcoût licence.

Configuration

MMI doit être inclus dans votre licence (mmi_enabled) — éditions Pro et Business. Côté backend, renseignez la (ou les) clé(s) API du ou des providers que vous souhaitez activer :

# Backend : ajouter dans .env, selon le(s) provider(s) choisi(s)
OPENROUTER_API_KEY=sk-or-...      # provider principal du routeur
ANTHROPIC_API_KEY=sk-ant-...
MISTRAL_API_KEY=...
GEMINI_API_KEY=...                 # ou GOOGLE_AI_API_KEY

# Endpoint personnalisé (facultatif, par provider)
OPENROUTER_BASE_URL=https://...
ANTHROPIC_BASE_URL=https://...
MISTRAL_BASE_URL=https://...
GEMINI_BASE_URL=https://...

Aucune clé n'est obligatoire en tant que telle : le routeur utilise les providers pour lesquels une clé est renseignée, selon la matrice de routage (config/ai.yaml), et bascule sur un modèle de repli si un provider n'est pas configuré.

Puis redémarrer le backend :

docker compose restart backend

Comment MMI choisit le modèle

MMI ne repose pas sur un provider unique : chaque demande est associée à un type de besoin (« hint »), et le routeur sélectionne le modèle le plus pertinent :

• Raisonnement complexe → Anthropic (Claude Sonnet)
• Raisonnement simple / volume → OpenRouter (DeepSeek)
• Appel d'outils / actions RH → OpenRouter (Claude Haiku)
• Recherche documentaire, classification → Google (Vertex AI / Gemini)
• Contrainte de souveraineté UE → Mistral
• Repli par défaut → Gemini Flash (ou Mistral si la souveraineté UE est requise)

Ce comportement peut être forcé pour un cas précis via la variable MMI_SMART_MODEL="adapter:modele".

Endpoints personnalisés

La personnalisation des URL de providers (passerelle interne, proxy de conformité, déploiement compatible) est réservée aux déploiements on-premise, éditions Pro et Business : elle se configure par provider (ex. OPENROUTER_BASE_URL, ANTHROPIC_BASE_URL) au niveau de votre tenant. En SaaS, ces URL personnalisées ne sont pas prises en compte : seuls les endpoints ManageMate sont utilisés.

Si vous ne souhaitez pas gérer de clés

Une option de clés gérées par ManageMate (« Bridge MMI ») est disponible en add-on : la consommation IA est alors facturée via votre licence. Se rapprocher de votre contact commercial.

Limites

• MMI nécessite un endpoint IA joignable. En réseau totalement air-gapped, deux options : désactiver MMI, ou pointer les providers vers un endpoint IA hébergé sur votre réseau interne (les URL personnalisées http://localhost* ou une adresse https:// interne sont acceptées en on-premise) — aucun appel vers Internet n'est alors nécessaire.
• Le périmètre de l'assistant est cadré RH/paie/management : ce n'est pas un assistant généraliste.
• En on-premise, l'édition Starter ne dispose pas de MMI (mmi_enabled = non) ; les éditions Pro et Business l'activent avec la pleine capacité (les quotas et le contrôle par SKU appliqués en SaaS ne s'appliquent pas ici).