# GLPI AI

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

| Version GLPI | PHP minimum | Recommandé |
| ------------ | ----------- | ---------- |
| 10.0.x       | 8.1         | 8.2        |
| 11.0.x       | 8.2         | 8.4        |

* Clé API OpenAI (plan gratuit ou payant) (<https://platform.openai.com/api-keys>)
* ID d'organisation OpenAI (<https://platform.openai.com/account/organization>)

{% 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 %}

## Installer le plugin

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

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2FQde5hHH7rkalRtC76VXZ%2Fglpiai.png?alt=media&#x26;token=ee4f5daf-39e0-47c9-99e3-e6d021c1ca92" alt="images/glpiai-1.png"><figcaption></figcaption></figure></div>

## Créer une organisation

Après avoir créé un compte OpenAI, vous pouvez créer une organisation depuis les paramètres de votre compte sous l'onglet **Organization** ou en accédant directement à la page <https://platform.openai.com/account/organization>.

Conservez la valeur de l'**Organization ID**, car vous devrez l'insérer dans la configuration du plugin GLPI AI.

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-335207dbd52d8cac659bc7bca92d331149e4b215%2Fglpiai-2.png?alt=media" alt="images/glpiai-2.png"><figcaption></figcaption></figure>

## Créer un secret

* Depuis l'URL <https://platform.openai.com/api-keys>
* Cliquez sur **Create a new key**

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-b06102640a7992762ff8dc6c8098a0501fb18321%2Fglpiai-3.png?alt=media" alt="images/glpiai-3.png"><figcaption></figcaption></figure>

* Donnez un nom à votre secret
* Cliquez sur **Create secret key**

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-451c1486e247649f3b0a42c95fba2867379f367a%2Fglpiai-4.png?alt=media" alt="images/glpiai-4.png"><figcaption></figcaption></figure></div>

Copiez la valeur du secret qui est générée, car vous en aurez besoin plus tard pour configurer le plugin.

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-79ecb945fbf7a8c1055ea00d5b21bf4d404893e1%2Fglpiai-5.png?alt=media" alt="images/glpiai-5.png"><figcaption></figcaption></figure></div>

## Configurer GLPI

* Dans GLPI, allez dans **Configuration > Général > GLPI AI**
* Remplissez les champs avec les valeurs copiées précédemment

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-d6e31289c0a4479ade3490be4cc88daf8b015e29%2Fglpiai-6.png?alt=media" alt="images/glpiai-6.png"><figcaption></figcaption></figure>

* Si votre configuration est correcte, vous pourrez voir les entrées de votre compte, votre consommation et vos préférences.

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-d605b846de11a30656b7d70671fb5cf981bd32ab%2Fglpiai-7.png?alt=media" alt="images/glpiai-7.png"><figcaption></figcaption></figure>

## Consommation

Il est possible de limiter l'utilisation de l'API en spécifiant une limite à ne pas dépasser. Ce plugin suit l'utilisation basée sur chaque réponse d'OpenAI. Par conséquent, vous pourriez avoir besoin d'utiliser le champ "Custom usage" dans la configuration pour prendre en compte l'utilisation en dehors du plugin si vous souhaitez que le plugin en tienne compte dans sa limitation d'utilisation.

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-b8bc02053ac36c0284345fc58a791a8337f70d11%2Fglpiai-8.png?alt=media" alt="images/glpiai-8.png"><figcaption></figcaption></figure></div>

1. Pour limiter l'utilisation et éviter les dépassements, spécifiez une valeur à ne pas dépasser. Si cette limite est dépassée, le plugin ne fonctionnera plus jusqu'à ce que cette valeur soit augmentée.
2. Entrez l'utilisation personnalisée si vous souhaitez prendre en compte l'utilisation précédente en dehors du plugin.

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-ba797a856bd5ef1de36ea471aab2d799d3a63044%2Fglpiai-9.png?alt=media" alt="images/glpiai-9.png"><figcaption></figcaption></figure></div>

## Préférences

Dans les préférences, vous pouvez configurer le modèle de réponse. En mode gratuit, vous pouvez utiliser le modèle GPT-3.5 Turbo 16K.

<div align="left"><figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-658cdaf15969c67f58f7a4865983b9b495f00811%2Fglpiai-10.png?alt=media" alt="images/glpiai-10.png"><figcaption></figcaption></figure></div>

Vous trouverez des informations concernant les autres plans et les limites de plan [ici](https://platform.openai.com/account/limits)

En cliquant sur **Configure preferences**, vous pouvez configurer un contexte et un rôle.

* Le **Context** peut être une description de votre entreprise, de votre mission, de votre rôle dans l'entreprise. L'IA a besoin de comprendre votre contexte pour pouvoir répondre le plus pertinemment possible (il y a un contexte par défaut que vous pouvez modifier).
* Le **Role** est la manière dont l'IA doit répondre. A-t-elle un rôle d'enseignant, de conseiller ou d'expert ? Le rôle peut influencer le ton et le niveau de détail de la réponse (il y a un rôle par défaut que vous pouvez modifier).

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-3b821f1b9912d046d3f3a0a46a84e89f30199ff2%2Fglpiai-11.png?alt=media" alt="images/glpiai-11.png"><figcaption></figcaption></figure>

## Exemple

Vous pouvez voir un exemple de ce qui peut être réalisé avec un échange qui comprend beaucoup de suivis. Le plugin GLPI AI résume tous les suivis pour mettre en évidence les informations principales.

<figure><img src="https://782257568-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJFKLcURHvFBybgf5dths%2Fuploads%2Fgit-blob-29a542bcc1b3917651064d2f9abc584368a25f8f%2Fglpiai-12.gif?alt=media" alt="images/glpiai-12.gif"><figcaption></figcaption></figure>

Si vous souhaitez un autre résultat, vous pouvez cliquer sur **Refresh**.

***

## FAQ

Si vous avez des questions concernant l'utilisation du plugin, n'hésitez pas à consulter notre FAQ

<a href="https://app.gitbook.com/s/VU1qbB9Oe25HAYDAQ4tR/plugins/glpi-ia" class="button secondary">Aller à la FAQ</a>
