Visão Geral
As rotas de IA se dividem em quatro grupos: configuração de provedores da conta, utilitários (transcrição, leitura de imagem, estruturação de texto), apoio à decisão clínica (hipóteses diagnósticas e sugestão de desfecho) e chat da consulta. O comportamento de cada agente de IA (modelo, instruções, temperatura) é configurado à parte, em IA — Configuração de Agentes.
Buscar Configuração de IA
Retorna os provedores de IA configurados na conta (com a chave mascarada) e qual provedor atende cada capacidade.
Salvar Credencial de Provedor
Salva (ou substitui) a chave de API de um provedor de IA para a conta. A chave é armazenada criptografada.
Testar Credencial de Provedor
Faz uma chamada de teste ao provedor com a chave salva da conta e informa se a conexão funcionou.
Remover Credencial de Provedor
Remove a chave de um provedor. As capacidades que usavam esse provedor voltam ao padrão da plataforma.
Definir Provedor de uma Capacidade
Define qual provedor de IA (com chave salva na conta) atende uma capacidade, como transcrição ou chat.
Resetar Provedor de uma Capacidade
Volta a capacidade para o provedor padrão da plataforma.
Gerar Hipóteses Diagnósticas
Gera hipóteses diagnósticas (Assistente Diagnóstico). Executa o agente diagnosis-assistant com os dados clínicos informados e retorna o JSON de hipóteses.
Sugerir Desfecho da Triagem
Sugere o desfecho da triagem (Assistente de Desfecho). Executa o agente outcome-assistant com a hipótese diagnóstica escolhida e o caso da triagem, e retorna os desfechos resolutivos sugeridos (prescrição, exames, orientação, encaminhamento) com justificativa e sinais de alarme. Consulta não é sugerida: é decisão do médico.
Transcrever Áudio
Gera transcrição de um arquivo de áudio (mp3, wav, webm, m4a, ogg, aac)
Transcrever Imagem
Gera transcrição de uma imagem.
Gerar Avaliação em JSON
Cria avaliação com JSON. Processa texto e retorna JSON estruturado.
Corrigir Campo por Voz
Corrige ou preenche campo com base em transcrição de voz. Recebe o conteúdo atual do campo e a transcrição do áudio, retorna o texto corrigido/preenchido.
Buscar ou Criar Conversa da Consulta
Retorna ou cria a conversa de uma consulta. Inicializa o chat: retorna conversationId e histórico de mensagens. Cria a conversa se a consulta ainda não tiver uma. conversationId vazio significa consulta legada não migrada — o chat fica indisponível nela até a migração rodar.
Enviar Mensagem na Conversa
Envia a mensagem, executa o agente consultation-chat e retorna o histórico atualizado.
Deletar Conversa da Consulta
Deleta a conversa da consulta. Remove a conversa no OpenAI e limpa o openaiConversationId da consulta no banco.
Buscar ou Criar Thread (Legado)
Retorna ou cria thread de uma consulta. Use GET consultation/:consultationId/conversation.
Enviar Mensagem na Thread (Legado)
Envia mensagem para a thread da consulta. Use POST consultation/:consultationId/conversation/message.
Deletar Thread (Legado)
Deleta a thread da consulta. Use DELETE consultation/:consultationId/conversation.