Este bot permite interactuar con Personajes No Jugadores (NPCs) para juegos de rol y larp mediante un bot de Discord a través de la API de ChatGPT (en principio, en su modelo GPT-3.5-turbo, ya que aún no he tenido acceso a GPT-4).
Es una adaptación específica para este uso, pero si queréis utilizarlo de manera más generalizada, podéis echar un vistazo a la wiki del desarrollador original.
Los archivos que encontraréis aquí están configurados para interpretar a un personaje concreto de mi rol en vivo Project Dark.ia - La insurrección de los cautivos ("coescrito" junto a ChatGPT, por cierto), que podrás descargar aquí.
La modificación y utilización del bot es muy sencilla, y voy a explicarlo todo paso a paso, por lo que no son necesarios conocimientos de programación para adaptarlo a vuestras necesidades.
Si eres desarrollador y encuentras algún fallo o posible mejora, estaré encantada de ampliar el proyecto. Yo tan solo estoy empezando con Python :)
Tienes más información sobre aplicaciones de IA para larp en mi repositorio LARP-AI-Design, donde también puedes compartir tus experiencias.
Ten en cuenta que, además de este bot, también existe una versión para utilizar el bot en local con un programa de Python, disponible aquí: NPBot-RPG-ChatGPT
En general, el bot local es potencialmente más configurable, pero editarlo requiere más conocimientos, y ahora mismo no permite acceso a través de dispositivos móviles. El bot de Discord está más limitado en cuanto a estructura y diseño, pero al ser una aplicación real resulta más accesible desde cualquier dispositivo de forma online, aunque también dependes de ella.
En esta tabla os resumo algunas de las diferencias que he encontrado entre ellos:
| NPBot Local | NPBot Discord |
|---|---|
| Instalación sencilla | Instalación compleja |
| - | Dependencia de Discord |
| En principio requiere de un PC | Permite utilizar dispositivos móviles |
| Requiere descargarlo en cada dispositivo | Una vez se ejecuta en PC, el resto puede acceder online |
| Permite solo una conversación individual | Varias personas pueden interactuar al mismo tiempo con el bot y ver las interacciones de los demás |
| Prompt visible en los archivos descargados | Prompt no accesible a través de Discord |
| Interfaz configurable | Interfaz de Discord |
| Fluidez de escritura | Necesidad de usar comandos |
| Posible funcionalidad futura | Facilidad de alternar entre prompts con los comandos |
| Hay que reiniciar el programa para ver cambios en el prompt inicial | Posibilidad de editar prompts sin reiniciar Discord |
| - | Puedes montar varios bots dentro de la misma aplicación |
| Mecánicas de juego con el aumento de la temperatura | - |
Accede al Portal de Desarrolladores de Discord con tu cuenta y crea una "Nueva Aplicación".
Asigna un nombre a la aplicación, acepta los términos de servicio y pulsa en "Crear".
Selecciona la pestaña "Bot" del menú de navegación y añade uno.
Después habilita la opción "Message Content Intent".
Pincha en el botón para copiar el token del bot. Por razones de seguridad, esta será la única vez que puedas verlo sin tener que generar otro, así que cópialo en un sitio seguro.
Expande el área llamada "OAuth2" en el menú de navegación y pincha en el botón "URL Generator". Aquí podrás seleccionar los permisos del bot para añadirlo a tu servidor de Discord. En el área de "Scopes" tendrás que seleccionar "bot" y "applications.commands".
Los permisos requeridos son los siguientes:
General Permissions
- Read Messages/View Channels
Text Permissions
- Send Messages
- Send Messages in Threads
- Read Message History
- Mention Everyone
- Use Slash Commands
Tras seleccionar los permisos correctos, aparecerá una URL en la parte inferior de la página. Copia esa URL y pégala en una nueva pestaña del navegador para permitir que el Bot se una a tu servidor. Puedes compartir este link con tus amigos si quieren añadir tu bot a otro servidor.
Una vez que el bot se haya unido a tu servidor, dale permisos para cualquier canal que quieras usar para interactuar con él. También puedes impedir que acceda a otros canales o categorías.
Accede a tu perfil para ver tus OpenAI API Keys. Tendrás que crear una cuenta gratuita si aún no la tienes.
Una vez allí, crea una nueva clave y cópiala en un lugar seguro.
Nota: Recuerda que a diferencia de ChatGPT, su API sí es de pago. Con tu cuenta tendrás acceso a unos 18$ de tokens gratuitos durante tres meses (para que os hagáis una idea, yo todavía no he gastado ni un tercio de los mismos, así que aunque finalmente tengáis que poner vuestra tarjeta, para este tipo de usos, no creo que lleguéis a gastar más de unos céntimos al mes).
Descarga todos los archivos de este repositorio (puedes hacerlo fácilmente desde la pestaña Code > Download Zip).
Lo más importante es editar el archivo mycontext.py con el bloc de notas o algún programa como Visual Studio Code. En este archivo se encuentra el prompt inicial que dotará de personalidad al bot. Borra el contenido actual y escribe tu prompt entre las comillas de la variable: prompt1="""AQUÍ""". Ten en cuenta que si tu prompt es demasiado largo, el bot llegará antes a su límite de memoria (actualmente de unas 3.000 palabras, entre prompts + respuestas) y tendrás que reiniciarlo, por lo que perderá el contexto anterior.
También debes editar el archivo npbot_discord.py. Puedes editar los siguientes elementos:
chat_history, como un pequeño prompt inicial para ChatGPT (como el nombre del personaje).- El estado del bot en Discord (
name="Dark.ia") - El nombre del comando
chaty su descripción (@client.tree.command(name="chat", description="Hablar con El Ordenador")). - La palabra "Escribiendo..." por lo que quieras que aparezca mientras se generan las respuestas del bot (
await interaction.response.send_message("Escribiendo...", ephemeral=True, delete_after=3) - La
await interaction.channel.send, sustituyendo la palabra "ORDENADOR" por el nombre de tu personaje.
También puedes añadir o modificar parámetros de ChatGPT, como la temperatura (un número entre el 0 y el 2, que permite disminuir o aumentar la creatividad de las respuestas). Tienes más información al respecto aquí: Chat completion - OpenAI API
Existe la posibilidad de generar otros comandos para el bot, lo que puede ser útil para establecer interacción con distintos personajes o personalidades del mismo, o para establecer otros "modos de juego". Solo tienes que hacer un copia y pega del comando existente, y así podrás cambiar como quieras prompt inicial (añadiendo uno nuevo a la variable prompt2 al final del archivo mycontext.py), para que los jugadores puedan alternar entre uno u otro.
Ten en cuenta que para que los jugadores puedan interactuar con el bot, tendrán que hacerlo sí o sí a través del comando "/chat" (o como lo hayas llamado). Si escriben únicamente en la caja de texto de Discord, el bot no recibirá ningún mensaje. Esto es bastante incómodo, pero de momento no sé cómo hacer que funcione bien con los mensajes normales.
El bot original contaba con un comando para usar la API de Whisper (con la que puedes transcribir un audio a texto), pero ha sido eliminado al no encontrarle utilidad para su uso en juegos de rol.
Instala el programa Docker Desktop desde aquí y ábrelo.
Ve a la carpeta donde tienes todos los archivos del bot y abre una terminal (si usas Windows, escribe "cmd" en la barra del explorador de archivos de dicha carpeta).
Allí tendrás que pegar el siguiente comando y después pulsar la tecla enter para generar la imagen de tu bot:
docker build -t npbot_discord .En el mismo lugar, debes crear el contenedor del bot haciendo lo mismo con el siguiente código, en el que debes introducir el token del bot y la API key que habías apuntado antes:
docker run -d --name npbot_discord --env DISCORD_BOT_TOKEN="TU-TOKEN" --env OPENAI_API_KEY="TU-APIKEY" npbot_discord:latestSi lo has hecho todo correctamente, tu bot debería estar funcionando y conectado a Discord. Puedes validar esto entrando en un canal de Discord en el que hayas dado permiso al bot para ver si está conectado.
En ese mismo canal, ya puedes utilizar el comando "/chat" para empezar a interactuar con tu personaje interpretado por ChatGPT.
El bot solo funcionará mientras tengas Docker abierto y el contenedor se esté ejecutando. En caso contrario, tu bot aparecerá desconectado y no podrá recibir ni responder ningún mensaje.
Si el bot se conecta tras haber sido desconectado previamente, no podrá recordar las conversaciones anteriores. El cambio de un comando a otro también genera una pérdida del contexto (aunque siempre puedes hacerle un resumen de lo que estaba pasando...)
Si no has cambiado nada en el bot, en tu siguiente sesión puedes abrir Docker y darle simplemente al play del contenedor del bot (npbot-discord), sin tener que ejecutar de nuevo los comandos para crear la imagen y el contenedor del bot.
Si quieres editar cualquier archivo del bot (por ejemplo, para cambiar el prompt), tendrás que borrar el contenedor y la imagen que has creado en Docker, para después volver a generarlas siguiendo los pasos anteriores. En este caso, no es necesario refrescar Discord, ya que los cambios se aplicarán automáticamente (pero, al tener que desconectarse y conectarse, habrá unos segundos de inactividad, y perderá el contexto previo). Si quieres modificar los comandos de Discord, sí tendrás que reiniciarlo todo.
Por último, si el tiempo y los conocimientos me lo permiten, o si alguien se anima a colaborar conmigo, estas son las funcionalidades que me gustaría explorar:
- Posibilidad de interactuar con el bot por Discord sin utilizar comandos (para que pueda recibir cualquier mensaje escrito por el canal)
- Utilizar el modelo GPT-4 para mejorar los resultados y ampliar la cantidad de información que podemos dar al bot (aunque habría que ver si resulta rentable, ya que por ahora es unas seis veces más caro)
- Introducir prompts por voz y obtener respuestas sonoras del bot (para simular llamadas telefónicas con los personajes)
- Añadir un avatar virtual de vídeo (para simular videollamadas con los personajes)
Si te ha resultado útil, puedes invitarme a un café en https://ko-fi.com/albadivarius
¡Gracias!