Implantar predefinições e depurar o roteamento

​

Objetivo

• Padronizar os padrões de prompts e parâmetros.
• Limitar quais provedores podem ser usados em um rollout ou limite de conformidade.
• Manter contexto suficiente da solicitação para explicar por que ela foi roteada daquela forma.

​

1. Crie a predefinição

• um nome e slug claros
• um prompt de sistema
• modelos aprovados
• preferências de provedores
• valores padrão de parâmetros, como temperature

​

2. Mantenha o corpo da solicitação enxuto

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-5",
    "input": "Generate a release summary for the last 24 hours.",
    "preset": "release-summary"
  }'

import Phaseo from "@phaseo/sdk";

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

const response = await client.generateResponse({
  model: "anthropic/claude-sonnet-4-5",
  input: "Generate a release summary for the last 24 hours.",
  preset: "release-summary",
});

console.log(response.output_text);

from phaseo import Phaseo

client = Phaseo(api_key="YOUR_API_KEY")

response = client.generate_response(
    {
        "model": "anthropic/claude-sonnet-4-5",
        "input": "Generate a release summary for the last 24 hours.",
        "preset": "release-summary",
    }
)

print(response.get("output_text"))

​

3. Entenda o que a predefinição altera

• parâmetros ausentes na solicitação são preenchidos pela predefinição
• o prompt da predefinição é adicionado antes da camada de sistema
• as preferências de provedor reduzem a lista de provedores disponíveis antes da classificação
• restrições de modelo são verificadas antecipadamente, em vez de redirecionar silenciosamente

​

4. Depure o resultado do roteamento

• provedores considerados
• candidatos classificados
• fatores de roteamento associados a cada candidato
• bloqueios por política do workspace ou proteções

• por que um provedor foi ignorado
• por que uma solicitação foi bloqueada
• por que um destino de menor custo ou latência ficou em primeiro lugar

​

5. Padrão operacional

1. Crie um novo slug de predefinição para a nova política.
2. Migre um chamador de baixo risco para a nova predefinição.
3. Inspecione os detalhes das solicitações e as tendências de atividade.
4. Amplie o rollout somente depois que os resultados de roteamento corresponderem às expectativas.

​

Guias relacionados

• Predefinições
• Roteamento e fallback
• Tratamento de erros