# Base de connaissances

Ajoutez du contexte métier à vos propriétés pour que l'IA fournisse des analyses plus précises et pertinentes.

La base de connaissances vous permet de stocker des informations contextuelles sur une propriété que l'IA consulte pendant les conversations. Au lieu d'obtenir une analyse générique, l'IA comprend votre activité spécifique - vos définitions de conversion, vos schémas saisonniers, vos particularités de données et vos configurations de canaux.

## Pourquoi c'est important

Les modèles d'IA savent ce qu'est un taux de rebond. Ils ne savent pas que votre pic de trafic en mars provient d'un rapport annuel, que le trafic organique en provenance de l'Inde est principalement du trafic de bots, ou que votre équipe utilise des regroupements de canaux personnalisés plutôt que les valeurs par défaut de GA4.

Sans ce contexte, l'IA donne des réponses techniquement correctes mais pratiquement inutiles. Avec ce contexte, l'IA prend en compte la réalité de votre activité lors de l'analyse des données.

**Sans base de connaissances :** "Le trafic a augmenté de 300 % en mars, suggérant une campagne réussie ou un contenu viral."

**Avec base de connaissances :** "Le pic de trafic de mars correspond à la publication de votre rapport annuel, qui génère typiquement 3 à 5 fois plus de trafic pendant 2 à 3 semaines. Le taux de rebond est plus élevé que d'habitude pendant cette période, comme prévu."

---

## Créer des entrées

Accédez à n'importe quelle propriété et cliquez sur **Base de connaissances** dans la barre latérale. Cliquez sur **Ajouter une entrée** pour créer une nouvelle entrée.

Chaque entrée comporte :

- **Titre** - Un nom descriptif (ex. "Explication du pic de trafic de mars")
- **Contenu** - Le contexte complet, rédigé en markdown. Incluez autant de détails que vous en expliqueriez à un nouvel analyste rejoignant votre équipe.
- **Résumé** - Une courte description. Cliquez sur **Résumé IA** pour en générer un automatiquement à partir de votre contenu.
- **Tags** - Des étiquettes optionnelles pour l'organisation. Tapez un tag et appuyez sur Entrée pour l'ajouter.
- **Statut** - Les entrées publiées sont accessibles à l'IA. Les brouillons sont masqués des conversations.

---

## Que mettre dans la base de connaissances

Les entrées les plus utiles sont celles que l'IA ne peut pas déduire des données elles-mêmes :

### Problèmes de qualité des données

- Sources de trafic de bots qui gonflent les métriques
- Événements mal configurés ou lacunes dans le suivi
- Écarts de données connus entre les plateformes

### Définitions métier

- Ce que vos objectifs de conversion signifient réellement
- Les regroupements de canaux personnalisés et leurs différences avec les valeurs par défaut
- Comment vous définissez les métriques clés en interne

### Schémas saisonniers

- Événements annuels qui affectent le trafic (rapports, conférences, lancements de produits)
- Schémas de vacances spécifiques à votre audience
- Cycles budgétaires qui affectent le trafic payant

### Contexte concurrentiel

- Qui sont vos concurrents et comment vous vous différenciez
- Activité concurrentielle connue affectant vos métriques (ex. enchères PPC agressives)
- Contexte de marché que l'IA ne connaîtrait pas autrement

### Contexte technique

- Migrations ou changements de plateforme récents
- Limitations de suivi connues
- Comment votre configuration analytique diffère des implémentations standard

---

## Comment l'IA l'utilise

Lorsque vous discutez avec l'IA, elle sait automatiquement quelles entrées de base de connaissances existent pour votre propriété. Leurs titres sont inclus dans le prompt système, et l'IA utilise un outil de recherche pour récupérer les détails complets lorsque c'est pertinent.

Vous n'avez pas besoin de référencer explicitement les entrées. Si vous posez une question sur les schémas de trafic et que vous avez une entrée sur les pics saisonniers, l'IA la trouvera et l'utilisera.

### Modes de recherche

Les entrées sont recherchées de deux manières :

- **Recherche sémantique** - Si vous avez un fournisseur OpenAI configuré, les entrées sont intégrées sous forme de vecteurs et comparées par signification. Une question sur "des schémas de trafic inhabituels" peut correspondre à une entrée intitulée "Pic de trafic de mars" même sans mots-clés communs.
- **Recherche par mots-clés** - Sans fournisseur OpenAI, les entrées sont comparées par mots dans le titre, le contenu, le résumé et les tags. Cela fonctionne bien mais nécessite un chevauchement de mots-clés plus proche.

Le mode de recherche est indiqué par un petit indicateur sur chaque entrée dans la liste - un point vert pour la recherche sémantique, gris pour la recherche par mots-clés.

---

## Embeddings

Lorsque vous publiez une entrée et que votre équipe a un fournisseur OpenAI configuré, un embedding est automatiquement généré en arrière-plan. Les embeddings permettent la recherche sémantique - la correspondance par signification plutôt que par mots-clés exacts.

Les embeddings sont régénérés automatiquement lorsque vous modifiez le titre, le contenu ou le résumé d'une entrée. Les modifications de tags uniquement conservent l'embedding existant.

Si vous ajoutez un fournisseur OpenAI après avoir créé des entrées, un bouton **Générer tous les embeddings** apparaît dans l'en-tête. Cliquez dessus pour générer les embeddings de toutes les entrées publiées.

Les entrées sans embeddings fonctionnent toujours - elles utilisent la recherche par mots-clés. Les deux modes de recherche peuvent coexister dans la même propriété.

---

## Conseils

- **Écrivez pour un nouveau membre d'équipe.** Si un nouvel analyste rejoignait votre équipe, que devriez-vous lui expliquer avant qu'il puisse interpréter correctement vos données ? C'est ce qui appartient à la base de connaissances.
- **Gardez les entrées ciblées.** Un sujet par entrée fonctionne mieux qu'un seul long document. L'IA peut rechercher et récupérer des entrées individuelles, donc la spécificité aide.
- **Utilisez le bouton Résumé IA.** Il génère des résumés concis qui aident l'IA à évaluer rapidement la pertinence avant de lire le contenu complet.
- **Publiez quand c'est prêt.** Utilisez le statut brouillon pour travailler sur les entrées sans affecter les conversations. Seules les entrées publiées sont visibles par l'IA.

---

## Exemples

Voici quelques exemples d'entrées pour vous aider à démarrer. Vous pouvez les copier et coller directement dans la base de connaissances.

### Schéma de trafic saisonnier

```markdown
**Titre :** Pic de trafic de mars - Rapport annuel

Chaque mars, nous publions notre rapport annuel qui génère un pic
de trafic significatif (typiquement 3 à 5 fois les niveaux normaux).
Cela dure environ 2 à 3 semaines.

Points clés :
- Le pic survient généralement dans la deuxième semaine de mars
- La majorité du trafic provient de la recherche organique et des partages sur les réseaux sociaux
- Le taux de rebond pendant cette période est plus élevé que la normale (65-70 %)
- Le taux de conversion baisse mais les conversions absolues augmentent
- Ne pas comparer les métriques de mars avec les autres mois sans en tenir compte

**Tags :** trafic, saisonnier, rapports
```

### Problème de qualité des données

```markdown
**Titre :** Le trafic organique indien est principalement des bots

Environ 80 % du trafic organique en provenance de l'Inde est du
trafic de bots. C'est constant depuis mi-2024.

Caractéristiques :
- Les sessions durent typiquement moins de 5 secondes
- Taux de rebond de 95 %+ pour le trafic organique indien
- Touche principalement la page d'accueil et les pages de documentation /api/
- Ne convertit pas

Lors de l'analyse du trafic organique, excluez l'Inde entièrement
ou segmentez-la séparément. Les chiffres de trafic organique total
sont gonflés d'environ 15-20 % à cause de cela.

**Tags :** bots, trafic, qualité-données
```

### Définitions de canaux personnalisés

```markdown
**Titre :** Regroupements de canaux personnalisés

Nous utilisons des regroupements de canaux personnalisés qui
diffèrent des valeurs par défaut de GA4 :

- Trafic partenaire = Tout le trafic des partenaires affiliés
  (utm_medium=partner)
- Social payant = Facebook Ads + LinkedIn Ads
  (utm_medium=paid-social)
- Communauté = Trafic de notre forum, serveur Discord et
  Slack communautaire (utm_source contenant "community",
  "discord" ou "forum")
- Email - Newsletter = Newsletter mensuelle
  (utm_campaign commençant par "newsletter-")
- Email - Automatisé = Campagnes drip et transactionnel
  (utm_campaign commençant par "auto-" ou "drip-")

Lors des rapports sur les canaux, utilisez ces regroupements
plutôt que les valeurs par défaut de GA4.

**Tags :** canaux, attribution, ga4
```

### Contexte concurrentiel

```markdown
**Titre :** Principaux concurrents et positionnement

Nos trois principaux concurrents :

1. ConcurrentA (orienté entreprise) - Nous gagnons sur le prix
   et la facilité d'utilisation. Ils dominent la recherche de
   marque pour les termes entreprise.
2. ConcurrentB (taille similaire) - Nous sommes en concurrence
   directe sur le SEO pour la plupart des termes non-marque.
   Ils ont récemment lancé une offre gratuite.
3. ConcurrentC (plus récent, financé par du capital-risque) -
   Agressif sur les annonces payantes. Leurs dépenses PPC ont
   augmenté notre CPC sur les termes de marque d'environ 20 %
   depuis janvier.

Lors de l'analyse des performances de recherche, les
fluctuations de classement pour les termes commerciaux
corrèlent souvent avec l'activité concurrentielle plutôt
qu'avec nos propres changements.

**Tags :** concurrents, marché, seo
```

---

## FAQ

**La base de connaissances utilise-t-elle mes tokens IA ?**
La recherche dans la base de connaissances est effectuée localement et ne coûte pas de tokens. La fonctionnalité Résumé IA utilise un petit nombre de tokens (elle utilise le modèle le moins cher disponible). La génération d'embeddings utilise l'API d'embeddings OpenAI à 0,02 $ par million de tokens - une entrée typique coûte bien moins d'un millième de centime.

**Les membres de l'équipe peuvent-ils voir les entrées des autres ?**
Oui, la base de connaissances est partagée au sein de la propriété. Toute personne ayant un accès en lecture peut voir les entrées, et toute personne ayant un accès en écriture peut les créer et les modifier.

**Combien d'entrées puis-je créer ?**
Il n'y a pas de limite stricte. La base de connaissances est conçue pour des entrées contextuelles ciblées - typiquement 5 à 50 par propriété. Si vous en écrivez des centaines, demandez-vous si certaines informations ne seraient pas mieux adaptées en tant qu'annotations (pour les événements temporels) ou prompts système (pour le comportement général de l'IA).

**Les brouillons affectent-ils les conversations ?**
Non. Seules les entrées publiées sont incluses dans le contexte et les résultats de recherche de l'IA.
