Operações e Análises

Controle operacional sem ferramentas extras

A plataforma Companin expõe todos os sinais críticos necessários para manter os assistentes de cliente confiáveis. Logs, painéis de uso e coleta de feedback podem ser recuperados por meio de APIs autenticadas para que você possa incorporar os dados em sua pilha de observabilidade existente.

Observabilidade de solicitação e endpoint

Extraia logs de solicitação estruturados com <code>GET /analytics/logs/</code> e paginar através do desempenho no nível do endpoint usando <code>/analytics/endpoints/</code>. Cada registro carrega carimbos de data e hora, método HTTP, código de status e o acerto exato do endpoint, simplificando a alimentação de dados no Grafana, Looker ou qualquer ferramenta que já ative seu NOC.

Os endpoints de uso agregados resumem os volumes de tráfego ao longo do tempo para que os planejadores de capacidade possam avaliar a adoção sem consultar logs brutos.

Protetores de limite de taxa

O escopo da organização limita as integrações a 100 solicitações por hora por padrão. Quando uma chave se aproxima do limite, <code>GET /analytics/rate-limits/</code> destaca eventos bloqueados versus eventos permitidos junto com carimbos de data/hora para que você possa ajustar as políticas antes que os clientes passem por um tempo de inatividade.

Os acertos de limite de taxa são registrados com a chave de API de acionamento, permitindo que as equipes de segurança identifiquem rapidamente padrões de abuso ou clientes em fuga.

Previsão de faturamento e capacidade

Agregados de uso (<code>GET /analytics/usage/</code>) e análises de chave de API (<code>/analytics/keys/</code>) fornecem as entradas necessárias para extratos de cobrança ou aplicação de cota. Acompanhe o total de solicitações por cliente, os últimos carimbos de data/hora usados ​​e as tendências em qualquer janela que você definir.

As cargas JSON retornam contagens totais, detalhes de paginação e intervalos de tempo para que as equipes financeiras e de operações possam reconciliar o uso com os compromissos contratuais.

Melhorias orientadas por feedback

Combine observabilidade com sinais qualitativos armazenando classificações por meio de <code>POST /api/v1/conversations/:conversation_id/feedback</code>. A API captura o revisor, a classificação e o comentário opcional, mantendo a carga vinculada à conversa exata para análise de repetição.

Como os objetos de feedback convivem com os metadados da conversa, você pode agrupar problemas por pessoa, canal ou segmento de cliente e alimentá-los diretamente em atualizações de prompt ou de fluxo de trabalho.

Preparação para incidentes e tratamento de erros

Exceções não tratadas são agrupadas por um manipulador de erros Ninja personalizado que retorna JSON estruturado com campos de status, detalhes e rastreamento. Isso significa que seu sistema de alerta sempre vê o mesmo esquema, seja o problema uma dependência upstream ou um erro de validação.

Combinado com a segurança da chave de API e o cache com escopo organizacional, você obtém uma área de superfície previsível que torna as rotações de chamada muito menos estressantes.