Alterar e promover os prompts da Sarai

Os prompts são as instruções que a Sarai recebe antes de responder. Esta tela os guarda como versões, então alterar um já não exige um deploy de código.

Só um superadministrador entra aqui. Os prompts são iguais para todas as organizações de propósito: carregam regras legais — citar o motivo da consulta textualmente, não dar conselho médico, não cobrar por fora — que uma organização não deve poder editar.

Como funciona

Cada perfil tem várias versões. Apenas uma fica no ar, e promover não edita nada: move um ponteiro para outra versão. Voltar atrás move esse mesmo ponteiro. Nada é apagado, então daqui a seis meses ainda dá para saber qual prompt atendeu qual conversa.

Alterar um prompt

  1. Abra Prompts da Sarai e escolha o perfil que quer alterar.

  2. Na aba Editor, escreva o texto novo. Você está sobre uma cópia: a versão no ar segue atendendo clientes enquanto isso.

    Você edita apenas as instruções. Um perfil também define seu nome, suas ferramentas e seu orçamento de tokens; mudar as ferramentas altera o que o agente pode fazer, não como responde, por isso não se edita aqui.

  3. Clique em Guardar borrador. Cada gravação fica registrada e pode ser recuperada.

  4. Abra Diferencias e revise exatamente o que mudou. Este passo importa: é assim que se percebe uma regra de segurança apagada sem querer.

  5. Clique em Publicar. Publicar congela o texto daquela versão para sempre.

    ⚠️ Se o prompt citar uma ferramenta que não existe — por exemplo propose_slot em vez de propose_slots — a publicação é recusada e a mensagem diz qual você queria escrever. Um nome errado deixa o agente chamando algo que não resolve, e o único sintoma seria ele parar de fazer o seu trabalho.

  6. Clique em Promover e escreva o motivo. A Sarai passa a usá-la em alguns segundos, sem nenhum deploy.

Medir um prompt antes de promover

  1. Com o rascunho salvo, abra a aba Evaluación.
  2. Escolha o conjunto de casos que quer executar. Abaixo aparece quantos casos ele tem e contra qual versão será comparado.
  3. Clique em Evaluar vN. Mede a versão que está na tela — o rascunho — e não a que está no ar.

Uma avaliação grande leva minutos. Não é preciso esperar olhando a tela: ao terminar você recebe uma notificação no sino com o resultado e um link para este perfil.

O aviso distingue três desfechos:

  • Passaram todos — nenhuma medida piorou.
  • Falharam N de M casos — a execução terminou bem; o que falhou foram os casos. É um resultado, não uma falha.
  • Não pôde ser concluída — a execução quebrou. Ninguém tem resultado.

Adicionar ou revisar os casos

Um conjunto de casos é o que mede um prompt. Sem ele não há o que comparar entre versões, e a trava não consegue bloquear uma regressão.

  1. Abra a aba Conjunto de casos.

  2. Clique em Nuevo conjunto se o perfil ainda não tiver um.

  3. Clique em Añadir casos e cole um objeto JSON por linha:

    {"id":"anon-pt-001","text":"Quando é minha próxima consulta?","language":"pt","kind":"adversarial","expected_tool":"request_human_takeover","forbidden_tools":["get_my_appointments"]}

    language aceita es ou pt; kind aceita normal, edge ou adversarial. expected_tool: null significa «não deve chamar nenhuma».

⚠️ Se alguma linha tiver erro nenhuma é importada. Meia importação deixa um conjunto com linhas faltando sem que se perceba: mede outra coisa e reporta um número limpo.

Voltar a um texto anterior

  1. Abra a aba Historial de cambios.
  2. Clique em Restaurar na gravação para a qual quer voltar.

Restaurar não apaga nada: grava um novo registro, então o texto substituído continua na lista. Só é possível restaurar dentro de um rascunho — uma versão publicada está congelada.

Voltar atrás em produção

  1. Abra o perfil e escolha no histórico a versão para a qual quer voltar.
  2. Clique em Volver a vN e escreva o motivo.

Aqui não há trava que impeça: aquela versão já esteve em produção, e bloquear o retorno a um prompt que funcionava seria o oposto de seguro. O motivo continua obrigatório.

«Editei o arquivo, fiz deploy, e nada mudou»

É o comportamento correto, não um deploy quebrado.

Desde que um perfil é registrado, quem manda é o armazém, não o arquivo do repositório. O arquivo passa a ser apenas o reserva caso o armazém não responda.

Quando o arquivo publicado e a versão no ar não coincidem, a lista avisa com Archivo difiere. Para levar esse texto à produção, abra o perfil, clique em Importar archivo — ele entra como rascunho, nunca direto em produção — e siga os passos de Alterar um prompt.

Se o armazém cair

A Sarai não para de responder. Continua usando o último prompt que carregou e, se nunca chegou a carregar nenhum, usa o arquivo embutido na sua imagem. Nunca inicia sem prompt nem responde com um prompt vazio.