Lição 2 de 2 · 7 minutos

Use uma predefinição

Salve um modelo, um prompt e regras de roteamento sob um nome e chame-o de qualquer app.

Uma predefinição guarda o modelo, o prompt de sistema, os parâmetros e as regras de provedor de uma tarefa sob um nome como @support-triage. Quem chama envia esse nome como model e só a entrada. O Phaseo completa o resto antes de escolher um provedor. Crie predefinições em Configurações -> Predefinições ou com POST /v1/presets e uma chave de gerenciamento.

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "@support-triage",
    "input": "Customer says the invoice total is wrong."
  }'

Não existe um campo preset separado. Indique uma versão com @support-triage@v3 ou siga um rótulo com @support-triage@production, para poder voltar atrás movendo o rótulo.

Quando a solicitação e a predefinição definem a mesma coisa, estas regras decidem:

  • Os parâmetros preenchem lacunas. Os padrões da predefinição só valem para os campos que a solicitação não envia. Um valor na solicitação sempre prevalece.
  • Os prompts de sistema se somam. O prompt da predefinição vem primeiro, depois o da própria solicitação.
  • As configurações de provedor da solicitação prevalecem. provider.order ou provider.max_price na solicitação substitui o valor da predefinição para esse campo.
  • As listas de permissão restringem, nunca ampliam. Um modelo fora dos modelos permitidos pela predefinição falha com validation_error; ele não é redirecionado.

Confira o que você aprendeu

A sua predefinição define temperature como 0.2. Uma solicitação envia "model": "@support-triage" com "temperature": 0.8. Qual valor é usado?

Aplique

Três serviços chamam o mesmo modelo de suporte com prompts e regras de provedor copiados e colados. Uma mudança de prompt foi para um serviço, mas não para os outros, e agora as respostas são diferentes. Como você evita que isso aconteça de novo?

Mostrar a resposta

Mova o modelo, o prompt de sistema e as regras de provedor compartilhados para uma única predefinição e faça todos os serviços enviarem "model": "@support-triage@production". Publique as mudanças como novas versões e mova o rótulo production para lançá-las, ou mova-o de volta para desfazer.

Resumo

Coloque as configurações compartilhadas em uma predefinição, chame-a pelo nome em model e deixe os valores da solicitação substituírem os padrões da predefinição quando precisar.

Links relacionados

O progresso fica salvo neste navegador.

Verificado em 17 de novembro de 2026