Lección 2 de 2 · 7 minutos

Usa un preajuste

Guarda un modelo, un prompt y reglas de enrutamiento con un nombre y llámalo desde cualquier aplicación.

Un preajuste guarda el modelo, el prompt del sistema, los parámetros y las reglas de proveedor de una tarea con un nombre como @support-triage. Quien llama envía ese nombre como model y solo la entrada. Phaseo completa el resto antes de elegir un proveedor. Crea preajustes en Ajustes -> Preajustes, o con POST /v1/presets y una clave de administración.

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."
  }'

No hay un campo preset aparte. Indica una versión con @support-triage@v3, o sigue una etiqueta con @support-triage@production, para poder volver atrás moviendo la etiqueta.

Cuando la solicitud y el preajuste definen lo mismo, estas reglas deciden:

  • Los parámetros rellenan huecos. Los valores predeterminados de un preajuste solo se aplican a los campos que la solicitud no incluye. Un valor de la solicitud siempre gana.
  • Los prompts del sistema se acumulan. Primero va el prompt del preajuste y después el de la solicitud.
  • Los ajustes de proveedor de la solicitud ganan. provider.order o provider.max_price en la solicitud sustituyen el valor del preajuste para ese campo.
  • Las listas de permitidos restringen, nunca amplían. Un modelo que no está entre los modelos permitidos del preajuste falla con validation_error; no se redirige.

Comprueba lo que has aprendido

Tu preajuste fija temperature en 0.2. Una solicitud envía "model": "@support-triage" con "temperature": 0.8. ¿Qué valor se usa?

Ponlo en práctica

Tres servicios llaman al mismo modelo de soporte con prompts y reglas de proveedor copiados y pegados. Un cambio en el prompt llegó a un servicio pero no a los demás, y ahora las respuestas son distintas. ¿Cómo evitas que vuelva a pasar?

Mostrar la respuesta

Pasa el modelo, el prompt del sistema y las reglas de proveedor compartidos a un único preajuste y haz que todos los servicios envíen "model": "@support-triage@production". Publica los cambios como versiones nuevas y mueve la etiqueta production para desplegarlos, o vuelve a moverla para volver atrás.

Idea clave

Guarda los ajustes compartidos en un preajuste, llámalo por su nombre en model y deja que los valores de la solicitud sustituyan los del preajuste cuando lo necesites.

Enlaces relacionados

El progreso se guarda en este navegador.

Revisado por última vez el 17 de noviembre de 2026