> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/creer-avec-lia/using-the-ai-assistant.md).

# Utilisation de l'assistant IA

{% hint style="warning" %}
🚧 **Accès anticipé.** Build with AI est déployé progressivement et s'améliore à chaque version. Quelque chose n'est pas clair, manque ou ne fonctionne pas ? [Dites-le-nous](/experience-cloud/experience-cloud-fr/aide/how-do-i-contact-support.md): vos retours déterminent directement ce que nous améliorerons ensuite.
{% endhint %}

Vous n’invoquez pas vous-même les compétences ni les outils MCP. Décrivez le résultat en langage simple, et l’assistant active la bonne compétence et recherche les véritables informations du composant via le serveur MCP.

## La bonne compétence s’active pour vous

| Vous travaillez sur…                                                    | Compétence qui s’active        |
| ----------------------------------------------------------------------- | ------------------------------ |
| Composants Avonni sur une page de site Digital Experience               | `avonni-experience-components` |
| Composants d’écran de flux Avonni dans un flux d’écran                  | `avonni-flow-components`       |
| Un composant dynamique Avonni                                           | `avonni-dynamic-components`    |
| Composants Avonni dans du code LWC (HTML/JS/CSS)                        | `avonni-lwc-components`        |
| Tout ce qui couvre plusieurs types d’artefacts ou un cas d’usage métier | `avonni-architect`             |

{% hint style="info" %}
**Règle générale :** un seul artefact d’un type connu va vers sa compétence spécifique. Une demande qui couvre plusieurs types d’artefacts ou décrit un cas d’utilisation de bout en bout va vers `avonni-architect`. En cas de doute, décrivez simplement l’objectif : les règles d’activation des compétences prennent cette décision pour vous.
{% endhint %}

## Idées de prompts

Copiez l’un de ces exemples, adaptez les noms d’objets à votre organisation et envoyez-le. Référez-vous aux composants par les noms utilisés dans cette documentation : « Data Table », « Kanban », « Gallery », « Banner ». L’assistant résout chaque nom vers le bon composant via le serveur MCP.

{% tabs %}
{% tab title="🆕 Ajouter un composant" %}

> Ajoutez un Kanban Avonni des Cas regroupés par statut à ma page de portail d’assistance.

> Ajoutez un Data Table Avonni des Commandes ouvertes du client à la page du compte.

> Ajoutez une Gallery Avonni d’images de produits à la page d’accueil.

**Ce qui se passe :** le `avonni-experience-components` la compétence s’active, recherche les véritables propriétés et interactions de chaque composant via le serveur MCP, et ajoute le composant configuré à votre page de site. La visibilité des données suit toujours les règles de partage de votre organisation : les utilisateurs du portail ne voient que les enregistrements auxquels ils ont accès.
{% endtab %}

{% tab title="✏️ Mettre à jour une page" %}

> Modifiez le regroupement du Kanban de statut à priorité.

> Afficher uniquement les Cas ouverts dans le Data Table.

> Modifiez le titre et l’image d’arrière-plan du Banner.

**Ce qui se passe :** la compétence lit le fichier de contenu de votre page, vérifie les options du composant via le serveur MCP et applique la modification.
{% endtab %}

{% tab title="⚡ Configurer des interactions" %}
Les interactions relient un événement du composant à une action, directement depuis la page.

> Ouvrez un flux d’écran dans une boîte de dialogue lorsque l’utilisateur clique sur le bouton.

> Naviguez vers la page de l’enregistrement lorsqu’une ligne est cliquée.

> Permettez aux utilisateurs du portail de télécharger le fichier joint.

**Ce qui se passe :** la compétence configure les bons types d’interaction (Ouvrir une boîte de dialogue de flux, Naviguer, Télécharger, Afficher un toast) avec leurs paramètres, en utilisant le véritable catalogue d’interactions du serveur MCP.
{% endtab %}

{% tab title="🧩 Cas d’utilisation complet" %}

> Ajoutez une liste de cas à ma page du portail de support, et un flux d'écran pour créer un cas qui s'ouvre depuis un bouton.

Cela couvre deux types d’artefacts, donc `avonni-architect` s’active. Elle planifie l’architecture, crée d’abord le flux, puis ajoute les composants à la page avec le bouton configuré pour ouvrir ce flux.

**Ce qui se passe :** une seule demande, plusieurs artefacts, le tout relié ensemble dans l’ordre des dépendances.
{% endtab %}
{% endtabs %}

## À quoi s’attendre

Une session typique se déroule en trois étapes :

{% stepper %}
{% step %}

### Recherche

L’assistant interroge le serveur MCP pour les composants concernés, avec leurs propriétés, interactions et options de style.
{% endstep %}

{% step %}

### Planification

Il propose une approche et peut poser des questions de clarification. Pour les demandes impliquant plusieurs artefacts, il présente les artefacts dans l’ordre des dépendances.
{% endstep %}

{% step %}

### Génération

Il crée ou met à jour le fichier de contenu de votre page de site. Relisez-le, déployez-le avec votre processus habituel, puis ouvrez la page dans Experience Builder pour vérifier le résultat et publier le site.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Rien n’est déployé dans votre organisation : le déploiement et la publication restent entre vos mains. Voir Limitations et FAQ.
{% endhint %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-fr/creer-avec-lia/using-the-ai-assistant.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
