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.orderouprovider.max_pricena 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 respostaOcultar 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
model e deixe os valores da solicitação substituírem os padrões da predefinição quando precisar.Links relacionados
Verificado em 17 de novembro de 2026