> For the complete documentation index, see [llms.txt](https://cogneed.gitbook.io/cogneed-centre-daide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cogneed.gitbook.io/cogneed-centre-daide/chatbot/accueil/chatbots.md).

# Chatbots

Cette section vous permet de créer, de personnaliser et de déployer vos chatbots/assistants.

## Création

Pour créer un nouvel assistant, cliquer sur le bouton jaune "**Créer un assistant**" situé en haut à droite de l'écran.

<figure><img src="https://795534672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz23M1L27gfk5PcwcH4j%2Fuploads%2Fj013X5MKKc7BSxu8Rk3N%2FPicture1.png?alt=media&#x26;token=49a1ea3f-9d47-4369-84a4-9a774ffe4037" alt=""><figcaption></figcaption></figure>

Une fenêtre s'ouvre, au sein de laquelle vous devez renseigner :

* Le nom de l'assistant ;
* Une instruction pour définir son comportement par défaut.

<figure><img src="https://795534672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz23M1L27gfk5PcwcH4j%2Fuploads%2FrseQq7RbcHMryj5Se2qN%2Fimage.png?alt=media&#x26;token=d1bc1d33-01a8-4848-9f90-ce7666e3007a" alt="" width="295"><figcaption></figcaption></figure>

{% hint style="info" %}
Cette instruction est **modifiable** à tout moment par la suite.
{% endhint %}

## Paramétrage

Pour accéder au paramétrage d'un assistant existant, cliquer sur son nom. La page de paramétrage comprend les sections suivantes :

* Des **informations générales** sur le chatbot
* 5 onglets de personnalisation :
  * **Sources de données** : pour définir les sources de données d'apprentissage de votre assistant.
  * **Personnalisation** : pour personnaliser le style de votre assistant.
  * **Déploiement** : pour visualiser, tester et copier le code de déploiement de votre assistant.
  * **Historique** : pour lire les conversations de vos utilisateurs avec votre assistant.
  * **Configuration avancée** : pour personnaliser les instructions données à votre assistant.

### Informations générales

<figure><img src="https://795534672-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgz23M1L27gfk5PcwcH4j%2Fuploads%2FDHbBkKA9De61LuE9e9ve%2Fimage.png?alt=media&#x26;token=3ec11a26-11f2-416c-91a9-66de8ed9151d" alt=""><figcaption></figcaption></figure>

Cette section, visible depuis chacun des onglets de personnalisation, donne des informations sur la date de création de l'assistant, sa date de dernière mise à jour, l'utilisateur à l'origine de sa création, ainsi que sur son statut actuel.

### Statuts

#### **Statut "En construction"**

Lorsque vous créez un assistant, son statut est automatiquement "En construction". Un assistant ayant ce statut ne peut pas être déployé.

Le seul moyen d'interagir avec l'assistant est de cliquer sur le bouton "Prévisualiser" sur l'onglet "Déploiement".

#### **Statut "En prévisualisation"**

Ce statut vous permet de déployer l'assistant en production (sur votre site internet, extranet, intranet ou autre page Web) sans qu'il soit visible des visiteurs.

{% hint style="info" %}
Ce statut est particulièrement utile lorsque vous souhaitez que certains de vos collaborateurs puissent tester l'assistant sans pour autant leur attribuer une licence CogNeed, et sans qu'il soit visible des visiteurs finaux.
{% endhint %}

Pour ce faire, passez l'assistant sous le statut "En prévisualisation" et déployez-le tel que décrit dans l'onglet Déploiement.\
\
Une fois que l'assistant est déployé, pour permettre aux utilisateurs de tests d'y accéder, fournissez-leur l'URL de la page sur laquelle le déploiement a été fait en y ajoutant le paramètre suivant : `cogneed_preview_mode`.

{% hint style="info" %}
**Par exemple** : remplacer <https://www.wikipedia.org/> par <https://www.wikipedia.org/?cogneed_preview_mode>
{% endhint %}

{% hint style="warning" %}

* Si l'url contient quelque chose comme `?quelquechose&autrechose`, alors il faut remplacer par `?quelquechose&autrechose&cogneed_preview_mode`
* Si l'url ne contient pas de bloc commençant par un "?", il faut ajouter à la fin `?cogneed_preview_mode` y compris le `?`
  {% endhint %}

#### **Statut "publié"**

Ce statut vous permet de déployer l'assistant en production (sur votre site internet, extranet, intranet ou autre page Web) en le rendant visible aux visiteurs.

Pour ce faire, passez l'assistant sous le statut "Publié" et déployez-le tel que décrit dans l'onglet Déploiement.