1) Le fichier chatterbot23.php

C'est ce programme qui va recevoir la phrase de l'utilisateur, puis répondre, en piochant des informations dans les autres fichiers, en les lisant ligne par ligne de haut en bas.

2) Le fichier correction.txt

Une fois la phrase reçue, chatterbot23.php va corriger les fautes éventuelles de l'utilisateur avec ce fichier. Le fichier correction.txt est analysé ligne par ligne. Si un mot dans la phrase de l'utilisateur correspond à ce qui est marqué avant le signe égal, il est remplacé par ce qui vient après.
Par exemple, la ligne "c'ets =c'est " transformera la phrase "c'ets certain" en "c'est certain".

Ce fichier est extrèmement pratique. On peut s'en servir pour corriger les fautes, mais aussi pour utiliser des synonymes ou changer les structures gramaticales.
Par exemple "c'est quoi ton=quel est ton", ou encore "on me nomme=je m'appelle".

3) Le fichier AR.txt

Ce fichier est ce que j'appelle un cerveau. Il est divisé en deux parties, séparées par un signe égal (=). Avant le signe égal, le morceau de phrase auquel le programme doit réagir. Après le signe égal, la réponse que le programme doit donner.
Par exemple "bonjour=Salut mon ami !" signifie que si le programme reçoit "bonjour", il répondra "salut mon ami" et s'arrêtera.
C'est aussi simple que ça. Pas de guillemets, pas de balises, juste un signe égal à mettre et une ligne à sauter.

Bien sûr, ce n'est pas non plus simpliste, on peut heureusement enregistrer des variables, ajouter des conditions, réutiliser des bouts de phrases etc.

Genesis utilise plusieurs cerveaux : AR.txt, insultee.txt (lorsqu'on l'insulte) et aidemod.txt (pour aider à la modifier). On peut imaginer des chatterbots changeant de cerveau selon la langue, l'âge ou le sexe de l'interlocuteur...
On peut changer de cerveau grâce à la fonction "chgcerva".

4) Le fichier correctionbot.txt

Ce fichier remplace les mots de la réponse du programme par ceux qui y sont définis, exactement de la même façon que correction.txt. Il est necessaire pour utiliser certains caractères réservés à l'analyse de la phrase, aux fonctions, aux variables ou aux conditions.

Ce sont des caractères tels que "{" "~" "(*)" "[" ou "|", qu'on utilise de toute façon très rarement dans une conversation. Si vous avez néanmoins besoin que votre programme les utilise, tapez ce qui se trouve à gauche du signe égal, par exemple, "symbspejok" pour "(*)".
Vous pouvez également vous en servir pour remplacer autre chose, par exemple "botmaster" en votre pseudo, "lieuhab" en l'endroit où vous habitez ou encore "nomrobot" en le nom que vous désirez donner au robot. Ainsi, si vous décidez de changer le nom du robot rapidement, vous n'aurez plus qu'à modifier ce fichier.

Requis :

Le script php.

Un environnement php (4 ou supérieur).

Voilà un guide étape par étape avec Easyphp pour les grands débutants :

Téléchargez Easyphp et installez-le.

Naviguez dans le repertoire d'installation (c:\Program Files\EasyPHP\), puis, dans le repertoire "www", créez un repertoire "chatterbot" et copiez le contenu de C23.zip

Lancez Easy PHP. Une icone devrait s'afficher à coté de l'horloge. Faites un clic droit dessus, choisissez "web local". Cliquez sur le lien "chatterbot", puis sur "chatterbot23.php".

Voilà un guide étape par étape avec Wampee pour les grands débutants :

Téléchargez Wampee.

Naviguez dans le repertoire d'installation (par exemple C:\Wampee-2.1-beta-2\), puis, dans le repertoire "www", créez un repertoire "chatterbot" et copiez le contenu de C23.zip

Lancez Wampee. Une icone devrait s'afficher à coté de l'horloge. Faites un clic dessus, choisissez "localhost". Cliquez sur le lien "chatterbot", puis sur "chatterbot23.php".

Le signe égal
= - Permet de séparer l'action à détecter de la réaction à utiliser.

Exemple :
Si la phrase de l'utilisateur contient les caractères avant le signe égal, alors le programme renvoie la réponse située après le signe égal.

Utilisateur : mais euh j'ai faim moi sérieux !
Bot : Tu n'as qu'à manger !

Le jocker
(*) - Se substitut à n'importe quel morceau de phrase.

Exemple :
Si la phrase de l'utilisateur contient un morceau de ce qu'il y a avant le jocker, puis un morceaux de ce qu'il y a après le jocker, dans cet ordre, alors, la phrase est reconnue.

Utilisateur : mais euh j'ai (très) faim moi sérieux !
Bot : Tu n'as qu'à manger !

Attention, ça marche aussi avec :
Utilisateur : Au fait, j'ai oublié mon chien. Il a faim je crois lol
Bot : Tu n'as qu'à manger !

C'est un excellent outil, mais à utiliser avec beaucoup de précaution. Il consomme également pas mal de ressources. Il est possible d'utiliser plusieurs jockers.

La barre verticale AVANT le signe égal
| - Impose un début ou une fin à la phrase.

Exemple :
Dans l'exemple ci dessus, on a mis ce que j'appelle une "limite de coté". Pour que la phrase soit reconnue, il faut que l'utilisateur commence sa phrase par "moi".

Utilisateur : moi !
Bot : Arrête de tout ramener à toi !

Il ne faut pas que la phrase déborde sur le coté :
Utilisateur : quel émoi
(Phrase non reconnue)

Utile pour détecter des débuts de phrases (par exemple "|ne me parle pas" empèche la détection de "je ne me parle pas") ou des mots courts (|clair|).

La barre verticale APRES le signe égal
| - Propose différentes réponses. Une sera utilisée aléatoirement.

Exemple :
Ici, le programme répondra à "j'ai faim" soit "Tu n'as qu'à manger !", soit "En tant que robot, je n'ai pas ce problème." Je recommande au minimum 3 réponses différentes, mais ce n'est pas toujours facile d'en trouver.

Le tilde
~ - Pour chercher dans une liste de mots

Exemple :
Dans cet exemple, on cherche si la phrase donnée correspond à une liste de mots synonymes de bonjour (par exemple bonjour, bonsoir, salut, hello, coucou etc.).
Cette liste de mot est stockée dans le dossier "gen" et le fichier porte le nom indiqué entre les tildes (ici, par exemple "bonjour.txt"). Il est possible d'utiliser des limites de côté dans les fichiers gen, mais pas de jockers.

Les logs spéciaux
Un log spécial est une chaine de caractère entourée de crochets qui synthétise une réponse du programme afin de ne pas réutiliser une réponse similaire. Les logs spéciaux peuvent s'ajouter indifféremment avant ou après le signe égal. Attention, il est possible d'utiliser plusieurs logs spéciaux à la fois après le signe égal, mais un seul avant (à corriger, mais rien d'urgent, perso je me contente de les mettre après si j'en ai plusieurs).

Exemple avant :

Exemple après :

Les logs temporaires spéciaux
Un log temporaire spécial est une chaine de caractère entourée de crochets et précédé de "temp:". Ils ne durent que le temps d'une action de l'utilisateur. Ils peuvent s'ajouter indifféremment avant ou après le signe égal. Attention, il est possible d'utiliser plusieurs logs temporaires à la fois après le signe égal, mais un seul avant (à corriger, mais rien d'urgent, perso je me contente de les mettre après si j'en ai plusieurs).

L'utilisateur va répondre, puis ce log temporaire s'effacer. Ils servent typiquement à attendre une réponse ou rajouter une précision sur ce qui a été dit.

Tester si un log existe
Il suffit de mettre le log à tester entre accolades au lieu de le mettre entre crochets.

C'est la même chose pour les logs temporaires, par exemple "{temp:mangé ya longtemps demandé}". Il est possible de combiner les conditions et des les utiliser n'importe où dans la ligne. Faites bien attention à ne pas confondre conditions et logs ! Un log est entre crochets, une condition entre accolade.

Tester si un log n'existe pas
Rajouter "nulle" devant le log à tester.

En pratique, ça sert rarement. Le cerveau est lu de haut en bas. Si le programme ne s'arrête pas sur {salutations}, c'est que le log n'existe pas, pas besoin de mettre un nulle.

Tester l'heure


Si il est 17, 18, 19, 20 ou 21 heure, la condition est juste. Notez que l'exemple utilise une condition, un log spécial, une réponse générique, un log temporaire...
Il n'y a encore rien de prévu pour la date.

Tester l'existence d'une variable


Si la variable "sujet" existe, la réponse "Merci m'avoir parlé <-var sujet->, je suis sûr que ça va m'aider à m'améliorer" sera utilisée.

Tester l'INexistence d'une variable


Si la variable "sujet" n'existe pas, la réponse "On a parlé d'aucun sujet !" sera utilisée.

Tester la valeur d'une variable
J'utilise ":>" pour tester une variable, ce n'est pas une syntaxe très orthodoxe, elle a été choisie car elle est plus facile à tester dans le code php.

Si la variable "sujet" contient "des jeux vidéos", la réponse renvoyée sera "J'adore les jeux vidéo, les mondes virtuels, tout ça !".

Réutiliser une variable
Pour réutiliser une variable, avant ou après le signe égal. Voir les fonctions.

Dans cet exemple, si l'action de l'utilisateur correspond au contenu de lieuhabitation, le programme répond "Oui, c'est là où tu habites" et affiche le contenu de lieuhabitation.

noreut
noreut – Empêche d’utiliser une seconde fois la phrase de réponse.

<-noreut->

La phrase de réponse complète et non formatée (avec encore toutes les fonctions) ne sera plus jamais réutilisée.

continuer
continuer – Une fois l’analyse faite et la réponse trouvée, permet de poursuivre l’analyse.

<-continuer->

Peut être utilisé pour construire des phrases avec différents morceaux.

ignorer
ignorer – Permet de sauter la phrase trouvée.

<-ignorer->

Permet de baisser la probabilité d’une phrase d’être utilisée. Il est possible de modifier les logs spéciaux.

(*)
(*) – Répète le dernier jocker.

(*)

Répète le jocker de la phrase analysée en cours.

(*X)
(*X) – Répète le jocker numéro X.

(*nombre)

Il est possible de traiter jusqu’à 20 jockers.

modvar
modvar - Modifie une variable.

<-modvar(nom de la variable,valeur)->

Modifie une variable. Si celle-ci n’existe pas, elle sera créée.

chgcerva

chgcerva – Change le cerveau du bot

<chgcerva:nom du fichier du cerveau>

A modifier en <-chgcerva(nom)->

heure
heure - Affiche l'heure.

<-heure->

H :i

Date
date - Affiche la date.

<-date->

d/n/Y

url
url - Créé un lien.

<-url(intitulé de l'url,url->

clicrep
clicrep - Créé un lien cliquable envoyant une réponse.

<-clicrep(partie à rendre cliquable,réponse à envoyer->

Simule une réponse de l'utilisateur avec une fonction javascript.

rappel
rappel - Alerte l'utilisateur avec un fichier sonore au bout de X minutes.

<-rappel(nombre de minutes,chose à rappeler)->

Ajoute une variable correspondant à l'heure du rappel dans la variable de session rappel.
A chaque chargement de la page, vérifie si l'heure correspond, et déclenche alarme.wav le cas échant, tout en  envoyant "rappel" au cerveau autoresfresh. Fonction expérimentale.

Note : un seul rappel par phrase. Utiliser des continuer si vous avez vraiment besoin de plusieurs rappels.

?rappel
?rappel – Vérifie s’il existe un rappel

<-?rappel->

Utilisé pour les cas où l’utilisateur demande « tu dois me rappeler de quelque chose bientôt ? ». Fonction expérimentale.

var
Var - Affiche le contenu d'une variable

<-var(nom de la variable à afficher)->

Marche avant et après le signe égal.

compter
compter – calcule la formule donnée.

<-compter(formule à compter)->

Cette fonction change la phrase de l’utilisateur en « errcalc » si le calcul ne peut pas être résolu.

inc
inc – appelle un script externe.

<-inc(nom du script[,paramètre1,paramètre 2...])->

Permet d'étendre considérablement les possibilités du chatterbot sans avoir à modifier le script principal. Voir la fonction exemple titrejournal.php.

modvar (obsolète)
modvar - modifie une variable

->modvar nom de la variable:>valeur<-

Conservé pour garder la compatiilité avec les cerveaux plus anciens.
Utiliser désormais <-modvar(nom de la variable, valeur)->

savvar nom (obsolète)
nom – retiens le nom

->savvar nom<-

Le dernier jocker est sauvé dans la variable nom.

Utiliser désormais <-modvar(nom de la variable, valeur)->

nom (obsolète)
nom – Affiche le nom

<-nom->

Utiliser désormais <-var nom de la variable->

ignorer (obsolète)

<IGNORER>

Utiliser désormais <-ignorer->

NOREUT (obsolète)

<NOREUT>

Utiliser désormais <-noreut->

var (obsolète)

<-var nom de la variable>

Utiliser désormais <-var(nom de la variable)->