Skip to main content

Visão Geral do Assistente Virtual

O Assistente Virtual faz uma entrevista clínica por texto antes do atendimento: gera um plano de perguntas a partir da queixa e dos sinais vitais, avalia cada resposta do paciente (podendo fazer perguntas de aprofundamento) e, ao final, produz um resumo clínico para o médico. Toda a lógica — perguntas, avaliação e resumo — vem de prompts cadastrados por conta, sem mudança de código.

O módulo tem três partes:

PartePara quêPermissão
Sessões (/assistant/session)A entrevista em si, com um pacientemanage_assistant para escrever; leitura só exige autenticação
Configurações (/assistant-config)Os prompts e parâmetros do modelomanage_assistant_config
Tipos de agente (/assistant-agent-type)Protocolos especializados por queixamanage_assistant_config

Base​

https://api-dev.imagemais.com.br/api/assistant
https://api-dev.imagemais.com.br/api/assistant-config
https://api-dev.imagemais.com.br/api/assistant-agent-type

Todas as rotas exigem autenticação e são isoladas pela conta (accountId) do token.


Fluxo da sessão​

  1. Criar a sessão com patientId e consultationReason (e os sinais vitais disponíveis). O backend gera o plano de perguntas com IA e, se algum tipo de agente combinar com a queixa, acrescenta as perguntas especializadas.
  2. Buscar a sessão para exibir as perguntas.
  3. Para cada pergunta, Responder Pergunta com o questionId e o texto digitado. A resposta indica o próximo passo:
    • follow_up — pergunta de aprofundamento em followUp;
    • next_question — próxima pergunta do plano em nextQuestion;
    • end — todas as perguntas foram respondidas.
  4. Ao terminar (ou ao concluir manualmente), o resumo clínico é gerado em segundo plano. Buscar Resumo da Sessão responde 400 "Resumo clínico ainda não disponível" até ficar pronto.
  5. Vincular a sessão a uma consulta para que o médico a encontre em Buscar Sessão por Consulta.

Sessões que não serão usadas podem ser descartadas. A triagem e a pré-consulta também abrem sessões do assistente a partir dos dados já coletados.


Estados da sessão​

ValorQuando
ASKING_QUESTIONSessão criada com o plano pronto, aguardando resposta
PROCESSING_RESPONSEAvaliando a resposta recebida
FINAL_SUMMARYTodas as perguntas respondidas; gerando o resumo
COMPLETEDResumo gerado
FAILEDErro na geração

CREATED, WAITING_ASSISTANT, INTRODUCTION e LISTENING_RESPONSE existem no enum por causa de um fluxo antigo por voz e só aparecem em sessões antigas.


Configurações​

Uma configuração reúne os três prompts do assistente e os parâmetros do modelo:

PromptQuando rodaVariáveis
interviewPlanPromptNa criação da sessão, gera as perguntas{{reason}}, {{vitals}}, {{questionCount}}
evaluateAnswerPromptA cada resposta, decide entre follow-up e próxima pergunta{{consultationReason}}, {{vitals}}, {{question}}, {{goal}}, {{answer}}, {{followUpCount}}, {{maxFollowUps}}, {{history}}
clinicalSummaryPromptNo fim, gera o resumo clínicorespostas da entrevista

Uma configuração nasce inativa. Ativar uma configuração desativa as demais do mesmo agentType; sem agentType, ela vale para a entrevista básica.

Tipos de agente​

Um tipo de agente é um protocolo especializado (por exemplo, dor torácica). Os triggers são exemplos de queixas que o ativam: na criação da sessão, a IA compara a queixa do paciente com os tipos ativos e escolhe o mais adequado — ou nenhum. O tipo escolhido usa a configuração ativa com o mesmo agentType.

Tipos nascem ativos

Diferente das configurações, um tipo de agente é criado com isActive: true e passa a ser considerado nas sessões seguintes. Envie isActive: false para cadastrar sem ativar.


Rotas​

MétodoRotaPermissãoDescrição
POST/assistant/sessionmanage_assistantCria a sessão
GET/assistant/session/{id}—Busca a sessão
GET/assistant/session/by-consultation/{consultationId}—Sessão da consulta
POST/assistant/session/{id}/answermanage_assistantResponde uma pergunta
PATCH/assistant/session/{id}/completemanage_assistantConclui a sessão
GET/assistant/session/{id}/summary—Resumo clínico
PATCH/assistant/session/{id}/linkmanage_assistantVincula a uma consulta
DELETE/assistant/session/{id}manage_assistantDescarta a sessão
GET/assistant-configmanage_assistant_configLista configurações
GET/assistant-config/{id}manage_assistant_configBusca configuração
POST/assistant-configmanage_assistant_configCria configuração
PATCH/assistant-config/{id}manage_assistant_configAtualiza configuração
PATCH/assistant-config/{id}/activatemanage_assistant_configAtiva configuração
PATCH/assistant-config/{id}/deactivatemanage_assistant_configDesativa configuração
DELETE/assistant-config/{id}manage_assistant_configRemove configuração
GET/assistant-agent-typemanage_assistant_configLista tipos de agente
GET/assistant-agent-type/{id}manage_assistant_configBusca tipo de agente
POST/assistant-agent-typemanage_assistant_configCria tipo de agente
PATCH/assistant-agent-type/{id}manage_assistant_configAtualiza tipo de agente
DELETE/assistant-agent-type/{id}manage_assistant_configRemove tipo de agente