Skip to main content

Visão Geral da Entrevista da Triagem

A entrevista da triagem é uma conversa guiada por IA, conduzida pelo profissional que está com o paciente. A cada turno o assistente formula uma pergunta a partir do caso — queixa, sinais vitais, exames já lidos, atendimentos anteriores e a conversa até ali —, o profissional registra a resposta, e o assistente decide se pergunta mais ou se já tem o suficiente. Com o consentimento do paciente, o áudio da conversa é gravado (LiveKit) e, ao final, vira um resumo clínico.


Base​

https://api-dev.imagemais.com.br/api/triages/{id}/interview

A entrevista pertence a uma triagem e exige que ela tenha o motivo (consultationReason) preenchido.

Duas entrevistas diferentes

Esta é a entrevista por voz, turno a turno. A rota POST /triages/{id}/interview (sem /start) é outra coisa: cria uma sessão do Assistente Virtual, em que o paciente responde por texto a um plano de perguntas.


Fluxo típico​

  1. Opcionalmente, conferir o que o assistente vai receber com Contexto da Entrevista — paciente, queixa, vitais e resumos dos exames. Funciona antes de abrir a entrevista.
  2. Abrir a entrevista informando recordingConsent. A resposta traz a sala e o token do LiveKit (para o áudio) e o primeiro turno, com a pergunta de abertura já formulada a partir do caso. Chamar de novo com uma entrevista em andamento devolve a mesma, sem abrir outra sala.
  3. Para cada turno, Responder Turno com a position do turno atual e a resposta do paciente. A resposta traz nextAction:
    • next_turn — há uma nova pergunta em turn;
    • end — o assistente considerou que já tem o suficiente e a entrevista foi encerrada.
  4. O profissional pode encerrar antes com Encerrar Entrevista.
  5. O resumo clínico é gerado sozinho quando a gravação termina. Buscar Entrevista traz os turnos, o resumo e o estado da gravação; Refazer Resumo gera o resumo de novo.
Sem limite de turnos

Não há teto de turnos: quem decide o fim é o assistente (ou o profissional). Se a geração de uma pergunta falhar — ou o assistente repetir uma pergunta já feita —, o turno entra com um texto de apoio e source: "SUPPORT", devolvendo a condução ao profissional.


Estados​

Entrevista (status)

ValorQuando
IN_PROGRESSAberta, recebendo turnos
FINISHEDEncerrada pelo assistente ou pelo profissional
ABANDONEDA sala de áudio fechou com a entrevista ainda aberta (aba fechada, queda de rede)

Motivo do encerramento (finishReason)

ValorQuando
SUFFICIENTO assistente declarou que já tem o necessário (encerramento normal)
MANUALO profissional encerrou
ABANDONEDA sala fechou antes de alguém encerrar
COVERAGE, TURN_LIMITLegado — só aparecem em entrevistas antigas

Gravação (recordingState)

ValorQuando
DISABLEDSem consentimento (ou gravação desligada) — ausência esperada, não é falha
PENDINGSala criada, gravação ainda não começou
RECORDINGGravando
UPLOADINGEnviando o arquivo ao storage
STOREDÁudio salvo
FAILEDA gravação falhou

Origem da pergunta (source do turno): AI quando o assistente formulou a pergunta; SUPPORT quando entrou o texto de apoio.


Rotas​

MétodoRotaPermissãoDescrição
GET/triages/{id}/interview/contextread_triagesO que o assistente recebe
POST/triages/{id}/interview/startupdate_triagesAbre a entrevista
POST/triages/{id}/interview/turnupdate_triagesResponde o turno atual
POST/triages/{id}/interview/finishupdate_triagesEncerra a entrevista
POST/triages/{id}/interview/summaryupdate_triagesRefaz o resumo clínico
GET/triages/{id}/interviewread_triagesTurnos, resumo e gravação