Envoyer vos champs de session

Vos dashboards peuvent suivre vos propres indicateurs métier. Par exemple, pour un SIA de support client : « ticket créé », « résolution proposée par l'IA », « client aidé ». Cette page explique comment envoyer ces données.

Le principe

• Chaque session porte vos champs.
• NiaOne repère ces champs tout seul, sans configuration.
• Vous les retrouvez dans les dashboards : KPI, répartitions, courbes et assistant IA.

Une règle par type de valeur

Choisissez le canal selon le type de la valeur. Gardez le même canal pour un champ donné.

Pourquoi ces choix :

• Un label n'accepte que du texte. Un booléen JSON (true sans guillemets) est refusé à l'envoi. Écrivez donc "true" ou "false".
• Les labels servent à trier et regrouper. C'est ce qu'il faut pour un taux ou une répartition.
• Une métrique porte un vrai nombre et son unité. NiaOne peut en faire une moyenne ou un total.

Où les envoyer

Une session regroupe plusieurs tours. Chaque tour est un flow, et tous les tours partagent le même session_id (voir Sessions et traçage distribué).

Deux façons de faire, au choix :

• Sur le flow de chaque tour, avec le même session_id. Les labels du flow sont hérités par toutes ses étapes et tous ses événements.
• Sur un flow de fin de session, envoyé une fois quand la session se termine, avec le même session_id. C'est le plus simple quand les valeurs ne sont connues qu'à la fin.

Exemple complet : un SIA de support

Cet exemple envoie un flow de fin de session. Il combine des appels déjà documentés :

• start_flow / startFlow avec labels (voir Labels et annotations) ;
• le paramètre session_id / sessionId (voir Sessions) ;
• metric sur une étape, puis end_step et end_flow (voir Capturer les données et Instrumenter).

def fin_de_session(session_id: str, ticket_cree: bool, resolution_proposee: bool,                 client_aide: str, duree_traitement_s: float):  # Les labels sont du texte : "true" / "false", jamais un booléen.  flow = start_flow(client, flow_definition_id="support_bot", name="support_bot_main",      session_id=session_id,      labels={          "x.ticket_cree": "true" if ticket_cree else "false",          "x.resolution_proposee": "true" if resolution_proposee else "false",          "x.client_aide": client_aide,  # "oui", "non" ou "partiel"      })  # Le nombre passe par une métrique, sur une étape de ce flow.  step = start_step(flow, asset=asset, flow=Flow(name="support_bot_main"))  metric(step, "duree_traitement_s", duree_traitement_s, unit="s")  end_step(step, "success")  end_flow(flow, "success")fin_de_session("conv_8421", ticket_cree=True, resolution_proposee=True,             client_aide="partiel", duree_traitement_s=184)

Pour envoyer les champs sur chaque tour, ajoutez les mêmes labels au flow de chaque tour. Mettez-y les valeurs connues à ce moment-là.

Ce que vous obtenez dans NiaOne

NiaOne déduit le type de chaque champ à partir des valeurs reçues. Il propose alors des blocs adaptés. Le nom affiché est un nom lisible, sinon la clé.

• Combiner deux champs : demandez-le à l'assistant IA du dashboard. Par exemple : « taux de clients aidés parmi les sessions où l'IA a proposé une résolution ».
• Voir les sessions derrière un chiffre : cliquez sur un chiffre, un jour ou une valeur. La liste des sessions concernées s'ouvre. Chaque ligne ouvre le détail de la session.
• Les jours suivent le fuseau horaire de votre navigateur.

Bonnes pratiques et limites

Vérifier que ça marche

1. 1

   Envoyer une session de test

   Lancez une session avec vos champs, avec la clé API de votre environnement de test.

2. 2

   Contrôler la session

   Dans Explore › Sessions, ouvrez la session, puis l'onglet Metadata. Vos champs apparaissent dans Labels. Vous pouvez aussi afficher un champ en colonne via Colonnes › champs custom (voir Exploiter les metadata).

3. 3

   Retrouver le champ dans un dashboard

   Dans un dashboard, ouvrez Ajouter des blocs › Vos champs. Vos champs y sont listés après les premiers envois, avec les blocs proposés pour leur type.