Preajustes

​

Inicio rápido

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
	  -d '{
	    "model": "@release-summary",
	    "input": "Generate a release summary for the last 24 hours."
	  }'

import Phaseo from "@phaseo/sdk";

const client = new Phaseo({ apiKey: process.env.PHASEO_API_KEY! });

const response = await client.generateResponse({
	  model: "@release-summary",
	  input: "Generate a release summary for the last 24 hours.",
});

from phaseo import Phaseo

client = Phaseo(api_key="YOUR_API_KEY")

response = client.generate_response({
	    "model": "@release-summary",
	    "input": "Generate a release summary for the last 24 hours.",
})

​

Qué puede incluir un preajuste

• Un prompt de sistema que se antepone a cada solicitud.
• Modelos o familias de modelos permitidos.
• Listas de proveedores permitidos o ignorados para las preferencias de enrutamiento.
• Parámetros predeterminados (temperature, top_p, max_tokens y otros similares).
• Valores predeterminados de razonamiento opcionales para los modelos compatibles.

• Los preajustes privados y del espacio de trabajo usan @{slug} y se resuelven dentro del espacio de trabajo de la clave de API.
• Los preajustes públicos usan @{username}/{slug} y se pueden resolver desde cualquier espacio de trabajo. Por ejemplo, @octavia/release-summary.

​

Versiones y copias del marketplace

• Secuencial: v1, v2, v3.
• Versionado semántico: etiquetas SemVer explícitas, como 1.2.0, 2.0.0-beta.1 o 1.4.2+build.7.
• Por fecha: YYYY.MM.DD, con un sufijo numérico si se publican varias versiones el mismo día, como 2026.08.02.2.

​

Cómo se combinan los preajustes

• Los parámetros predeterminados solo rellenan los campos que faltan en el cuerpo de la solicitud; no sobrescriben los valores que ya proporcionó quien realiza la solicitud.
• Si la solicitud ya contiene un mensaje de sistema, el prompt del preajuste se antepone a este. Si la solicitud usa un campo system al estilo de Anthropic, el prompt se antepone allí.
• Las listas de proveedores permitidos e ignorados se aplican antes de seleccionar el proveedor, por lo que reducen el conjunto de alternativas en lugar de ser simples etiquetas decorativas.
• Las solicitudes que no estén dentro de la lista de modelos permitidos del preajuste se rechazan pronto, no se redirigen silenciosamente.

​

Funciones públicas disponibles

• inyección del prompt de sistema
• listas de modelos permitidos
• restricciones de enrutamiento con listas de proveedores permitidos o ignorados
• valores predeterminados de decodificación y generación
• valores predeterminados de razonamiento

​

Administrar preajustes

​

Cuándo usar preajustes

• Estandarizar prompts de sistema en varios servicios.
• Restringir el enrutamiento a proveedores aprobados para cumplir requisitos.
• Mantener parámetros predeterminados coherentes entre entornos.
• Dar a los proyectos de migración un lugar estable para guardar los valores predeterminados de prompts, enrutamiento y parámetros, mientras el código de la aplicación apenas cambia.

​

Guías relacionadas

• Recopilar comentarios sobre preajustes
• Enrutamiento y alternativas
• Parámetros de inferencia
• Matriz de paridad de funciones