Documentation AI Super Agent

Sommaire

Introduction

AI Super Agent est un plugin WordPress premium qui vous permet de créer et de déployer de multiples assistants alimentés par l’intelligence artificielle sur votre site. Chaque agent dispose de sa propre interface, de ses propres instructions et de sa propre apparence, vous permettant d’offrir des expériences IA personnalisées à vos visiteurs.

Le plugin se connecte à plusieurs fournisseurs d’IA (OpenAI, Anthropic Claude, Mistral AI) et peut être utilisé pour une grande variété d’applications comme le support client, les consultations spécialisées, l’assistance technique, les conseils juridiques, l’aide organisationnelle, le support psychologique et bien plus encore.

Installation

Prérequis

WordPress 5.0 ou supérieur
PHP 7.2 ou supérieur
Accès administrateur à votre site WordPress

Procédure d’installation

Téléchargez le fichier ZIP du plugin depuis votre espace client ou l’email de confirmation d’achat
Dans votre tableau de bord WordPress, allez dans Extensions > Ajouter
Cliquez sur Téléverser une extension en haut de la page
Sélectionnez le fichier ZIP téléchargé et cliquez sur Installer maintenant
Une fois l’installation terminée, cliquez sur Activer l’extension

Après l’activation, un nouveau menu AI Super Agent apparaîtra dans votre tableau de bord WordPress.

Configuration globale

Avant de créer vos agents, vous devez configurer les paramètres globaux du plugin.

Dans le menu WordPress, cliquez sur AI Super Agent > Paramètres globaux
Dans l’onglet Paramètres API, configurez :
- Fournisseur API : Sélectionnez votre fournisseur préféré (OpenAI, Anthropic, ou Mistral)
- Clé API : Entrez votre clé API pour le fournisseur sélectionné
- Modèle IA : Choisissez le modèle d’IA que vous souhaitez utiliser

Obtention des clés API

OpenAI : Inscrivez-vous sur https://platform.openai.com/ et créez une clé API dans la section API Keys
Anthropic (Claude) : Obtenez une clé API sur https://console.anthropic.com/
Mistral AI : Inscrivez-vous sur https://console.mistral.ai/ pour obtenir une clé API

Configuration des notifications

Dans l’onglet Notifications :

Email de notification : Définissez l’adresse email qui recevra les notifications des soumissions de formulaires

Configuration de reCAPTCHA (optionnel)

Si vous souhaitez protéger vos formulaires contre le spam :

Dans l’onglet reCAPTCHA, configurez :
- Version reCAPTCHA : Choisissez entre reCAPTCHA v2 (case à cocher) ou v3 (invisible)
- Clé de site : Entrez votre clé de site reCAPTCHA
- Clé secrète : Entrez votre clé secrète reCAPTCHA

Pour obtenir ces clés, visitez https://www.google.com/recaptcha/admin et créez un nouveau site.

Création et gestion des agents

Créer un nouvel agent

Dans le menu WordPress, allez dans AI Super Agent > Agents
Cliquez sur le bouton Ajouter un agent en haut de la page
Remplissez les informations de base dans l’onglet Général :
- Nom de l’agent : Donnez un nom descriptif à votre agent (visible uniquement dans l’administration)
- Description : Ajoutez une description pour vous aider à identifier l’agent
- Nom du paramètre : Personnalisez le paramètre utilisé dans le shortcode (par défaut : « id »)
- Statut de l’agent : Activez ou désactivez l’agent

Gérer les agents existants

Sur la page AI Super Agent > Agents, vous pouvez :

Activer/Désactiver un agent en cliquant sur l’indicateur de statut
Modifier un agent pour changer sa configuration
Dupliquer un agent pour créer une copie avec les mêmes paramètres
Supprimer un agent que vous n’utilisez plus

Personnalisation des formulaires

L’onglet Formulaire vous permet de personnaliser l’interface utilisateur de votre agent.

Modèle de formulaire

Le modèle de formulaire utilise un système de shortcodes pour créer différents types de champs :

Zone de texte : [textarea* nom_champ] (l’astérisque indique un champ obligatoire)
Boutons radio : [radio nom_champ default:1 "Option 1" "Option 2"]
Cases à cocher : [checkbox nom_champ "Option 1" "Option 2" "Option 3"]
Date : [date* nom_champ]
Champ texte : [text nom_champ]

Exemple de formulaire simple :

<p>Décrivez votre problème en détail pour obtenir une analyse et une solution.</p>

<label>Décrivez votre problème :</label>
[textarea* description_probleme placeholder "Expliquez votre problème en détail..."]

<label>Date limite (si applicable) :</label>
[date date_limite]

<label>Domaine spécifique :</label>
[radio domaine default:1 "Technique" "Juridique" "Organisation" "Personnel" "Autre"]

<label>Contexte supplémentaire (optionnel) :</label>
[textarea contexte_supplementaire placeholder "Toute information complémentaire pertinente..."]

Texte du bouton de soumission

Personnalisez le texte du bouton qui soumet le formulaire (par exemple : « Analyser », « Soumettre », « Obtenir une réponse », etc.).

Configuration des prompts

L’onglet Prompt IA vous permet de configurer les instructions envoyées à l’IA.

Prompt d’analyse

Le prompt d’analyse est le texte envoyé à l’IA lorsqu’un utilisateur soumet le formulaire. Vous pouvez utiliser des variables entre accolades {nom_variable} pour insérer les valeurs des champs du formulaire.

Exemple de prompt :

Vous êtes un expert en résolution de problèmes. Veuillez analyser le problème suivant et fournir une solution structurée.

Description du problème : {description_probleme}

Date limite : {date_limite}

Domaine : {domaine}

Contexte supplémentaire : {contexte_supplementaire}

Veuillez analyser ce problème et fournir :
1. Un résumé clair du problème
2. Les causes potentielles ou facteurs sous-jacents
3. 2-3 solutions pratiques avec leurs avantages et inconvénients
4. Une mise en œuvre étape par étape de la meilleure solution
5. Des ressources ou outils qui pourraient aider

Soyez spécifique, pratique et orienté vers la solution. Évitez les conseils génériques. Si vous avez besoin de plus d'informations, indiquez ce qu'il serait utile de savoir.

Modèle de résultat

L’onglet Résultat vous permet de personnaliser l’affichage de la réponse de l’IA. Utilisez la variable {result} pour insérer la réponse de l’IA dans votre modèle.

Exemple de modèle de résultat :

<h2>Analyse & Solution</h2>
<div class="analyse-container">
    <p align="justify">{result}</p>
</div>

Afficher le formulaire après le résultat

Choisissez si vous souhaitez que le formulaire reste visible après l’affichage du résultat.

Personnalisation visuelle

L’onglet Apparence vous permet de personnaliser l’aspect visuel de votre agent.

Options de couleur

Couleur d’arrière-plan : Définit la couleur principale de l’arrière-plan
Couleur du texte : Définit la couleur du texte
Couleur du bouton de soumission : Définit la couleur du bouton
Couleur du halo : Définit la couleur de l’effet de halo (pour l’animation d’étoiles)

Animation d’étoiles

Activez ou désactivez l’animation d’étoiles en arrière-plan.

CSS personnalisé

Ajoutez votre propre CSS pour personnaliser davantage l’apparence. Vous pouvez utiliser les variables suivantes dans votre CSS :

{background_color} : Couleur d’arrière-plan sélectionnée
{text_color} : Couleur de texte sélectionnée
{submit_button_color} : Couleur du bouton sélectionnée
{halo_color} : Couleur du halo sélectionnée

Exemple de CSS personnalisé :

.aiagent-container::before {
    background: linear-gradient(to bottom, white 0%, {background_color} 20%, {background_color} 80%, white 100%);
}
.aiagent-form {
    color: {text_color};
}
.aiagent-submit-button {
    background-color: {submit_button_color};
}

Sécurité et reCAPTCHA

L’onglet Sécurité vous permet de configurer les options de protection contre le spam.

Activer reCAPTCHA

Si vous avez configuré reCAPTCHA dans les paramètres globaux, vous pouvez l’activer ou le désactiver pour chaque agent individuellement.

Lorsque reCAPTCHA est activé :

La version v2 affichera une case à cocher « Je ne suis pas un robot »
La version v3 fonctionnera en arrière-plan sans interaction utilisateur nécessaire

Notifications par email

L’onglet Notifications vous permet de configurer les alertes email.

Envoyer un email avec les résultats

Activez ou désactivez l’envoi d’emails pour cet agent.

Sujet de l’email

Personnalisez le sujet des emails de notification envoyés lorsqu’un utilisateur soumet le formulaire.

Utilisation des shortcodes

Pour afficher un agent sur votre site, utilisez le shortcode suivant dans une page ou un article :

[ai_super_agent id="slug-de-votre-agent"]

Où « slug-de-votre-agent » est le slug généré automatiquement pour votre agent (visible dans la liste des agents).

Si vous avez personnalisé le nom du paramètre (par exemple « agent » au lieu de « id »), vous pouvez utiliser :

[ai_super_agent agent="slug-de-votre-agent"]

Placement multiple

Vous pouvez placer différents agents sur différentes pages ou même plusieurs agents sur la même page.

FAQ et dépannage

Questions fréquentes

Q : Combien d’agents puis-je créer ?

R : Vous pouvez créer un nombre illimité d’agents.

Q : Les visiteurs peuvent-ils voir quelle IA est utilisée ?

R : Non, le fournisseur d’IA et le modèle utilisés ne sont pas visibles pour les visiteurs.

Q : Puis-je utiliser ce plugin sans clé API ?

R : Non, vous devez fournir une clé API valide pour au moins l’un des fournisseurs pris en charge.

Q : Le plugin stocke-t-il les conversations avec l’IA ?

R : Non, le plugin n’enregistre pas les conversations dans la base de données. Si vous activez les notifications par email, les requêtes et les réponses seront envoyées à l’adresse email spécifiée.

Problèmes courants

Erreur : « API key not provided »

Vérifiez que vous avez bien entré votre clé API dans les paramètres globaux pour le fournisseur que vous avez sélectionné.

Erreur : « Connection error » ou timeout

Ces erreurs peuvent se produire si :

Votre serveur a des problèmes de connexion Internet
Le fournisseur d’IA rencontre des problèmes
Votre clé API a atteint ses limites d’utilisation

Le formulaire s’affiche mais aucune réponse n’est générée

Vérifiez :

Que votre clé API est valide et active
Que vous avez correctement configuré le prompt d’analyse
Que toutes les variables dans le prompt correspondent à des champs existants dans votre formulaire

Problèmes avec reCAPTCHA

Si reCAPTCHA ne fonctionne pas correctement :

Vérifiez que vos clés de site et secrète sont correctes
Assurez-vous que le domaine de votre site est autorisé dans la console reCAPTCHA
Essayez de désactiver temporairement reCAPTCHA pour tester si le problème vient de là

Pour toute autre question ou problème, veuillez contacter notre support technique.

Archives

Catégories