Recursos da Organização

O Que Sua Organização Obtém Fora da Caixa

O Companin é enviado com a infraestrutura que sua equipe de operações precisa para lançar e supervisionar assistentes voltados para o cliente. Cada recurso é apoiado por endpoints de API reais, limitado por taxa para segurança e isolado por organização para manter limites de dados claros.

Gerenciamento do Ciclo de Vida do Assistente

Gerencie cada persona de assistente através dos endpoints POST /api/v1/assistants/, PATCH /api/v1/assistants/:assistant_id e DELETE /api/v1/assistants/:assistant_id. Armazene tom, idioma e modelos de tarefa padrão por assistente para que cada implantação reflita a audiência que serve.

Atualizações seguras de versão permitem promover mudanças sem tocar configurações anteriores, enquanto sinalizadores de ativação por assistente facilitam pausar experimentos sem reemitir chaves API.

Operações de Conhecimento Unificado

Faça upload de PDFs, CSVs, texto simples, JSON ou imagens com POST /api/v1/knowledge/files/, organize bancos Q&A através de /api/v1/knowledge/qas/ e ingira URLs ao vivo via /api/v1/knowledge/urls/. Cada registro captura resumos gerados por IA, palavras-chave e incorporações para que sua pilha de recuperação esteja pronta no momento em que o conteúdo chega.

Vincule ou exclua fontes por assistente para manter material regulamentado separado de respostas públicas e atualize incorporações sempre que seu conhecimento evolua.

Orquestração de Sessão e Contexto

Use POST /api/v1/sessions/ para girar sessões autenticadas ou anônimas, anexe atributos de visitante através de /api/v1/contexts e armazene metadados que mapeiam de volta ao seu CRM. Expiração configurável mantém sessões obsoletas de persistir enquanto ainda fornece rastreabilidade total entre canais.

Como contexto, sessões e conversas compartilham identificadores com escopo organizacional, você pode costurar jornadas omnichannel sem vazar dados entre clientes.

Sinais de Conversa e Feedback

A API de conversas mantém cada troca auditável com POST /api/v1/conversations/ e GET /api/v1/conversations/:conversation_id/messages. Capture pontuações de satisfação usando POST /api/v1/conversations/:conversation_id/feedback para que equipes de produto possam medir resultados sem construir encanamento adicional.

Registros de feedback incluem classificação, comentários em formato livre e metadados de ator, dando-lhe um sinal limpo para melhorar prompts, regras de escalação ou handoffs humanos.

Governança API-First

Cada chamada requer um cabeçalho X-API-Key que mapeia para uma organização específica. O limitador de taxa embutido limita o tráfego a 100 solicitações por hora por organização e registra tentativas de quebra para trilhas de auditoria. Como autenticamos através do Django Ninja, você pode estender a autenticação com seu próprio middleware quando precisar de políticas mais complexas.

Respostas JSON estruturadas mantêm consumidores previsíveis entre estados 2xx e 4xx, tornando a ferramenta de observabilidade mais fácil de conectar.

Análises e Observabilidade

Endpoints de análise dedicados como GET /analytics/logs/, /analytics/usage/, /analytics/endpoints/ e /analytics/rate-limits/ revelam detalhes de nível de solicitação, volume agregado, mix de endpoint e eventos de limitação. Filtre por organização ou chave API para detectar anomalias antes que atinjam SLAs.

Combinado com feedback de conversa e metadados, esses painéis dão equipes de cliente um loop fechado completo sobre performance sem precisar de um pipeline de dados separado.