Operazioni e Analisi

Controllo operativo senza strumenti aggiuntivi

La piattaforma Companin espone tutti i segnali critici necessari per mantenere affidabili gli assistenti clienti. Registri, dashboard di utilizzo e raccolta di feedback sono recuperabili tramite API autenticate in modo da poter inserire i dati nello stack di osservabilità esistente.

Osservabilità delle richieste e degli endpoint

Estrai i log delle richieste strutturate con <code>GET /analytics/logs/</code> e impagina le prestazioni a livello di endpoint utilizzando <code>/analytics/endpoints/</code>. Ogni record contiene timestamp, metodo HTTP, codice di stato e l'esatto hit dell'endpoint, semplificando l'inserimento dei dati in Grafana, Looker o qualsiasi strumento già alimenta il tuo NOC.

Gli endpoint di utilizzo aggregati riepilogano i volumi di traffico nel tempo in modo che i pianificatori della capacità possano valutare l'adozione senza interrogare i registri non elaborati.

Guardrail limite di velocità

Per impostazione predefinita, le limitazioni con ambito organizzazione limitano le integrazioni a 100 richieste all'ora. Quando una chiave si avvicina al limite, <code>GET /analytics/rate-limits/</code> evidenzia gli eventi bloccati rispetto a quelli consentiti insieme ai timestamp in modo da poter ottimizzare le policy prima che i clienti subiscano tempi di inattività.

I superamenti del limite di velocità vengono registrati con la chiave API di attivazione, consentendo ai team di sicurezza di individuare rapidamente modelli di abuso o clienti in fuga.

Fatturazione e previsione della capacità

Gli aggregati di utilizzo (<code>GET /analytics/usage/</code>) e l'analisi delle chiavi API (<code>/analytics/keys/</code>) forniscono gli input necessari per gli estratti conto o l'applicazione delle quote. Tieni traccia delle richieste totali per cliente, dei timestamp degli ultimi utilizzi e delle tendenze su qualsiasi finestra definita.

I payload JSON restituiscono conteggi totali, dettagli di paginazione e intervalli di tempo in modo che i team finanziari e operativi possano riconciliare l'utilizzo con gli impegni contrattuali.

Miglioramenti guidati dal feedback

Combina l'osservabilità con segnali qualitativi memorizzando le valutazioni tramite <code>POST /api/v1/conversations/:conversation_id/feedback</code>. L'API acquisisce il revisore, la valutazione e il commento facoltativo mantenendo il payload collegato alla conversazione esatta per l'analisi della riproduzione.

Poiché gli oggetti di feedback convivono insieme ai metadati delle conversazioni, puoi raggruppare i problemi per persona, canale o segmento di clienti e inserirli direttamente negli aggiornamenti dei prompt o del flusso di lavoro.

Prontezza agli incidenti e gestione degli errori

Le eccezioni non gestite vengono racchiuse da un gestore di errori Ninja personalizzato che restituisce JSON strutturato con campi di stato, dettaglio e traceback. Ciò significa che il tuo sistema di avviso vede ogni volta lo stesso schema, indipendentemente dal fatto che il problema sia una dipendenza upstream o un errore di convalida.

In combinazione con la sicurezza delle chiavi API e la memorizzazione nella cache nell'ambito dell'organizzazione, ottieni una superficie prevedibile che rende le rotazioni delle chiamate molto meno stressanti.