> For the complete documentation index, see [llms.txt](https://help.glpi-project.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.glpi-project.org/doc-plugins/fr/plugins-glpi-network/glpi-ai.md).

# GLPI AI

## Prérequis (auto-hébergé)

| Version GLPI | PHP minimum | PHP Recommandé |
| ------------ | ----------- | -------------- |
| 11.0.x       | 8.2         | 8.4            |
| 12.0.X       | 8.3         | 8.5            |

{% hint style="info" %}
Une souscription [GLPI Network BASIC](https://services.glpi-network.com/#offers) (ou supérieur) est requis. Ce plugin est également disponible pour toutes les instances [Cloud](https://glpi-network.cloud) de GLPI Network.
{% endhint %}

{% hint style="info" icon="eyes" %}
Pour les installations on-premise, vous pouvez consulter la partie configuration par défaut

<a href="#configuration-du-serveur-pour-glpi-ai" class="button secondary" data-icon="desktop-arrow-down">Voir la configuration par défaut</a>
{% endhint %}

## Installer le plugin

* Rendez-vous sur le marketplace. Téléchargez et installez le plugin **GLPI AI**.

<div align="left"><figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/gMBOpaaYCdObSmVvE8l6/Unknown%20image" alt=""><figcaption></figcaption></figure></div>

***

## Configurer le plugin

Cette étape peut être rejouée à tout moment. Un bouton pour la déclencher est disponible en haut à gauche de l'onglet **`Configuration du provider`**.

<div align="left"><figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/SbBIedh4ZUbAiVteE4fc/Unknown%20image" alt="" width="545"><figcaption><p>Bienvenue dans GLPI AI</p></figcaption></figure></div>

### Choisir votre Provider

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Ft2A9cApl2XMtOuFGDRmc%2FGLPIAI-wizard-begin.png?alt=media&amp;token=d1000903-b732-45af-b82f-0566dca56bd3" alt="" width="548"><figcaption><p>Choisissez votre provider</p></figcaption></figure></div>

{% hint style="success" icon="lightbulb-on" %}
**GLPI AI** vous permet d'opter pour une **infrastructure auto-hébergée** (self-hosted). Lors de la configuration, plusieurs paramètres de connexion devront être complétés.

* Clé d'API
* URL de l'hôte
* Modèle par défaut
* ID du modèle personnalisé

Le **point de terminaison** (endpoint) doit **respecter les spécifications de l’API OpenAI**. Selon l'infrastructure logicielle et les bibliothèques hébergées sur votre instance, des dysfonctionnements ou des incompatibilités partielles peuvent être observés.

<img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FFyEAHJUqHyPzcH26eS3E%2FGLPIAI-self-hosted.png?alt=media&amp;token=958be7a9-e0e5-4c0f-ae03-ca1d363e4e39" alt="Configuré son serveur IA auto-hébergé" data-size="original">
{% endhint %}

### Saisir la clé API et le modèle

<div align="left"><figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/QRc7nganoNpkZopsClCq/Unknown%20image" alt="Entrez votre clé d&#x27;API"><figcaption><p>Entrez votre clé d'API</p></figcaption></figure></div>

### Sélectionner les fonctionnalités IA

Sélectionnez les fonctionnalités souhaitées pour votre instance.

* Résumer
* Traduction
* Assistant de rédaction
* Suggérer la catégorie
* Suggérer l'urgence

<div align="left"><figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/WvBwxjrPJMwMt8IvS7Gt/Unknown%20image" alt="" width="543"><figcaption><p>Choisissez vos fonctionnalités</p></figcaption></figure></div>

Étape optionnelle : Si un jeton d'API a déjà été généré depuis le profil utilisateur (**`Administration`** > **`Utilisateurs`** > *Utilisateur* > **`Jeton d'API`**) ou via les préférences utilisateur (**`Mes préférences`** > **`Jeton d'API`**), il sera pré-rempli ; sinon, vous pouvez en générer un nouveau.

<div align="left"><figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/TbKkRWUx635iKsk1CUk0/Unknown%20image" alt="" width="543"><figcaption><p>Autorisations pour le serveur MCP</p></figcaption></figure></div>

### Recherche sémantique et vectorisation

Afin d'élargir les capacités de recherche à travers les tickets et la base de connaissances et de garantir des résultats plus pertinents, vous pouvez indexer vos bases de données de tickets et d'articles de la base de connaissances (en les convertissant en vecteurs). Par exemple, lors d'une requête sur des tickets liés à des problèmes de connexion, GLPI sera en mesure d'afficher une liste de résultats plus large — incluant des problèmes de SSO, des mots de passe utilisateur oubliés ou des coupures internet causant un échec de SSO, entre autres.

Vous pouvez ignorer cette étape et la configurer ultérieurement. Sinon, il vous sera demandé de saisir le fournisseur souhaité ainsi que le modèle.

Vous pouvez tester la connexion pour vérifier que la communication entre GLPI et votre fournisseur est opérationnelle.

{% hint style="warning" icon="sack-dollar" %}
**Remarque : cette étape consomme des crédits.**
{% endhint %}

<div align="left"><figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/RXigNBggs4w5VJYxXXdG/Unknown%20image" alt="" width="546"><figcaption><p>Provider pour la sectorisation de l'instance</p></figcaption></figure></div>

### Habilitations

Sélectionnez les profils ayant la possibilité d'utiliser GLPI AI.

* Seulement moi
* Tous les techniciens
* Personne

<div align="left"><figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/uVtLIbHuntqj7olPM2T6/Unknown%20image" alt="" width="547"><figcaption><p>Autorisations d'utilisation des services GLPI AI</p></figcaption></figure></div>

### Résumé avant validation

Assurez-vous que tout est correctement configuré avant de confirmer vos paramètres.

<div align="left"><figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/JVesQXD2HihOTrgz1eTI/Unknown%20image" alt="" width="546"><figcaption><p>Résumé avant validation</p></figcaption></figure></div>

***

## Fournisseurs

Vous pouvez configurer plusieurs fournisseurs. Des clés API vous seront demandées, ainsi que des URL pour certains fournisseurs.

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FOx0bDSpeJrbwekMJjBTh%2Ff4fc5a52-4c49-46e6-a18d-857cfb45e62e.png?alt=media&amp;token=bb9244f5-7796-4c5d-be1e-06e6cf1fad98" alt=""><figcaption><p>Lsite des providers</p></figcaption></figure>

Vous pouvez sélectionner votre fournisseur par défaut en utilisant l'icône étoile.

***

## Fonctionnalités

Vous pouvez choisir les fonctionnalités qui seront activées, ainsi que le fournisseur associé.

### Chat

| Fonctionnalités                       | Options disponibles                                                                                                             | Description                                                                                                                                                                                                                                                                           |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat**                              | Exposer les outils MCP au chat                                                                                                  | <p>Lorsqu'activé, l'assistant peut lire, rechercher et mettre à jour les données GLPI via les outils MCP.<br><br>L'approbation de l'utilisateur sera demandée pour les actions modifiant les données (tout ce qui n'est pas LECTURE) ainsi que pour tous les appels MCP externes.</p> |
| Réponses du chat en continu (Stream)  | Afficher la réponse au fur et à mesure qu'elle est générée au lieu d'attendre la réponse complète.                              |                                                                                                                                                                                                                                                                                       |
| **Saisie vocale (Speech to text)**    | Arrêt automatique lors d'un silence                                                                                             | Lorsqu'activé, l'enregistrement s'arrête automatiquement après \~1,5 seconde de silence.                                                                                                                                                                                              |
| Envoi automatique après transcription | Lorsqu'activé, le texte transcrit est envoyé automatiquement au chat sans que l'utilisateur n'ait besoin d'appuyer sur Envoyer. |                                                                                                                                                                                                                                                                                       |

### Contenu

| Fonctionnalités                        | Options disponibles                                                                                                                                                                                                                                                                                                                           | Description                                                                                 |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Résumer**                            | Mode de résumé                                                                                                                                                                                                                                                                                                                                | Le mode automatique rafraîchira le résumé à chaque mise à jour d'élément ou ajout de suivi. |
| Générer les résumés manquants          | Lister les tickets qui ne possèdent pas de résumé afin de les traiter ultérieurement via une action automatique (un processus moins coûteux). L'action automatique `**Glpiai - processSummaryQueue**` doit être configurée.                                                                                                                   |                                                                                             |
| Soumission automatique par lot (Batch) | Lorsque la file d'attente contient au moins 200 éléments en attente, une tâche par lot à tarif réduit est soumise au fournisseur au lieu de traiter les éléments un par un. Les résultats sont attendus sous 24 heures. L'action automatique `**Glpiai - pollBatchJob**` doit être configurée (**`Configuration` > `Actions automatiques`**). |                                                                                             |
| **Traduction**                         | Pas d'autre option                                                                                                                                                                                                                                                                                                                            |                                                                                             |
| **Assistant de rédaction**             | Actions de rédaction du gestionnaire                                                                                                                                                                                                                                                                                                          | Consultez le chapitre sur les actions de rédaction pour voir plus d'options.                |

### Classer

| Fonctionnalités           | Options disponibles      | Description                                                                                                                                                                                                 |
| ------------------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Suggérer la catégorie** | Exécuter automatiquement | <p>Cette fonctionnalité sera exécutée lors de chaque création d'élément ITIL. Elle écrasera toute valeur préremplie.<br>La création d'éléments peut être ralentie si vous utilisez un modèle d'IA lent.</p> |
| **Suggérer l'impact**     | Exécuter automatiquement | <p>Cette fonctionnalité sera exécutée lors de chaque création d'élément ITIL. Elle écrasera toute valeur préremplie.<br>La création d'éléments peut être ralentie si vous utilisez un modèle d'IA lent.</p> |
| **Suggérer l'urgence**    | Exécuter automatiquement | <p>Cette fonctionnalité sera exécutée lors de chaque création d'élément ITIL. Elle écrasera toute valeur préremplie.<br>La création d'éléments peut être ralentie si vous utilisez un modèle d'IA lent.</p> |

### Contenu lié

| Fonctionnalités                                           | Options disponibles | Description |
| --------------------------------------------------------- | ------------------- | ----------- |
| **Trouver des éléments de la base de connaissances liés** | Pas d'autre option  |             |
| **Trouver des tickets liés**                              | Pas d'autre option  |             |

Pour changer de fournisseur, cliquez sur le fournisseur actuel, sélectionnez « Modifier », puis choisissez le fournisseur souhaité.

<figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/uy5VEs3ieDGrsXbZRgjK/Unknown%20image" alt=""><figcaption><p>Modifier une fonctionnalité</p></figcaption></figure>

***

## Actions rapides

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FWDWS6KerU3HvpXECRBuv%2Ff2403cff-59b7-4b7d-8603-09afcae81734.png?alt=media&amp;token=68bb1c49-3601-4dd4-aeaa-3b98f5e1e19f" alt=""><figcaption><p>Parmétrages des actions rapides</p></figcaption></figure>

Les actions rapides sont les actions qui vous sont proposées lors de l'ouverture d'un nouveau chat.

* Expliquer ce ticket
* Analyser les causes racines
* Évaluer les risques
* Améliorer cet article
* Suggérer une solution
* Rédiger une réponse au demandeur

Chaque action rapide contient son propre prompt et quelques options, telles que l'icône à afficher et le contexte (ticket, problème, base de connaissances, etc.).

<figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/zmSWOmJMae7yFseuljQe/Unknown%20image" alt=""><figcaption><p>Options des actions rapides</p></figcaption></figure>

Vous pouvez ajouter votre propre action rapide en cliquant sur **`+ Ajouter une option rapide`**.

<div align="left"><figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/aGVOPlCmy7KABGAsiy6o/Unknown%20image" alt="" width="478"><figcaption><p>Ajouter une action rapide</p></figcaption></figure></div>

***

## Actions de rédaction

Vous pouvez configurer des options pour vous aider lors de la rédaction (ex. : un ton plus professionnel, reformuler, simplifier). Des options par défaut sont disponibles, mais elles peuvent être modifiées ou supprimées.

<figure><img src="https://content.gitbook.com/content/JFKLcURHvFBybgf5dths/blobs/p8ohKht9JaJDagVcQh8J/Unknown%20image" alt=""><figcaption><p>Montrer les actions de rédaction</p></figcaption></figure>

* Vous pouvez ajouter une nouvelle catégorie en cliquant sur **`+ Ajouter une catégorie`**

**Options par défaut**

* Rédaction
  * Corriger
  * Reformuler
  * Simplifier
* Ton
  * Rendre amical
  * Rendre professionnel
* Longueur
  * Développer
  * Raccourcir
  * Points clés
* Générer
  * Proposer une réponse

Chaque action possède son propre prompt et ses options configurables (icône, titre, etc.). 3 options sont disponibles pour chaque action :

* **Nécessite du texte** : Lorsqu'activé sur Désactivé, l'action peut être exécutée sur un éditeur vide.
* **Enregistrer le contexte** : Permet à l'IA de lire l'élément actuel et ses suivis via les outils MCP.
* **Types d'objets** : Sélectionnez un type d'objet (changement, ticket, ordinateur, etc.) ou laissez vide pour proposer l'action partout.

Vous pouvez ajouter une action en cliquant sur **`+ Ajouter une action de rédaction`**

***

## Embeddings

Cette section vous permet de choisir le fournisseur qui gérera la vectorisation des données de votre instance.

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FEOSdPxuzEgC0h7mD8ttv%2F16bceb43-b018-455f-9ef5-12e9537c7f34.png?alt=media&amp;token=5cbe0994-a08b-4ea5-acc6-72c64f7b46d9" alt=""><figcaption><p>Options d'embeddings</p></figcaption></figure>

1. **Moteur** : vous permet de sélectionner le fournisseur responsable de la vectorisation. Vous pouvez configurer un ID de modèle personnalisé.
2. **Indexation** : nombre de fragments (chunks) indexés. Vous pouvez réindexer, accéder aux actions automatiques ou vider l'index depuis le menu.
3. **Profondeur d'historique de recherche** : Détermine le volume de tickets clos et d'articles de la base de connaissances analysés. Plus la valeur est élevée, plus la recherche sera complète, mais plus elle sera lente.
4. **Filtre de bruit** : les phrases répétées sur les tickets (signatures, avertissements) sont retirées avant l'insertion afin que les empreintes restent distinctives. Vous pouvez configurer l'action automatique **`Glpiai - recalibrateBoilerplate`**. Cette tâche automatisée sert à réentraîner GLPI AI afin qu'il apprenne le vocabulaire réellement utilisé par les utilisateurs dans les tickets récents.

***

## Serveurs MCP

Les serveurs MCP permettent à GLPI de récupérer des informations à partir de sites externes (lorsqu'un serveur MCP est disponible), tels qu'une base de connaissances ou la documentation interne de l'entreprise.

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FRdArRYtSj00HhU4egbVw%2F6db7ac76-3132-46fe-9917-54add721c138.png?alt=media&amp;token=3eb51219-04f2-4ea9-89eb-e0e116be88e4" alt=""><figcaption><p>Oipiotns du serveur MCP</p></figcaption></figure>

* Par défaut, le serveur interne de GLPI et la documentation GLPI sont déjà configurés. Vous pouvez les désactiver ou les supprimer selon vos besoins.
* Pour ajouter un nouveau serveur MCP, cliquez sur **`+ Ajouter un serveur`**
* Il vous sera demandé certaines informations telles que :
  * Nom
  * URL
  * Description
  * Authentification
  * En-têtes personnalisés

***

## Utilisation

Vous pouvez consulter l'utilisation (jetons, appels, erreurs, etc.) par fournisseur, par fonctionnalité, etc. Vous pouvez également filtrer l'utilisation par période.

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FZJ4lbxN2nsWefuKRBzDT%2F52a76e5d-03ac-4271-8fcc-d3e77259197a.png?alt=media&amp;token=855f5ec9-499b-4673-82c4-f958530dde77" alt=""><figcaption><p>Utilisation</p></figcaption></figure>

### Données d'utilisation disponibles

* Répartition par fournisseur et modèle
  * Totaux par fournisseur
  * Modèles
* Fonctionnalités & Tendances
  * Fonctionnalités
  * Tendance quotidienne
* Vue détaillée
  * Fournisseur, modèle et fonctionnalité
* Utilisateurs
  * Fonctionnalité, appels, jetons, erreurs par utilisateur

***

## Journaux (Logs)

Vous pouvez consulter les journaux de GLPI AI. Une zone de recherche est disponible et vous pouvez utiliser des étiquettes (tags) pour filtrer les entrées et faciliter leur lecture.

* Débogage (Debug)
* Information (Info)
* Avertissement (Warning)
* Erreur (Error)
* Exception

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2F0cnN4mJzfcHssFc9UZT2%2F7b54dc84-d28c-47e9-9511-bba4fcbcbc71.png?alt=media&amp;token=db3b8edf-6b30-4d62-aca8-532883aa1556" alt=""><figcaption><p>Vue des journaux</p></figcaption></figure>

#### Journalisation de débogage approfondie (Deep debug)

L'activation de cette option enregistre les détails de toutes les interactions avec l'IA (requêtes, réponses et appels MCP) dans le fichier `glpiai-debug.log` au format JSON et les affiche en temps réel ci-dessous.

#### Effacer les journaux

Vide les fichiers `glpiai.log` et `glpiai-debug.log`.

***

## Actions automatiques

| **Nom**                    | **Type d'élément** | **Description**                                                                                                                                                                                                                                                                                                                                               |
| -------------------------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **pollBatchJobs**          | Tâche par lot IA   | Interroge les tâches par lot de l'IA du fournisseur et ingère leurs résultats.                                                                                                                                                                                                                                                                                |
| **processSummaryQueue**    | Général            | Traite la file d'attente de génération de résumés par l'IA en attente.                                                                                                                                                                                                                                                                                        |
| **processVectorQueue**     | Général            | Traite la file d'attente d'indexation des plongements vectoriels en attente.                                                                                                                                                                                                                                                                                  |
| **recalibrateBoilerplate** | Général            | Recalibre les listes de phrases de détection de texte répétitif à partir du corpus de tickets actuels.                                                                                                                                                                                                                                                        |
| **updateModelsDevCatalog** | Général            | Télécharge le dernier catalogue de modèles models.dev (fenêtres de contexte, capacités, tarification) afin que les modèles récemment publiés soient dimensionnés correctement au lieu de se rabattre sur un budget de contexte conservateur. Nécessite une connexion HTTPS sortante vers models.dev ; peut être désactivé depuis la configuration de GLPI AI. |

***

## Spécifications on-premise

### Configuration du serveur pour GLPI AI

GLPI AI appelle des fournisseurs de LLM qui peuvent mettre plusieurs secondes, parfois une minute, à répondre.\
Pendant ce temps, le processus PHP qui traite la requête reste occupé.\
Avec une configuration PHP-FPM par défaut, une poignée de requêtes IA simultanées suffit à rendre toute l'instance GLPI inutilisable (pages qui se figent, puis erreurs 502/504).

Cette page liste les paramètres à vérifier lors de l'installation du plugin.

#### Dimensionner le pool PHP-FPM

PHP-FPM traite une requête par worker.

Chaque tour de chat, résumé, classification ou appel d'outil MCP mobilise un worker jusqu'à ce que le fournisseur réponde, que la réponse soit diffusée en streaming ou non.

Le pool par défaut (`www.conf`) est livré avec `pm.max_children = 5`. Augmentez cette valeur :

```ini
; /etc/php/8.x/fpm/pool.d/www.conf
pm = dynamic
pm.max_children = 40
pm.start_servers = 8
pm.min_spare_servers = 4
pm.max_spare_servers = 12
```

Comment choisir `pm.max_children` :

* **Limite mémoire :** RAM disponible pour PHP ÷ mémoire moyenne par worker. Mesurez cette dernière sur le serveur (`ps -o rss -C php-fpm8.x`) ; les workers GLPI utilisent généralement 40 à 100 Mo.
* **Limite de charge :** nombre d'utilisateurs prévus utilisant l'IA en même temps + trafic GLPI habituel.

Consultez le journal FPM pour repérer le message `server reached pm.max_children setting`. Il indique que le pool est trop petit.

#### Facultatif : un pool dédié au trafic IA

Sur les grosses instances, dirigez le plugin vers son propre pool afin qu'une rafale de requêtes IA ne puisse pas priver le reste de GLPI de ressources.

```nginx
location ~ ^/plugins/glpiai/ {
    fastcgi_pass unix:/run/php/php8.x-fpm-glpiai.sock;
    # ... mêmes paramètres fastcgi que dans le bloc location principal de GLPI
}
```

#### Délais d'expiration et mise en mémoire tampon du proxy

Les réponses en streaming utilisent des Server-Sent Events (SSE). Le serveur web ne doit pas les mettre en mémoire tampon et doit attendre suffisamment longtemps pour les tours de conversation longs.

**nginx**

```nginx
fastcgi_read_timeout 300s;
fastcgi_buffering off;   # le plugin envoie aussi X-Accel-Buffering: no
gzip off;                # pour la location du plugin, si gzip met le flux en mémoire tampon
```

**Apache (PHP-FPM via mod\_proxy\_fcgi)**

```apache
ProxyTimeout 300
<Proxy "fcgi://localhost/" enablereuse=on flushpackets=on>
</Proxy>
```

Vérifiez également que `zlib.output_compression` est sur `Off` dans `php.ini`, et qu'aucun reverse proxy ni WAF placé devant GLPI ne met en mémoire tampon les réponses `text/event-stream`.

#### Activer HTTP/2

Avec HTTP/1.1, les navigateurs ouvrent au maximum 6 connexions par site, partagées entre tous les onglets.\
Un flux ouvert en occupe une : plusieurs onglets GLPI en streaming simultané peuvent donc bloquer le chargement des pages dans le navigateur.\
HTTP/2 fait transiter toutes les requêtes sur une seule connexion et supprime cette limite.

HTTP/2 nécessite HTTPS.

```nginx
server {
    listen 443 ssl;
    http2 on;       # nginx >= 1.25.1 ; versions plus anciennes : "listen 443 ssl http2;"
}
```

```apache
# mod_http2 activé ; nécessite PHP-FPM (pas mod_php avec le MPM prefork)
Protocols h2 http/1.1
```

HTTP/2 n'ajoute pas de workers PHP : la section 1 reste applicable.

#### Clients MCP : privilégier Streamable HTTP

Les clients MCP externes (Claude Desktop, VS Code, …) peuvent se connecter de deux façons :

| Transport        | Configuration    | Coût côté serveur                                  |
| ---------------- | ---------------- | -------------------------------------------------- |
| Streamable HTTP  | `"type": "http"` | Un worker par requête, uniquement pendant l'appel  |
| SSE (historique) | `"type": "sse"`  | Un worker occupé tant que le client reste connecté |

Configurez les clients avec Streamable HTTP dès qu'ils le prennent en charge.

Le flux SSE historique est fermé par le serveur toutes les 5 minutes et le client se reconnecte, mais en pratique chaque client SSE connecté continue d'occuper un worker en permanence.

### Plugin GLPI MCP

Plugin serveur MCP (Model Context Protocol) pour GLPI 11.\
Ce plugin permet à des clients IA comme Claude Desktop, des assistants d'IDE ou un futur assistant IA intégré à GLPI d'interagir avec GLPI via un protocole standardisé.

#### Fonctionnalités

* **Serveur MCP** : expose les fonctionnalités de GLPI via le protocole MCP
* **Authentification par jeton d'API** : utilise le système de jetons d'API existant de GLPI pour un accès sécurisé
* **Authentification par session** : prend en charge l'authentification interne par session pour le futur assistant IA de GLPI

#### Configuration

#### Claude Desktop

Ajoutez ceci à votre fichier `claude_desktop_config.json` :

```json
{
    "mcpServers": {
        "glpi": {
            "url": "https://your-glpi.example.com/plugins/glpiai/mcp",
            "headers": {
                "App-Token": "YOUR_GLPI_APP_TOKEN",
                "Authorization": "user_token YOUR_GLPI_USER_TOKEN"
            }
        }
    }
}
```

#### VS Code (GitHub Copilot)

Ajoutez ceci au fichier `settings.json` de VS Code :

```json
{
    "glpi-sse": {
        "url": "https://your-glpi.example.com/plugins/glpiai/mcp",
        "type": "sse",
        "headers": {
            "App-Token": "YOUR_GLPI_APP_TOKEN",
            "Authorization": "user_token YOUR_GLPI_USER_TOKEN"
        }
    }
}
```

ou

```json
{
    "mcp": {
        "servers": {
            "glpi": {
                "url": "https://your-glpi.example.com/plugins/glpiai/mcp",
                "type": "http",
                "headers": {
                    "App-Token": "YOUR_GLPI_APP_TOKEN",
                    "Authorization": "user_token YOUR_GLPI_USER_TOKEN"
                }
            }
        }
    }
}
```

#### Obtenir les jetons d'API

1. **Jeton d'application (App Token)** : Configuration > Générale > API
   * Ajoutez un nouveau client de l'API
   * Copiez le jeton d'application généré
2. **Jeton utilisateur (User Token)** : Administration > Utilisateurs > \[Votre utilisateur] > Clés d'accès distant
   * Régénérez le jeton d'API si nécessaire
   * Copiez le jeton utilisateur

#### Points de terminaison

| Point de terminaison          | Méthode | Description                                                                                                         |
| ----------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| `/plugins/glpiai/mcp`         | GET     | Flux SSE historique (envoie l'URL du point de terminaison des messages, fermé après 5 min, le client se reconnecte) |
| `/plugins/glpiai/mcp`         | POST    | Transport Streamable HTTP (JSON-RPC)                                                                                |
| `/plugins/glpiai/mcp/message` | POST    | Point de terminaison des messages JSON-RPC (transport SSE historique)                                               |
| `/plugins/glpiai/mcp/health`  | GET     | Contrôle d'état                                                                                                     |

Privilégiez le transport Streamable HTTP (`"type": "http"`) : chaque client SSE historique garde un worker PHP occupé tant qu'il est connecté.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.glpi-project.org/doc-plugins/fr/plugins-glpi-network/glpi-ai.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
