Estados da análise
Fluxo de processamento
Da chamada externa ao resultado persistido, o Quality Spy separa recebimento, validação, fila, transcrição e avaliação por IA.
Visão geral do fluxo
- Sistema externo
POST /api/v1/external-audio- Laravel API
- Validação
- Banco de dados
- Job na fila
- Transcrição
- Avaliação por IA
- Resultado
Recebimento
No recebimento, a API confere as informações necessárias para registrar a solicitação com segurança e rastreabilidade.
- Validação do token.
- Validação dos metadados.
- Validação do arquivo.
- Verificação de duplicidade.
Persistência inicial
Depois das validações, a API registra ou associa as entidades necessárias para acompanhar a gravação ao longo do processamento.
- Criação ou associação de
Agent. - Criação de
Occurrence. - Criação de
CallRecording.
Despacho para a fila
Com o registro inicial persistido, o trabalho pesado é encaminhado para processamento posterior.
- Despacho de
ProcessTranscriptionJob. - Resposta rápida ao sistema externo.
- Processamento posterior por worker.
Provider de transcrição
ProcessTranscriptionJobTranscriptionProviderInterfaceMockProviderouHttpProvider- OpenAI, Deepgram ou outro fornecedor
O uso de uma interface permite separar o job da implementação concreta de transcrição. Assim, diferentes providers podem ser conectados por configuração ou por implementação, sem afirmar que todos os fornecedores listados estejam ativos em produção.
Avaliação por IA
- Áudio
- Transcrição
- Prompt Builder
- Modelo de IA
- Resposta JSON
- Parser
- Score Calculator
- Banco de dados
Resultado final
O resultado final relaciona conceitualmente a gravação, sua transcrição e a avaliação produzida pela IA.
CallRecording
Representa a gravação recebida e seu vínculo com a ocorrência.
Transcription
Representa o texto obtido a partir do áudio processado.
AiEvaluation
Representa a avaliação estruturada gerada a partir da transcrição.
Informações exibidas
- Nota.
- Resumo.
- Critérios avaliados.
- Pontos fortes.
- Pontos fracos.
- Recomendações.