Este es el comando rivescriptp que se puede ejecutar en el proveedor de alojamiento gratuito de OnWorks utilizando una de nuestras múltiples estaciones de trabajo en línea gratuitas, como Ubuntu Online, Fedora Online, emulador en línea de Windows o emulador en línea de MAC OS.
PROGRAMA:
NOMBRE
rivescript: una interfaz de línea de comandos para el intérprete de Perl RiveScript.
SINOPSIS
$ rivescript [opciones] [ruta a los documentos RiveScript]
DESCRIPCIÓN
Esta es una interfaz de línea de comandos para el intérprete de RiveScript. Este script hace obsoleto el
antiguo "rsdemo", y también puede ser utilizado de forma no interactiva por programas de terceros. Con ese fin,
admite una variedad de métodos de manejo de entrada / salida y sesión.
Si no se proporciona una ruta de documento RiveScript, se utilizará por defecto el cerebro de ejemplo que se envía
con el módulo RiveScript, que se basa en el bot Eliza.
OPCIONES
- depuración, -d
Habilita el modo de depuración. Esto imprimirá todos los datos de depuración de RiveScript en su terminal.
Si desea que se registre en un archivo, use la opción "--log" en lugar de
"--depurar".
--archivo de registro
Habilita el modo de depuración e imprime la salida de depuración en "FILE" en lugar de en su terminal.
--json, -j
Ejecuta "rivescript" en modo JSON, para ejecutar el script de forma no interactiva (para
ejemplo, para usar RiveScript en un lenguaje de programación que no tiene un lenguaje nativo
Biblioteca RiveScript). Consulte "Modo JSON" para obtener más detalles.
--datos JSON_DATA
Cuando usa la opción "--json", puede proporcionar el mensaje de entrada JSON como un comando
argumento de línea con la opción "--data". Si no se proporciona, los datos JSON serán
leer desde la entrada estándar en su lugar. Esta opción es útil, por lo tanto, si no desea
para abrir una tubería de dos vías, sino pasar el mensaje como un argumento de línea de comando y
simplemente lea la respuesta de la salida estándar. Consulte "Modo JSON" para obtener más detalles.
--escuchar, -l [DIRECCIÓN:] PUERTO
Ejecuta "rivescript" en modo TCP, para ejecutar el script como un demonio de servidor. Si una
La dirección no se especifica, se vinculará a "localhost". Consulte "Modo TCP" para obtener más detalles.
--estricto, --nóstrito
Habilita el modo estricto para el analizador RiveScript. Está habilitado de forma predeterminada, use
"--nostrict" para desactivarlo. El modo estricto evita que el analizador continúe cuando
encuentra un error de sintaxis en los documentos de RiveScript.
--profundidad = 50
Anula el límite de profundidad de recursividad predeterminado. Esto controla cuántas veces RiveScript
seguirá de forma recursiva las redirecciones a otras respuestas. El valor predeterminado es 50.
--utf8, -u
Utilice la opción UTF-8 en RiveScript. Esto permite que los disparadores contengan caracteres extranjeros.
y relaja el filtrado de mensajes de usuario. ¡Esto no está habilitado por defecto!
--ayuda
Muestra esta documentación en su terminal.
USO
Interactivo Moda
Este es el modo predeterminado que se utiliza cuando ejecuta "rivescript" sin especificar otro modo.
Este modo se comporta de manera similar al antiguo script "rsdemo" y te permite chatear uno a uno con
su bot RiveScript.
Este modo se puede utilizar para probar su bot RiveScript. Ejemplo:
$ rivescript / ruta / a / rs / archivos
JSON Moda
Este modo debe usarse cuando se llama desde un programa de terceros. En este modo, los datos que
entra y sale del script están codificados en JSON.
Ejemplo:
$ rivescript --json / ruta / a / rs / archivos
El formato para los datos JSON entrantes es el siguiente:
{
"username": "localuser",
"message": "¡Hola bot!",
"vars": {
"nombre": "Aiden"
}
}
Aquí, "nombre de usuario" es un nombre único para el usuario, "mensaje" es su mensaje al bot y
"vars" es un hash de cualquier variable de usuario que su programa pueda estar rastreando (como el
nombre del usuario y edad).
La respuesta de "rivescript" se verá así:
{
"estado": "ok",
"responder": "¡Hola, humano!",
"vars": {
"nombre": "Aiden"
}
}
Aquí, "estado" será "ok" o "error", "respuesta" es la respuesta del bot a su mensaje y
"vars" es un hash de las variables actuales para el usuario (para que su programa pueda guardarlas
algun lado).
Estándar Entrada or Fecha
De forma predeterminada, el modo JSON leerá la entrada estándar para recibir su mensaje JSON. Como un
alternativa a esto, puede proporcionar la opción "--data" a "rivescript" para presentar el
datos JSON entrantes como un argumento de línea de comando.
Esto puede resultar útil si no desea abrir una tubería de dos vías a "rivescript" y
en su lugar, pase su entrada como un argumento de línea de comando y simplemente lea la respuesta de
salida estándar.
Ejemplo:
$ rivescript --json --data '{"nombre de usuario": "localuser", "mensaje": "hola"}' \
/ ruta / a / rs / archivos
Esto hará que "rivescript" imprima su respuesta JSON en la salida estándar y salga. usted
no puede tener una sesión con estado utilizando este método.
End of Mensaje
Hay dos formas de usar el modo JSON: "disparar y olvidar" o mantener un estado
sesión abierta.
En "disparar y olvidar", abre el programa, imprime su entrada JSON y envía la señal EOF,
y luego "rivescript" le envía la respuesta JSON y sale.
En un modo de sesión con estado, debe enviar el texto "__END__" en una línea después de que
Termine de enviar sus datos JSON. Luego, "rivescript" lo procesará, devolverá su respuesta JSON
y luego también diga "__END__" al final.
Ejemplo:
{
"username": "localuser",
"message": "¡Hola bot!",
"vars": {}
}
__FIN__
Y la respuesta:
{
"estado": "ok",
"responder": "¡Hola, humano!",
"vars": {}
}
__FIN__
De esta forma, puede reutilizar la misma tubería para enviar y recibir varios mensajes.
TCP Moda
El modo TCP hará que "rivescript" escuche en un socket TCP para las conexiones entrantes. De esta manera
puede conectarse a él desde un programa diferente (por ejemplo, un script CGI o un programa
escrito en un idioma diferente).
Ejemplo:
$ rivescript --escucha localhost: 2001
El modo TCP se comporta de manera similar al "Modo JSON"; la mayor diferencia es que leerá y
escribir utilizando un conector TCP en lugar de la entrada y salida estándar. Sin embargo, a diferencia del modo JSON,
Modo TCP se ejecuta de forma con estado (los mensajes JSON deben terminar con el texto
"" __END__ "" en una línea por sí misma). Consulte "Fin del mensaje".
Si no se encuentra la línea "__END__" después de leer 20 líneas de texto del cliente,
Ríndete y envía al cliente un mensaje de error (codificado en JSON) y desconéctalo.
Utilice rivescriptp en línea utilizando los servicios de onworks.net
