Aller au contenu principal

Chat — ajouter l’AI à votre carte

product="chat" monte Kaleidr Control Tower — navigation pilotée par le chat, résumés de POI et marqueurs de lieux — au-dessus d’une carte que vous affichez déjà. Le bundle chat détecte automatiquement votre fournisseur de cartes (Mapbox, MapLibre, Google).

  • Mode d’intégration : attach — le panneau est monté dans votre page et pilote l’objet carte que vous lui fournissez.
  • Portée requise : ai.
  • Forfait minimum : Pro — les clés Free n’autorisent pas la portée ai.

Avant de commencer​

  • L’origine de votre page doit figurer dans la liste des origines autorisées de la clé. Sinon, l’échange de session échoue avec 403 session_origin_mismatch. file:// n’envoie aucun Origin et échoue toujours — utilisez HTTP(S). Consultez Obtenir une clé API.
  • Votre CSP doit autoriser le chargeur SDK, 'wasm-unsafe-eval' de MapLibre et les hôtes de votre fournisseur de cartes — consultez Content Security Policy.

Montage​

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 ancre le panneau dans l’élément de montage. Sans cette option, le panneau sort vers document.body et semble cassé au-dessus de votre mise en page.

Le panneau chat place des lieux sur myMap et cadre la caméra à mesure que la conversation identifie des emplacements. Le streaming utilise le SSE wire contract ; l’utilisation de la portée ai est décomptée du quota de votre organisation.

Handle​

handle.destroy();                     // always available
handle.setTheme({ '--kd-accent': '#2da84a' });  // live theme update
  • handle.setCamera(...) sur chat est un no-op. Chat ne pilote pas la caméra de la carte — utilisez l’API de caméra de votre propre instance de carte.
  • handle.setTheme(...) accepte un objet JSON de tokens CSS ; les thèmes nommés sous forme de chaîne sont ignorés avec un avertissement.

Le mode headless (sans carte) est pris en charge — omettez map pour un panneau chat uniquement ; il n’y aura ni marqueurs ni superpositions d’itinéraires.

Guides par fournisseur​