Saltar al contenido principal

Chat — adjunta AI a tu mapa

product="chat" monta Kaleidr Control Tower — navegación mediante chat, resúmenes de POI y marcadores de lugares — sobre un mapa que tú ya renderizas. El paquete de chat detecta automáticamente tu proveedor de mapas (Mapbox, MapLibre, Google).

  • Método de integración: attach — el panel se monta dentro de tu página y controla el objeto del mapa que le proporcionas.
  • Ámbito requerido: ai.
  • Plan mínimo: Pro — las claves Free no permiten el ámbito ai.

Antes de comenzar​

  • El origen de tu página debe estar en la lista de orígenes permitidos de la clave. De lo contrario, el intercambio de sesión falla con 403 session_origin_mismatch. file:// no envía ningún Origin y siempre falla — utiliza HTTP(S). Consulta Obtener una clave API.
  • Tu CSP debe permitir el cargador del SDK, 'wasm-unsafe-eval' de MapLibre y los hosts de tu proveedor de mapas — consulta Content Security Policy.

Montaje​

const handle = Kaleidr.mount('#chat-panel', {
  product: 'chat',
  publishableKey: 'kld_pk_live_…',   // ai scope, Pro+
  map: myMap,                         // your live map instance
  contained: true,                    // dock inside #chat-panel, not on body
});

contained: true acopla el panel dentro del elemento de montaje. Sin esta opción, el panel se desplaza a document.body y parece roto sobre tu diseño.

El panel de chat coloca lugares sobre myMap y encuadra la cámara a medida que la conversación resuelve ubicaciones. El streaming utiliza el SSE wire contract; el uso del ámbito ai se descuenta de la cuota de tu organización.

Handle​

handle.destroy();                     // always available
handle.setTheme({ '--kd-accent': '#2da84a' });  // live theme update
  • handle.setCamera(...) en chat es un no-op. Chat no controla la cámara del mapa — utiliza la API de cámara de tu propia instancia del mapa.
  • handle.setTheme(...) acepta un objeto JSON de tokens CSS; los temas con nombre en formato string se ignoran con una advertencia.

Se admite el modo headless (sin mapa) — omite map para tener solo un panel de chat; no habrá marcadores ni superposiciones de rutas.

Guías por proveedor​