Inicia sesión en la app NPC Builder #
Accede a la aplicación web de NPC Builder a través de este enlace: https://app.npcbuilder.com.
Navega a la sección de desarrolladores #
Haz click en el icono de desarrolladores de la barra de navegación
Genera el token de autenticación #
Haz click en el botón «Generate Bearer Token» y copia el resultado. Guárdalo para después!
Obtén los IDs de tu juego y mundo #
En el arbol que aparece en pantalla, encuentra los IDs asociados al juego y mundo donde se encuentra tu personaje.
Construye la petición a la API #
Con los detalles previos ya puedes construir el cuerpo de la llamada a la API como sigue:
{
"character_name":"Name",
"game_id":"ID",
"world_id":"ID",
"messages":[
{"role":"user",
"content":"Message"}
]
}NOTA: Recuerda que para mantener el contexto de toda la conversación, es importante añadir todas las interacciones, deberás añadir todos los mensajes a la lista como se muestra a continuación.
El parámetro «role» puede tomar los siguientes valores (es sensible a mayúsculas y minúsculas):
-user: representa al usuario que está interactuando con el NPC
-assistant: representa al NPC
{
"character_name":"Name",
"game_id":"ID",
"world_id":"ID",
"messages":[
{"role":"user",
"content":"Message"},
{"role":"assistant",
"content":"Message"},
{"role":"user",
"content":"Message"}
]
}Envía la petición a la API #
Envía tu petición a la API con el método POST a nuestro endpoint. Recuerda utilizar Autorización tipo Bearer pasando el token obtenido en el paso «Genera el token de autenticación», y el body construido en el paso «Construye la petición a la API»
POST https://app.npcbuilder.com/api/interactionsRecupera la respuesta #
Recibirás directamente la respuesta del personaje a la lista de mensajes, formateado como un string.
{
"response": "Hello, how are you today?"
}