Questo è il comando rivescriptp che può essere eseguito nel provider di hosting gratuito OnWorks utilizzando una delle nostre molteplici workstation online gratuite come Ubuntu Online, Fedora Online, emulatore online Windows o emulatore online MAC OS
PROGRAMMA:
NOME
rivescript - Un frontend a riga di comando per l'interprete Perl RiveScript.
SINOSSI
$ rivescript [opzioni] [percorso ai documenti RiveScript]
DESCRIZIONE
Questo è un front-end da riga di comando per l'interprete RiveScript. Questo script rende obsoleto il
vecchio "rsdemo", e può essere utilizzato anche in modo non interattivo da programmi di terze parti. A quello scopo,
supporta una varietà di input/output e metodi di gestione delle sessioni.
Se non viene fornito alcun percorso del documento RiveScript, verrà utilizzato per impostazione predefinita il cervello di esempio fornito
con il modulo RiveScript, che si basa sul bot Eliza.
VERSIONI
--debug, -d
Abilita la modalità di debug. Questo stamperà tutti i dati di debug da RiveScript sul tuo terminale.
Se invece vuoi che si registri su un file, usa l'opzione "--log" invece di
"--debug".
--log FILE
Abilita la modalità di debug e stampa l'output di debug su "FILE" invece che sul tuo terminale.
--json, -j
Esegue "rivescript" in modalità JSON, per eseguire lo script in modo non interattivo (per
esempio, per usare RiveScript in un linguaggio di programmazione che non ha un nativo
libreria RiveScript). Vedere "Modalità JSON" per i dettagli.
--dati JSON_DATA
Quando si utilizza l'opzione "--json", è possibile fornire il messaggio di input JSON come comando
argomento della riga con l'opzione "--data". Se non forniti, i dati JSON saranno
leggere invece dall'input standard. Questa opzione è utile, quindi, se non vuoi
per aprire una pipe a due vie, ma piuttosto passare il messaggio come argomento della riga di comando e
basta leggere la risposta dallo standard output. Vedere "Modalità JSON" per maggiori dettagli.
--ascolta, -l [INDIRIZZO:]PORTA
Esegue "rivescript" in modalità TCP, per eseguire lo script come demone del server. Se uno
indirizzo non è specificato, si legherà a "localhost". Vedere "Modalità TCP" per i dettagli.
--rigoroso, --norigoroso
Abilita la modalità rigorosa per il parser RiveScript. È abilitato per impostazione predefinita, usa
"--nostrict" per disabilitarlo. La modalità rigorosa impedisce al parser di continuare quando
trova un errore di sintassi nei documenti RiveScript.
--profondità=50
Sostituisci il limite di profondità di ricorsione predefinito. Questo controlla quante volte RiveScript
seguirà ricorsivamente i reindirizzamenti ad altre risposte. Il valore predefinito è 50.
--utf8, -u
Usa l'opzione UTF-8 in RiveScript. Ciò consente ai trigger di contenere caratteri estranei
e rilassa il filtraggio dei messaggi degli utenti. Questo non è abilitato per impostazione predefinita!
--Aiuto
Visualizza questa documentazione nel tuo terminale.
USO
Interactive Moda
Questa è la modalità predefinita utilizzata quando si esegue "rivescript" senza specificare un'altra modalità.
Questa modalità si comporta in modo simile al vecchio script "rsdemo" e ti consente di chattare uno a uno con
il tuo bot RiveScript.
Questa modalità può essere utilizzata per testare il tuo bot RiveScript. Esempio:
$ rivescript /percorso/di/rs/files
JSON Moda
Questa modalità dovrebbe essere utilizzata quando si chiama da un programma di terze parti. In questa modalità, i dati che
entra ed esce dallo script sono codificati in JSON.
Esempio:
$ rivescript --json /percorso/a/rs/files
Il formato per i dati JSON in entrata è il seguente:
{
"nomeutente": "utentelocale",
"message": "Ciao bot!",
"var": {
"nome": "Aiden"
}
}
Qui, "username" è un nome univoco per l'utente, "message" è il loro messaggio al bot e
"vars"èun hash di qualsiasi variabile utente di cui il tuo programma potrebbe tenere traccia (come il
nome utente ed età).
La risposta da "rivescript" sarà simile alla seguente:
{
"stato": "ok",
"rispondi": "Ciao, umano!",
"var": {
"nome": "Aiden"
}
}
Qui, "status" sarà "ok" o "error", "reply" è la risposta del bot al tuo messaggio e
"vars"èun hash delle variabili correnti per l'utente (in modo che il tuo programma possa salvarle
da qualche parte).
Standard Ingresso or Dati
Per impostazione predefinita, la modalità JSON leggerà dall'input standard per ricevere il tuo messaggio JSON. come un
in alternativa a questo, puoi fornire l'opzione "--data" a "rivescript" per presentare il
dati JSON in entrata come argomento della riga di comando.
Questo può essere utile se non vuoi aprire un tubo a due vie su "rivescript", e lo faresti
piuttosto passa il tuo input come argomento della riga di comando e leggi semplicemente la risposta da
uscita standard.
Esempio:
$ rivescript --json --data '{"username": "localuser", "message": "ciao" }' \
/percorso/di/rs/files
Ciò farà sì che "rivescript" stampi la sua risposta JSON sull'output standard e esca. Voi
non è possibile avere una sessione con stato utilizzando questo metodo.
Fine of Messaggio
Esistono due modi per utilizzare la modalità JSON: "sparare e dimenticare" o mantenere uno stateful
sessione aperta.
In "spara e dimentica", apri il programma, stampi il tuo input JSON e invii il segnale EOF,
e quindi "rivescript" ti invia la risposta JSON ed esce.
In una modalità di sessione stateful, devi inviare il testo "__END__" su una riga da solo dopo di te
termina l'invio dei tuoi dati JSON. Quindi "rivescript" lo elaborerà, restituirà la sua risposta JSON
e poi pronuncia anche "__END__" alla fine.
Esempio:
{
"nomeutente": "utentelocale",
"message": "Ciao bot!",
"var": {}
}
__FINE__
E la risposta:
{
"stato": "ok",
"rispondi": "Ciao, umano!",
"var": {}
}
__FINE__
In questo modo puoi riutilizzare la stessa pipe per inviare e ricevere più messaggi.
TCP Moda
La modalità TCP renderà "rivescript" in ascolto su un socket TCP per le connessioni in entrata. Per di qua
puoi connetterti ad esso da un programma diverso (ad esempio, uno script CGI o un programma
scritto in una lingua diversa).
Esempio:
$ rivescript --ascolta localhost:2001
La modalità TCP si comporta in modo simile alla "modalità JSON"; la differenza più grande è che leggerà e
scrivere utilizzando un socket TCP invece di input e output standard. A differenza della modalità JSON, tuttavia,
Modalità TCP sempre viene eseguito in modo stateful (i messaggi JSON devono terminare con il testo
""__END__"" su una riga a sé stante). Vedere "Fine del messaggio".
Se la riga "__END__" non viene trovata dopo che 20 righe di testo sono state lette dal client, lo farà
rinunciare e inviare al client un messaggio di errore (codificato in JSON) e disconnetterlo.
Usa rivescriptp online utilizzando i servizi onworks.net
