> For the complete documentation index, see [llms.txt](https://docs.fullwhere.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullwhere.com/automatisations/agents-ia.md).

# Agents IA

Configurez vos agents IA, leurs procédures et leurs actions pour traiter les demandes de vos clients et faire intervenir votre équipe.

{% hint style="success" icon="list-check" %}
**EN BREF**

Les agents IA Fullwhere génèrent des réponses à partir de vos consignes, de vos exemples et des connaissances que vous leur fournissez.

Avec les procédures, ils peuvent exécuter un processus en plusieurs étapes, qualifier une interaction, gérer les réservations et transmettre une demande à votre équipe. Les escalades et le dernier recours encadrent les situations nécessitant une intervention humaine.
{% endhint %}

## Choisir quoi configurer

| Votre besoin                                                                                      | Où le configurer                                                                                                                |
| ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Définir le rôle, le ton et les règles communes de l’agent                                         | [Consignes de rédaction](#h_d4bb965222)                                                                                         |
| Donner des exemples pour des situations récurrentes simples                                       | [Réponses personnalisées](#h_d0f171a565)                                                                                        |
| Fournir les informations sur vos services                                                         | [Bases de connaissances](https://docs.fullwhere.com/automatisations/bases-de-connaissance.md)                                   |
| Traiter une demande en plusieurs étapes, pouvant nécessiter des actions de la part de votre agent | [Procédures](https://docs.fullwhere.com/automatisations/agents-ia/procedures.md)                                                |
| Assigner, notifier ou renseigner des attributs                                                    | [Actions](https://docs.fullwhere.com/automatisations/agents-ia/actions.md)                                                      |
| Gérer les réservations                                                                            | [Gestion des réservations](https://docs.fullwhere.com/automatisations/agents-ia/actions.md#actions-de-gestion-des-reservations) |
| Faire intervenir l’équipe dans une situation précise                                              | [Escalades et dernier recours](https://docs.fullwhere.com/automatisations/agents-ia/escalades-et-dernier-recours.md)            |
| Adapter les consignes à chaque client ou établissement                                            | [Variables dynamiques](#h_3198d4840a)                                                                                           |
| Définir les interactions concernées et valider le résultat                                        | [Tester et déployer un agent](https://docs.fullwhere.com/automatisations/agents-ia/tester-et-deployer.md)                       |

Un **workflow** définit quand utiliser l’agent. Une **procédure** décrit comment traiter une situation. Une **action** réalise une opération dans Fullwhere ou dans un système de réservation à l’endroit prévu dans les instructions.

## Accéder à vos agents <a href="#h_d7b3dc58a2" id="h_d7b3dc58a2"></a>

Ouvrez **Automatisations →** [**Agents IA**](https://app.fullwhere.com/automation/agents). Sélectionnez un agent existant pour modifier sa configuration.

Vous pouvez spécialiser vos agents par famille d’interactions, marque ou localisation, puis définir leur périmètre dans vos [workflows](https://docs.fullwhere.com/automatisations/workflows.md).

{% hint style="info" icon="shield-check" %}
**DROITS D’ACCÈS**

Pour modifier les agents IA de votre espace Fullwhere, vous devez être un membre superviseur avec des droits Administrateur.
{% endhint %}

## Créer un agent <a href="#h_cdb8854904" id="h_cdb8854904"></a>

Depuis la liste des agents, cliquez sur le bouton de création et donnez un nom explicite à votre agent, par exemple **Agent de relation client** ou **Agent de réponse aux avis**.

Configurez ensuite ses consignes et ses ressources, puis enregistrez vos modifications.

## Configurer l’agent <a href="#h_05580acb61" id="h_05580acb61"></a>

Commencez par définir le comportement commun de l’agent et les exemples dont il doit s’inspirer. Ajoutez ensuite les procédures et les règles de passage à l’équipe nécessaires à votre activité.

### Consignes de rédaction <a href="#h_d4bb965222" id="h_d4bb965222"></a>

Les consignes rédactionnelles se répartissent en quatre champs :

| Champ                         | Ce qu’il doit préciser                                                                                          |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **Objectif de l’agent**       | Le rôle à remplir et les demandes à traiter.                                                                    |
| **Instructions de rédaction** | La langue, le ton, le tutoiement ou vouvoiement, les formules de politesse et les formulations à éviter.        |
| **Contexte client**           | Les informations utiles à la personnalisation : prénom, établissement, historique ou satisfaction, par exemple. |
| **Consignes supplémentaires** | Les autres règles communes à respecter.                                                                         |

Utilisez des [variables dynamiques](#h_3198d4840a) pour adapter les consignes à l’interaction. Prévoyez ce que l’agent doit faire si une donnée manque.

Pour les informations détaillées sur vos services, associez une [base de connaissances](https://docs.fullwhere.com/automatisations/bases-de-connaissance.md) à l’action de génération de réponse de votre workflow. Les étapes propres à un cas métier se décrivent dans une [procédure](https://docs.fullwhere.com/automatisations/agents-ia/procedures.md).

### Réponses personnalisées <a href="#h_d0f171a565" id="h_d0f171a565"></a>

Les réponses personnalisées constituent des réponses de référence qu'il peut utiliser pour gérer des situations simples : l’agent s’appuie sur leur sens et leur style, puis adapte leur formulation à la conversation.

Organisez-les en groupes thématiques, par exemple **Avis positifs**, **Réservations** ou **Réclamations**. Précisez les situations dans lesquelles l’agent doit les utiliser.

#### Créer un groupe <a href="#h_c3b4f2dad0" id="h_c3b4f2dad0"></a>

Depuis les réponses personnalisées, cliquez sur **Créer un groupe**, puis renseignez les critères d’application et les exemples de réponses. Chaque réponse comporte un libellé décrivant sa situation et un texte de référence.

Le texte peut contenir des [variables dynamiques](#h_3198d4840a). Validez la création du groupe.

Exemple de situation :

> Le client souhaite modifier une réservation existante, sans avoir précisé le nouvel horaire souhaité.

Exemple de réponse :

> Bonjour {{customer\_first\_name}}, pouvez-vous préciser la nouvelle date, l’horaire et le nombre de personnes souhaités ? Notre équipe vérifiera les possibilités avant de vous confirmer la modification.

#### Gérer les réponses <a href="#h_65b32cb7a6" id="h_65b32cb7a6"></a>

Depuis le tableau des réponses personnalisées, modifiez le libellé et le texte d’une réponse, ouvrez son édition détaillée ou renommez un groupe.

Décrivez des situations suffisamment distinctes pour éviter des exemples contradictoires. Pour une demande qui nécessite des opérations dans Fullwhere, utilisez une procédure avec des actions configurées.

## Créer des procédures

Les [procédures](https://docs.fullwhere.com/automatisations/agents-ia/procedures.md) donnent une marche à suivre à l’agent pour gérer des situations complexes, n'hésitant d'agir étape par étape et d'effectuer des actions précises, dans Fullwhere ou dans des systèmes externes.

## Configurer les actions

Les [actions](https://docs.fullwhere.com/automatisations/agents-ia/actions.md) se créent depuis le menu **/** des instructions. Elles apparaissent sous forme de badges :

* **Transférer à des membres** : définir la prise en charge, les notifications et le comportement de l’agent pour les prochains messages ;
* **Définir des attributs** : renseigner les champs de l’interaction ;
* **Gestion des réservations** : rechercher, créer, modifier ou annuler une réservation selon les capacités autorisées et les réglages propres à l’intégration.

Écrire « transfère la demande » dans une consigne ne remplace pas l’insertion et la configuration d’une action de transfert.

## Prévoir les escalades et le dernier recours

Dans la zone [Escalades](https://docs.fullwhere.com/automatisations/agents-ia/escalades-et-dernier-recours.md), décrivez les situations dans lesquelles votre équipe doit intervenir et insérez les actions correspondantes directement dans les consignes. Configurez aussi le dernier recours pour les demandes que l’agent ne peut pas traiter avec ses ressources.

Par exemple : demande explicite d’un interlocuteur, réclamation à transmettre ou question sans réponse dans les connaissances disponibles.

## Utiliser des variables dynamiques <a href="#h_3198d4840a" id="h_3198d4840a"></a>

Les variables sont remplacées par les données de l’interaction au moment de la génération. Elles permettent d’adapter les consignes, les réponses de référence et le contexte à chaque client.

Dans les nouveaux éditeurs de procédures, d’escalades et de dernier recours, appuyez sur **/** puis choisissez **Insérer une variable**.

Une variable sans donnée disponible est remplacée par un texte vide. Par exemple, un email ne possède pas de note `{{rating}}`. Prévoyez des formulations qui restent naturelles lorsqu’une information manque.

### Variables générales <a href="#h_a055fec090" id="h_a055fec090"></a>

| Variable                        | Description                                                                                                                                                                                     |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{{tags}}`                      | Liste des tags du feedback, affichés entre crochets et séparés par des virgules.                                                                                                                |
| `{{content}}`                   | Contenu textuel du feedback client.                                                                                                                                                             |
| `{{rating}}`                    | Note attribuée par le client dans le feedback.                                                                                                                                                  |
| `{{language}}`                  | Langue cible du feedback.                                                                                                                                                                       |
| `{{source}}`                    | Source du feedback (ex. : Google, Email, Instagram, etc.).                                                                                                                                      |
| `{{class}}`                     | Classe ou catégorie du feedback (Review, Contact, Survey, Message)                                                                                                                              |
| `{{store}}`                     | Nom de la localisation concernée (ex. : magasin, restaurant, agence…).                                                                                                                          |
| `{{store_signature}}`           | Signature associée à la localisation.                                                                                                                                                           |
| `{{store_contact}}`             | Adresse email de contact de la localisation.                                                                                                                                                    |
| `{{brand}}`                     | Nom de la marque associée à la réponse.                                                                                                                                                         |
| `{{brand_signature}}`           | Signature de la marque.                                                                                                                                                                         |
| `{{brand_contact}}`             | Adresse email de contact de la marque.                                                                                                                                                          |
| `{{contact}}`                   | Email de contact utilisé pour la réponse : celui de la localisation si disponible, sinon celui de la marque.                                                                                    |
| `{{signature}}`                 | Signature utilisée pour la réponse : celle de la localisation si existante, sinon celle de la marque.                                                                                           |
| `{{customer_first_name}}`       | Prénom du client (si disponible).                                                                                                                                                               |
| `{{customer_last_name}}`        | Nom du client.                                                                                                                                                                                  |
| `{{customer_full_name}}`        | Nom complet du client (prénom + nom).                                                                                                                                                           |
| `{{customer_civility}}`         | Civilité du client (ex. : M., Mme, Dr, etc.).                                                                                                                                                   |
| `{{customer_feedback_count}}`   | Nombre total de feedbacks laissés par le client.                                                                                                                                                |
| `{{customer_purchase_count}}`   | Nombre total de commandes passées par le client.                                                                                                                                                |
| `{{customer_purchase_count_1}}` | Nombre de commandes du client + 1 (utile pour des formulations anticipatives).                                                                                                                  |
| `{{customer_purchase_amount}}`  | Montant total cumulé des commandes du client.                                                                                                                                                   |
| `{{customer_average_rating}}`   | Moyenne des notes données par le client.                                                                                                                                                        |
| `{{purchase_amount}}`           | Montant de la commande concernée.                                                                                                                                                               |
| `{{purchase_external_id}}`      | Identifiant externe de la commande.                                                                                                                                                             |
| `{{now}}`                       | Permet d'indiquer à votre agent IA la date et l'heure actuelles au moment de générer une réponse. Précisez le fuseau horaire à appliquer dans vos consignes si votre règle dépend d’un horaire. |

### Variables spécifiques aux enquêtes de satisfaction <a href="#h_25b8fbde08" id="h_25b8fbde08"></a>

Utilisez ces variables pour donner du contexte à votre agent en charge de la génération de réponse pour vos enquêtes de satisfaction.

| Variable                  | Description                                              |
| ------------------------- | -------------------------------------------------------- |
| `{{survey_fields}}`       | Liste de tous les champs de l’enquête.                   |
| `{{survey_csat_smileys}}` | Résultats des questions de type *CSAT Smileys*.          |
| `{{survey_nps}}`          | Résultats des questions de type *NPS*.                   |
| `{{survey_csat_stars}}`   | Résultats des questions de type *CSAT Stars*.            |
| `{{survey_notations}}`    | Ensemble des champs de type notation (CSATs & NPS).      |
| `{{survey_choices}}`      | Ensemble des champs à choix (dropdown, checkbox, radio). |

### Variables spécifiques aux formulaires de contact <a href="#h_d4588e34f9" id="h_d4588e34f9"></a>

Utilisez ces variables pour donner du contexte à votre agent en charge de la génération de réponse pour vos formulaires de contact.

| Variable           | Description                                              |
| ------------------ | -------------------------------------------------------- |
| `{{site_choices}}` | Ensemble des champs de type choix (dropdown).            |
| `{{site_texts}}`   | Ensemble des champs de type texte (text & purchase).     |
| `{{site_fields}}`  | Ensemble complet des champs (dropdown, text & purchase). |

### Variables personnalisées

Pour personnaliser davantage vos agents IA, vous pouvez définir des [variables personnalisées](https://docs.fullwhere.com/automatisations/variables.md) dont la valeur sera remplacée en fonction de la marque ou de la localisation concernée.

## Tester et mettre en service

Reliez votre agent à une action **Générer une réponse IA** dans un [workflow](https://docs.fullwhere.com/automatisations/workflows.md#generer-une-reponse-ia), puis validez les réponses et les effets des actions sur des interactions de test.

Suivez le guide [Tester et déployer un agent](https://docs.fullwhere.com/automatisations/agents-ia/tester-et-deployer.md) pour vérifier les seuils des procédures, les transferts, les attributs et le dernier recours.

{% hint style="warning" %}
Désactiver l’envoi automatique conserve les réponses en brouillon, mais ne garantit pas l’absence d’actions exécutées par l’agent. Vérifiez séparément les assignations, les notifications, les modifications d’attributs et les opérations de réservation.
{% endhint %}

## Supprimer un agent

Un agent utilisé dans un workflow ne peut pas être supprimé. Retirez d’abord ses utilisations dans les workflows concernés.


---

# 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://docs.fullwhere.com/automatisations/agents-ia.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.
