Características de Organización

Qué Obtiene Tu Organización Listo para Usar

Companin se envía con la infraestructura que tu equipo de operaciones necesita para lanzar y supervisar asistentes IA orientados al cliente. Cada característica está respaldada por puntos finales API reales, limitada por tasa para seguridad y aislada por organización para mantener los límites de datos claros.

Gestión del Ciclo de Vida del Asistente

Gestiona cada persona de asistente a través de los puntos finales POST /api/v1/assistants/, PATCH /api/v1/assistants/:assistant_id y DELETE /api/v1/assistants/:assistant_id. Almacena tono, idioma y plantillas de tareas predeterminadas por asistente para que cada despliegue refleje la audiencia que sirve.

Actualizaciones seguras de versión permiten promover cambios sin tocar configuraciones anteriores, mientras que banderas de activación por asistente hacen simple pausar experimentos sin reemitir claves API.

Operaciones de Conocimiento Unificadas

Sube PDFs, CSVs, texto plano, JSON o imágenes con POST /api/v1/knowledge/files/, cura bancos Q&A a través de /api/v1/knowledge/qas/ e ingesta URLs en vivo vía /api/v1/knowledge/urls/. Cada registro captura resúmenes generados por IA, palabras clave y embeddings para que tu pila de recuperación esté lista en el momento en que llegue el contenido.

Vincula o excluye fuentes por asistente para mantener material regulado separado de respuestas públicas y actualiza embeddings cada vez que evolucione tu conocimiento.

Orquestación de Sesiones y Contexto

Usa POST /api/v1/sessions/ para iniciar sesiones autenticadas o anónimas, adjunta rasgos de visitantes a través de /api/v1/contexts y almacena metadatos que se asignan de vuelta a tu CRM. Caducidad configurable mantiene sesiones obsoletas de persistir mientras aún proporciona trazabilidad completa en canales.

Dado que contexto, sesiones y conversaciones comparten identificadores con alcance organizacional, puedes unir viajes omnicanal sin filtrar datos entre clientes.

Señales de Conversación y Retroalimentación

La API de conversaciones mantiene cada intercambio auditable con POST /api/v1/conversations/ y GET /api/v1/conversations/:conversation_id/messages. Captura puntuaciones de satisfacción usando POST /api/v1/conversations/:conversation_id/feedback para que equipos de producto puedan medir resultados sin construir plumbing adicional.

Registros de retroalimentación incluyen calificación, comentarios de forma libre y metadatos de actor, dándote una señal limpia para mejorar prompts, reglas de escalada o entregas humanas.

Gobernanza Primero en API

Cada llamada requiere un encabezado X-API-Key que se asigna a una organización específica. El limitador de tasa incorporado limita el tráfico a 100 solicitudes por hora por organización y registra intentos de infracción para registros de auditoría. Dado que autenticamos a través de Django Ninja, puedes extender la autenticación con tu propio middleware cuando necesites políticas más complejas.

Respuestas JSON estructuradas mantienen consumidores predecibles en estados 2xx y 4xx, haciendo que las herramientas de observabilidad sean más fáciles de cablear.

Análisis y Observabilidad

Puntos finales dedicados de análisis como GET /analytics/logs/, /analytics/usage/, /analytics/endpoints/ y /analytics/rate-limits/ muestran detalle a nivel de solicitud, volumen agregado, mezcla de puntos finales y eventos de limitación. Filtra por organización o clave API para detectar anomalías antes de que golpeen SLAs.

Combinado con retroalimentación de conversación y metadatos, estos dashboards dan a equipos de cliente un bucle cerrado completo en rendimiento sin necesidad de una tubería de datos separada.