Saltar al contenido principal
Un preajuste guarda el modelo, el prompt de sistema, los parámetros y las reglas de proveedor de una tarea con un nombre como @support-triage. Quien hace la llamada envía ese nombre como model y solo la entrada; el Gateway completa el resto antes de elegir un proveedor. Activa y desactiva los campos de la solicitud para ver qué valor prevalece: Las reglas son:
  • Los parámetros rellenan huecos. Los parámetros predeterminados de un preajuste solo se aplican a los campos que la solicitud omite. Un valor de la solicitud siempre prevalece.
  • Los prompts de sistema se acumulan. El prompt del preajuste va primero. Si la solicitud tiene su propio prompt de sistema o instructions, va a continuación, tras una línea en blanco.
  • Los ajustes de proveedor de la solicitud prevalecen. Campos como 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. Las listas de proveedores permitidos e ignorados del preajuste se aplican antes de seleccionar el proveedor, así que también limitan qué proveedores puede usar una alternativa. Un modelo que no está entre los modelos permitidos del preajuste falla con un validation_error cuya palabra clave de detalle es preset_model_not_allowed; no se redirige.

Crea y usa un preajuste

1

Crea el preajuste

Abre Panel -> Ajustes -> Presets y crea un preajuste con un slug como support-triage. Añade solo los valores predeterminados que deban compartir todos los que hacen llamadas.Para crearlo desde un script, llama a POST /v1/presets con una clave de administración.
2

Llámalo por su nombre

3

Comprueba qué se aplicó

Abre la solicitud en Gateway -> Uso para ver qué valores predeterminados del preajuste se aplicaron y qué proveedor la atendió.

Qué puede incluir un preajuste

Mantén la lógica específica de cada llamada en tu aplicación y usa preajustes distintos cuando los flujos de trabajo necesiten prompts, enrutamiento o almacenamiento en caché diferentes.

Nombra un preajuste

Envía un preajuste mediante el campo model, o mediante prompt.id cuando tiene una plantilla de prompt. No existe un campo preset independiente. Para publicar un preajuste público se necesitan un perfil público habilitado y un nombre de usuario. Los nombres de usuario son únicos en todo Phaseo; los slugs solo tienen que ser únicos para cada autor. Los slugs se convierten a minúsculas y pueden contener letras, números, -, _, . y :.

Versiona y revierte

Al guardar se edita un borrador privado. Publicar nueva versión convierte el borrador en una versión numerada e inmutable y conserva todas las anteriores. Elige el formato de las etiquetas de versión: Apunta una etiqueta con nombre, como production, a una versión, y devuélvela a una versión anterior para revertir. Consulta Versiones y etiquetas. Desde un script, publica con POST /v1/presets/{id}/versions y mueve etiquetas con PUT /v1/presets/{id}/labels/{label}, usando una clave de administración. Una sesión de la CLI o una app que usa Iniciar sesión con Phaseo puede leer los preajustes, pero no cambiarlos.

Bifurca un preajuste del marketplace

Una copia de un preajuste del marketplace queda fijada en la versión que copiaste. Cuando el autor publica una actualización, tu copia muestra un aviso. Aplicarla solo cambia tu borrador, así que nada llega a producción hasta que lo publiques tú. Phaseo registra el origen y la genealogía completa de cada bifurcación, de modo que una página del marketplace puede mostrar las bifurcaciones directas por separado de todos los descendientes. Para recopilar valoraciones de las respuestas de un preajuste, consulta Recopilar comentarios sobre preajustes.
Última modificación el 7 de noviembre de 2026