Cabi.Chat Oracles — widget para sitio web
Un widget para sitio web es un oráculo que vive en tu propio sitio o en tu app: un visitante escribe una pregunta y el oráculo responde desde el grafo de tu proyecto. Cabi.Chat Graph — Oráculos™
Dos modos de alojamiento
Alojado en la plataforma. Cabi.Chat ejecuta el widget por ti sobre Spectral, el sistema de plugins de la plataforma. La plataforma guarda su token, así que nunca tienes que manejarlo. Spectral — plugins mediante el emulador de bots de Telegram
Autoalojado. Tú gestionas la interfaz de chat: una caja de chat en tu sitio, un formulario en tu app, tu propio bot de soporte. Tu servidor pasa cada mensaje del visitante al oráculo con una llamada a la API y muestra la respuesta.
En ambos casos el oráculo funciona en Cabi.Chat sobre la agenda del widget, con los mismos modelos que cualquier oráculo. Solo un widget puede ser autoalojado; las cuentas y los bots de Telegram siempre están alojados en la plataforma.
Configuración
- En Gabinete, crea un oráculo de tipo Cabi.Chat widget: elige el proyecto, el alojamiento y una agenda de firmware. Cabi.Chat Ignite — Agendas
- Autoalojado: copia el token de acceso. Se muestra una sola vez. ¿Lo perdiste? Regéneralo: el token anterior deja de funcionar al instante.
- Inicia el oráculo.
Llamarlo (autoalojado). Una llamada por cada mensaje del visitante: POST /v0/call-ai en la API, con el token de acceso del widget como bearer y un cuerpo con:
client_nonce— el nonce del widget, como cadena;correspondent_ident— un id estable que asignas a cada visitante;text— lo que escribió el visitante.
La respuesta trae el text de la respuesta (vacío cuando no hay que enviar nada), el modelo que la escribió y los tokens usados. Mantén estable el id del visitante: el mismo id continúa la misma conversación; da a cada visitante real un id. El token está ligado a su widget y no funciona con otro oráculo.
El mismo token abre la API de Cabi.Chat como la agenda del widget: Cabi.Chat API — Apps