Opérations et Analyses

Contrôle Opérationnel Sans Outil Supplémentaire

La plateforme Companin expose chaque signal critique dont vous avez besoin pour garder les assistants clients fiables. Les journaux, tableaux d'utilisation et collecte de feedback sont récupérables à travers des APIs authentifiées afin que vous puissiez plier les données dans votre pile d'observabilité existante.

Observabilité de Demandes et Endpoints

Tirez des journaux de demandes structurés avec <code>GET /analytics/logs/</code> et paginez à travers les performances au niveau endpoint en utilisant <code>/analytics/endpoints/</code>. Chaque enregistrement porte des timestamps, méthode HTTP, code de statut et l'exact endpoint frappé, rendant simple de nourrir les données dans Grafana, Looker ou quel que soit l'outillage qui alimente votre NOC.

Les endpoints d'utilisation agrégés résument le trafic sur le temps afin que les planificateurs de capacité puissent évaluer l'adoption sans interroger les journaux bruts.

Garde-fous de Limite de Débit

Les throttles étendus par organisation cappent les intégrations à 100 demandes par heure par défaut. Quand une clé approche la limite, <code>GET /analytics/rate-limits/</code> met en évidence les événements bloqués versus autorisés avec timestamps afin que vous puissiez ajuster les politiques avant que les clients ressentent le downtime.

Les hits de limite de débit sont enregistrés avec la clé API déclenchante, laissant les équipes de sécurité repérer les modèles d'abus ou clients runaway rapidement.

Facturation et Prévision de Capacité

Les agrégats d'utilisation (<code>GET /analytics/usage/</code>) et analyses de clé API (<code>/analytics/keys/</code>) fournissent les entrées dont vous avez besoin pour les déclarations de facturation ou enforcement de quota. Suivez le volume total par client, timestamps de dernière utilisation et tendances sur n'importe quelle fenêtre que vous définissez.

Les payloads JSON retournent les comptes totaux, détails de pagination et buckets de temps afin que finance et opérations équipes puissent concilier l'utilisation contre les engagements contractuels.

Améliorations Alimentées par Feedback

Combinez l'observabilité avec des signaux qualitatifs en stockant les ratings à travers <code>POST /api/v1/conversations/:conversation_id/feedback</code>. L'API capture l'évaluateur, rating et commentaire optionnel tout en gardant le payload lié à la conversation exacte pour l'analyse de replay.

Parce que les objets de feedback vivent aux côtés des métadonnées de conversation, vous pouvez grouper les problèmes par persona, canal ou segment client et nourrir cela directement dans les mises à jour de prompt ou workflow.

Préparation à l'Incident et Gestion d'Erreurs

Les exceptions non gérées sont enveloppées par un gestionnaire d'erreur Ninja personnalisé qui retourne un JSON structuré avec champs de statut, détail et traceback. Cela signifie que votre système d'alerte voit le même schéma chaque fois, que l'issue soit une dépendance en amont ou une erreur de validation.

Combiné avec la sécurité de clé API et le caching étendu par organisation, vous obtenez une surface prévisible qui rend les rotations de on-call bien moins stressantes.