Skip to main content

Visão Geral de Inteligência Artificial

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.


Base​

https://api-dev.imagemais.com.br/api/ai

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


Provedores e capacidades​

A conta pode usar a chave de API da plataforma (padrão) ou cadastrar a própria chave de um provedor. Cada capacidade pode apontar para um provedor diferente:

CapacidadeUsada em
TEXT_GENERATIONEstruturação de texto, extração de campos, chats e agentes
VISION_OCRLeitura de imagens e exames (OCR)
AUDIO_TRANSCRIPTIONTranscrição de áudio

Provedores disponíveis: OPENAI e GROK — hoje os dois atendem as três capacidades. Sem preferência salva, a capacidade usa OPENAI com a chave da plataforma.

  1. Salvar a chave do provedor (armazenada criptografada; as respostas nunca devolvem a chave).
  2. Testar a conexão com a chave salva.
  3. Definir o provedor de cada capacidade.
  4. Conferir o estado em Buscar Configuração de IA.

Remover a chave de um provedor também remove as capacidades que apontavam para ele; Resetar o Provedor volta uma capacidade ao padrão.


Utilitários​

RotaEntradaSaída
Transcrever ÁudioArquivo de áudio (mp3, wav, webm, m4a, ogg, aac)Texto transcrito
Transcrever ImagemImagemTexto extraído
Gerar Avaliação em JSONTexto + instruçõesJSON estruturado
Corrigir Campo por VozConteúdo atual do campo + transcrição de um comando de vozTexto corrigido ou preenchido
Transcrição de áudio

O texto transcrito passa por uma normalização que remove acentos. Considere isso ao exibir ou comparar o resultado.


Apoio à decisão clínica​

Usadas na decisão da triagem, a partir do caso descrito em texto:

Apoio, não decisão

As sugestões não são gravadas na triagem. Quem registra a hipótese e o desfecho é o médico, em Registrar Desfecho — o campo diagnosisSelection[].fromAi indica quais hipóteses vieram da sugestão.


Chat da consulta​

Um chat com o agente consultation-chat, que conhece os dados da consulta:

  1. Buscar ou Criar Conversa — devolve o histórico; cria a conversa na primeira chamada.
  2. Enviar Mensagem — devolve o histórico atualizado com a resposta do agente.
  3. Deletar Conversa — apaga a conversa e permite começar outra.

As rotas /thread são a versão legada do mesmo chat e devem ser substituídas pelas de /conversation.


Rotas​

MétodoRotaPermissãoDescrição
GET/ai/settingsread_configurationsProvedores e capacidades
POST/ai/settings/credentialsread_configurationsSalva a chave de um provedor
POST/ai/settings/credentials/{provider}/testread_configurationsTesta a chave
DELETE/ai/settings/credentials/{provider}read_configurationsRemove a chave
PUT/ai/settings/capabilities/{capability}read_configurationsDefine o provedor da capacidade
DELETE/ai/settings/capabilities/{capability}read_configurationsVolta ao padrão
POST/ai/transcription—Transcreve áudio
POST/ai/vision—Lê imagem
POST/ai/evaluation—Estrutura texto em JSON
POST/ai/correct-field—Corrige campo por voz
POST/ai/diagnosis/evaluate—Hipóteses diagnósticas
POST/ai/outcome/suggest—Sugestão de desfecho
GET/ai/consultation/{consultationId}/conversation—Busca ou cria a conversa
POST/ai/consultation/{consultationId}/conversation/message—Envia mensagem
DELETE/ai/consultation/{consultationId}/conversation—Deleta a conversa
GET/ai/consultation/{consultationId}/thread—Legado
POST/ai/consultation/{consultationId}/thread/message—Legado
DELETE/ai/consultation/{consultationId}/thread—Legado

"—" na coluna de permissão: a rota não exige permissão específica, apenas autenticação.