Predefinições

​

Início 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.",
})

​

O que uma predefinição pode incluir

• Um prompt de sistema anexado ao início de cada solicitação.
• Modelos ou famílias de modelos permitidos.
• Listas de provedores permitidos ou ignorados para preferências de roteamento.
• Parâmetros padrão, como temperature, top_p, max_tokens e configurações semelhantes.
• Padrões opcionais de raciocínio para modelos compatíveis.

• Predefinições privadas e do espaço de trabalho usam @{slug} e são resolvidas no espaço de trabalho da chave de API.
• Predefinições públicas usam @{username}/{slug} e podem ser resolvidas em qualquer espaço de trabalho. Por exemplo, @octavia/release-summary.

​

Versões e cópias do marketplace

• Sequencial: v1, v2, v3.
• Versionamento semântico: rótulos SemVer explícitos, como 1.2.0, 2.0.0-beta.1 ou 1.4.2+build.7.
• Por data: YYYY.MM.DD, com um sufixo numérico quando várias versões são publicadas na mesma data, como 2026.08.02.2.

​

Como as predefinições são mescladas

• Parâmetros padrão preenchem somente campos ausentes no corpo da solicitação. Eles não substituem valores enviados pelo solicitante.
• Se a solicitação já tiver uma mensagem de sistema, o prompt da predefinição será acrescentado antes dela. Se houver um campo system no estilo Anthropic, o prompt será acrescentado nesse campo.
• As listas de provedores permitidos e ignorados são aplicadas antes da seleção, restringindo o conjunto de alternativas em vez de funcionar como rótulo decorativo.
• Solicitações fora da lista de modelos permitidos da predefinição são rejeitadas cedo, em vez de serem redirecionadas sem aviso.

​

Superfície pública atual das predefinições

• injeção de prompt de sistema
• listas de modelos permitidos
• restrições de roteamento com listas de provedores permitidos ou ignorados
• padrões de decodificação e geração
• padrões de raciocínio

​

Gerencie predefinições

​

Quando usar predefinições

• Padronizar prompts de sistema entre vários serviços.
• Restringir o roteamento a provedores aprovados para atender aos requisitos de conformidade.
• Manter parâmetros padrão consistentes entre ambientes.
• Oferecer aos projetos de migração um local duradouro para padrões de prompt, roteamento e parâmetros, mantendo o código do aplicativo praticamente igual.

​

Guias relacionados

• Colete feedback sobre predefinições
• Roteamento e alternativas
• Parâmetros de inferência
• Matriz de paridade de recursos