Prompt padrão do usuário

Repetir as mesmas instruções à IA em toda conversa — "responda em português formal", "cite a base legal", "seja conciso" — é trabalho manual que não deveria existir. Com o prompt padrão do usuário, as preferências de cada pessoa são escritas uma única vez, no cadastro dela, e a plataforma passa a aplicá-las automaticamente em todas as interações dessa pessoa com a IA, no chat e no copilot.

Diferente do prompt de domínio (de sistema), definido por administradores e válido para todos os usuários de um contexto, o prompt padrão é individual: cada usuário cadastrado tem o seu.

Onde fica

O prompt é um dado do cadastro do usuário, administrado em Sistema›Segurança›Usuários por quem tem a permissão de editar dados cadastrais (USERS_EDIT):

• No cadastro: o dialog Novo Usuário tem o campo opcional Prompt padrão do usuário. Ele é gravado logo depois de a conta ser criada; se essa etapa falhar, o usuário continua criado e a tela avisa "Usuário criado, mas o prompt padrão não pôde ser salvo. Ajuste na edição."
• No detalhe: ao abrir um usuário, a seção Prompt padrão do usuário mostra o texto atual, o contador de caracteres (limite de 8.000) e o botão Salvar prompt. Deixar em branco e salvar remove o prompt.

Até setembro de 2026 existia a tela Meu Prompt no grupo Segurança, de autoatendimento. Ela foi retirada: gravava com um nome de campo diferente do que o servidor lia — o campo abria vazio e salvar apagava o texto — e criava um segundo lugar para o mesmo dado. O dado continua o mesmo; mudou quem o administra e onde.

Exemplo prático — padronizar o estilo das respostas de um analista

1. Abra Sistema›Segurança›Usuários e selecione o analista.
2. Na seção Prompt padrão do usuário, escreva, por exemplo:

   Responda sempre em portugues formal.
   Cite a base legal de cada afirmacao (artigo e lei).
   Liste sempre os numeros de processo mencionados.
   Seja conciso: prefira listas a paragrafos longos.

1. Clique em Salvar prompt. O aviso "Prompt padrão salvo." confirma.
2. Da próxima mensagem em diante, as conversas desse usuário no Chat já vêm no formato pedido — formal, com base legal citada e os números de processo em lista — sem repetir nenhuma instrução na pergunta.

Recomendação de segurança: não inclua dados sensíveis no prompt. O texto é adicionado ao contexto enviado ao provedor de IA.

Como as instruções são aplicadas

• Anexadas, nunca substituindo: a cada mensagem, a plataforma monta o prompt de domínio e, em paralelo, busca o prompt padrão do usuário logado. Se ele não estiver vazio, é acrescentado ao final, entre marcadores claros:

  <prompt de domínio>

  === INSTRUCOES PERSONALIZADAS DO USUARIO ===
  <prompt padrão do usuário>
  === FIM DAS INSTRUCOES DO USUARIO ===

Quando há uma persona ativa na conversa (ver o guia da Busca), o bloco da persona entra ANTES das instruções do usuário. As regras do sistema continuam valendo — instruções pessoais que conflitem com elas podem não prevalecer.

• Sempre a versão mais recente: o prompt é lido a cada conversa. Salvou, valeu — da próxima mensagem em diante.
• A conversa nunca falha por causa do prompt: a leitura é best-effort, com tempo limite de 5 segundos. Se as instruções não puderem ser carregadas a tempo, a conversa segue normalmente sem elas, sem aviso na tela.

Uso por integração

Dois caminhos gravam o mesmo dado:

Os dois estão descritos na referência de API.

O corpo da gravação é {"customPrompt": "..."}; string vazia apaga o prompt e corpo sem o campo é recusado com 400. O texto é aparado antes de gravar e, acima de 8.000 caracteres, é recusado com 400 e a contagem na mensagem — nunca truncado em silêncio. Gravar para um e-mail que não está no cadastro de identidades responde 404. A leitura pelo caminho me devolve texto vazio quando não há prompt, nunca um erro técnico.

Como operar (administrador)

• O texto fica na propriedade customPrompt do nó :UsuarioSistema, no banco de sistema de usuários (o mesmo banco datta do cadastro de identidades). Para inspecionar pelo console:

  MATCH (u:UsuarioSistema {email: 'usuario@exemplo.com'})
  RETURN u.customPrompt AS prompt

• O nó nasce por MERGE pelo e-mail, tanto na replicação do cadastro quanto na gravação do prompt — gravar o prompt logo após criar a conta funciona mesmo que a replicação ainda não tenha chegado, e a replicação nunca sobrescreve o prompt. A unicidade de UsuarioSistema.email é garantida por constraint aplicada no startup do serviço de usuários (idempotente) e registrada nos scripts de índices do Neo4j.
• O cadastro de usuários é mantido em cache de duas camadas; ao salvar o prompt, esse cache é invalidado por inteiro.
• Auditoria: toda gravação gera o evento USER.PROMPT_UPDATED com ator, alvo, origem (admin pelo cadastro, self pelo caminho me), tamanho do texto e se apagou — sem o texto, que pode conter o que a pessoa quis escrever.
• Observabilidade: a chamada entre os módulos e a leitura/gravação no grafo aparecem como spans correlacionados pelo mesmo trace_id.

Limites e expectativas

• Tamanho: limite de 8.000 caracteres, recusado acima disso.
• Escopo: o prompt vale para o usuário, em todos os contextos e workspaces — não há um prompt por contexto.
• Precedência: o prompt é anexado, nunca substitui o prompt de domínio; a persona da conversa, quando há, vem antes dele.
• Degradação silenciosa: em latência alta, a conversa ocorre sem as instruções e sem aviso ao usuário.

Páginas relacionadas: guia da busca e do chat, usuários (guia do administrador), modelo de segurança.