IA para evoluções
Transforme tópicos soltos da sessão em um rascunho de evolução clínica, sempre marcado para revisão antes de assinar.
Funcionalidade nova
Este recurso faz parte das funcionalidades de mercado recém-lançadas.
O assistente de IA transforma suas anotações soltas da sessão em um rascunho de evolução, preenchendo as seções do modelo da nota. O conteúdo é sempre marcado como gerado por IA e deve ser revisado por você antes de assinar.
Pré-requisitos
- Chave de um provedor homologado: o deploy precisa ter a chave de
qualquer provedor da tabela —
ANTHROPIC_API_KEY,GOOGLE_AI_API_KEY,OPENAI_API_KEY,XAI_API_KEY,DEEPSEEK_API_KEY,MISTRAL_API_KEY,GROQ_API_KEYouOPENROUTER_API_KEY. Não é mais só a da Anthropic: sem a variávelAI_PROVIDERdefinida, o sistema usa a primeira chave que encontrar, na ordem Anthropic, Google, OpenAI. Para fixar um provedor, definaAI_PROVIDER(e, opcionalmente,AI_MODEL). - Em produção, sem chave nenhuma o recurso não aparece. O painel de IA
fica escondido e a geração é recusada com "Assistente de IA não
configurado", em vez de devolver texto de exemplo. O gerador de exemplo
(prefixo "[RASCUNHO MOCK]") só entra em desenvolvimento, ou quando alguém
pede explicitamente com
AI_PROVIDER=mock. - Plano com créditos de IA: o plano da clínica precisa ter créditos mensais
de IA (
aiMonthlyCreditsdiferente de 0;-1= ilimitado). O padrão é 0, e o valor só é ajustado no painel superadmin do plano. Com 0 créditos, o painel de IA não aparece mesmo com o recurso ligado. - Permissões: acessar a aba de configurações exige a permissão de gestão de
usuários (padrão do ADMIN). Gerar rascunhos exige a permissão Assistente de
IA (
ai_assist), que é WRITE por padrão para ADMIN e PROFESSIONAL. Ver o editor de evolução exige a permissão Prontuário.
Como usar
Para o administrador
Ativar o recurso na clínica:
- No menu lateral, clique em Configurações.
- Abra a aba IA.
- Marque Habilitar assistente de IA para evoluções.
- Leia o dialog Termos de uso do assistente de IA (uso pseudonimizado dos dados, o nome do provedor de IA que vai receber os trechos, LGPD, responsabilidade do profissional pelo registro) e clique em Aceitar e habilitar. Aparece o toast "Configurações de IA salvas" — o toggle salva sozinho, não há botão "Salvar" separado.
- Opcional: marque Incluir contexto histórico nas gerações para enviar resumos pseudonimizados das últimas 3 notas assinadas do paciente (desligado por padrão).
Desligar o recurso:
- Vá em Configurações → aba IA.
- Desmarque Habilitar assistente de IA para evoluções. O painel de IA deixa de aparecer para os profissionais (pode levar alguns segundos ou um recarregamento nos editores já abertos).
Para o profissional
Gerar um rascunho:
- Abra a ficha do paciente e vá na aba Prontuário; abra ou crie a evolução (nota) que quer preencher.
- No editor, expanda o painel Gerar com IA (o número ao lado indica os créditos restantes).
- No campo "Anote os pontos principais da sessão — tópicos soltos ou transcrição colada", digite ou cole seus tópicos.
- Opcional: escolha a Abordagem (TCC, Psicanálise, ABA, etc.) e marque Incluir contexto das últimas notas assinadas.
- Clique em Gerar rascunho. As seções são preenchidas e cada uma recebe a etiqueta "Gerado por IA — revise", e o aviso "Conteúdo gerado por IA — revise antes de assinar" aparece no topo.
- Revise e edite cada seção — ao editar, a etiqueta de IA daquela seção desaparece.
- Clique em Assinar (rodapé) e confirme em Assinar nota.
Não usar IA (opt-out):
- Abra Meu perfil.
- Na seção Privacidade, marque Não usar recursos de IA. O painel Gerar com IA deixa de aparecer para você e nenhum texto seu é enviado ao provedor.
Você é o responsável pela revisão
O sistema não impede assinar com seções de IA ainda não revisadas. O assistente produz um rascunho, não um registro pronto: revise e ajuste cada seção antes de assinar a nota.