Prompt personalizado 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 personalizado, você escreve suas preferências uma única vez e a plataforma passa a aplicá-las automaticamente em todas as suas interações com a IA, no chat e no copilot. É pessoal, de autoatendimento e não exige nenhuma permissão de administrador.

Diferente do prompt de domínio (de sistema), definido por administradores e válido para todos os usuários de um contexto, o prompt personalizado é individual: cada pessoa controla apenas o próprio.

Como usar

1. No menu lateral, abra Sistema›Segurança›Meu Prompt.
2. No campo Instruções personalizadas, escreva o que a IA deve seguir nas suas interações. Exemplo: "Responda sempre em português formal, cite a base legal e seja conciso."
3. Acompanhe o contador de caracteres (limite de 8.000). Para apagar o conteúdo do campo, clique em Limpar.
4. Clique em Salvar. Um aviso confirma: "Prompt salvo. Será aplicado nas suas próximas interações."
5. Pronto — suas próximas conversas de chat e copilot já carregam essas instruções. Para desativar, deixe o campo em branco e salve.

Recomendação de segurança (exibida na própria tela): não inclua dados sensíveis no prompt. O texto é adicionado ao contexto enviado ao provedor de IA.

Exemplo prático — padronizar o estilo das respostas

1. Abra Sistema›Segurança›Meu Prompt.
2. 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 e volte ao Chat.
2. Pergunte algo como "a empresa Fusopar tem processos abertos?". A resposta já vem no formato que você pediu: formal, com base legal citada e os números de processo em lista — sem repetir nenhuma instrução na pergunta.

Como as instruções são aplicadas

• Anexadas, nunca substituindo: a cada mensagem, a plataforma monta o prompt de domínio (no modo pesquisa ou investigação) e, em paralelo, busca o seu prompt pessoal. Se ele não estiver vazio, é acrescentado ao final, entre marcadores claros:

  <prompt de domínio>

  === INSTRUCOES PERSONALIZADAS DO USUARIO ===
  <seu prompt>
  === FIM DAS INSTRUCOES DO USUARIO ===

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, nunca cacheado desse lado. Salvou, valeu — da próxima mensagem em diante.
• A conversa nunca falha por causa do prompt: a busca é best-effort, com tempo limite de 5 segundos. Se as instruções não puderem ser carregadas a tempo (ausência, erro ou indisponibilidade momentânea), a conversa segue normalmente sem elas, sem aviso na tela.
• Só você acessa o seu: a identificação vem exclusivamente da sua sessão autenticada — o usuário é resolvido pelo token (email → sub → preferred_username), nunca por um identificador informado na chamada. Não existe caminho para ler ou alterar o prompt de outra pessoa.

Uso por integração

O prompt pessoal também pode ser lido e gravado por integração programática: a plataforma expõe endpoints de leitura e gravação do prompt do usuário logado, identificado apenas pelo token de autenticação — nenhum identificador de usuário é aceito por caminho ou parâmetro. Veja os contratos na referência de API.

O corpo da gravação é opcional; ausência do texto equivale a string vazia. O conteúdo é aparado antes de gravar e truncado no limite de 8.000 caracteres — a requisição nunca é rejeitada por tamanho. Quando não há prompt definido (ou o token não pode ser resolvido), a leitura devolve texto vazio, nunca um erro técnico.

Quando algo falha, a resposta traz uma mensagem amigável em português no campo de erro do corpo — a tela lê esse campo e exibe um aviso vermelho, sem stack trace nem código HTTP bruto. Há dois casos distintos:

Quem pode usar

O prompt personalizado é um dado estritamente pessoal, e o modelo de autorização reflete isso:

• Qualquer pessoa autenticada pode ler e gravar o próprio prompt — não há exigência de perfil de administrador.
• A barreira de segurança real é a resolução do usuário pelo token: como nenhum identificador de usuário é aceito por parâmetro, é tecnicamente impossível ler ou gravar o prompt de outra pessoa.
• Na interface, o item Meu Prompt dentro de Sistema›Segurança é visível a todos os usuários logados. Em contraste, Usuários e Roles e Permissões, no mesmo subgrupo, continuam restritos a administradores — o subgrupo Segurança deixou de ser exclusivo de admin apenas para abrigar o Meu Prompt.

Como operar (administrador)

• Nenhuma configuração especial é necessária: a funcionalidade está disponível para todo usuário autenticado por padrão.
• O texto fica na propriedade customPrompt do node :UsuarioSistema, no banco de sistema de usuários. Para inspecionar pelo console:

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

• O cadastro de usuários é mantido em cache de duas camadas (memória local + cache compartilhado da plataforma, com validade de 24 horas). Ao salvar o prompt, esse cache é invalidado por inteiro, garantindo que as leituras seguintes já reflitam o novo valor.
• Como a leitura pelo chat é best-effort com tempo limite de 5 segundos, uma indisponibilidade momentânea não quebra a conversa — ela apenas roda sem as instruções pessoais.
• Auditoria: salvar o prompt pessoal é uma operação de autoatendimento de baixo risco e não gera evento de auditoria dedicado. Falhas de leitura e gravação ficam registradas em log estruturado (com o e-mail do usuário e a causa); falhas na busca durante a conversa são silenciosas, por desenho.
• Observabilidade: os passos envolvidos — a chamada entre os módulos e a leitura/gravação no grafo de usuários — aparecem como spans correlacionados pelo mesmo trace_id, com o contexto propagado desde o navegador. A tela de Meu Prompt também reporta atividade do usuário ao restante da aplicação, como todas as páginas da plataforma.

Limites e expectativas

• Tamanho: limite de 8.000 caracteres; textos maiores são truncados silenciosamente no salvamento (o contador na tela ajuda a não passar).
• Escopo: o prompt vale para o usuário, em todos os contextos e workspaces — não há (ainda) um prompt pessoal por contexto.
• Precedência: o prompt é anexado, nunca substitui o prompt de domínio.
• Degradação silenciosa: em latência alta, a conversa ocorre sem as instruções personalizadas e sem aviso ao usuário.

Páginas relacionadas: guia da busca e do chat, modelo de raciocínio do chat, modelo de segurança.