Fijar o excluir proveedores por solicitud

Usa esta receta cuando quieras que una solicitud prefiera una ruta de proveedor específica sin cambiar los valores predeterminados de enrutamiento de todo el espacio de trabajo.

Objetivo

Prueba los proveedores en el orden preferido.
Limita una solicitud a un subconjunto de proveedores aprobados.
Ignora temporalmente un proveedor sin editar los presets.

1. Prueba los proveedores en un orden específico

Usa provider.order cuando ya conozcas el orden de rutas que prefieres.

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-opus-4.6",
    "input": "Write a concise launch summary.",
    "provider": {
      "order": ["anthropic-us", "anthropic"]
    }
  }'

import Phaseo from "@phaseo/sdk";

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

const response = await client.generateResponse({
  model: "anthropic/claude-opus-4.6",
  input: "Write a concise launch summary.",
  provider: {
    order: ["anthropic-us", "anthropic"],
  },
});

console.log(response.output_text);

from phaseo import Phaseo

client = Phaseo(api_key="YOUR_API_KEY")

response = client.generate_response(
    {
        "model": "anthropic/claude-opus-4.6",
        "input": "Write a concise launch summary.",
        "provider": {
            "order": ["anthropic-us", "anthropic"],
        },
    }
)

print(response.get("output_text"))

Esto coloca a los proveedores indicados al principio del orden de candidatos, antes que el resto de los proveedores disponibles.

2. Limita la solicitud a un subconjunto fijo de proveedores

Usa provider.only cuando la solicitud deba limitarse a una lista de permitidos pequeña.

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.4-nano",
    "input": "Extract the action items.",
    "provider": {
      "only": ["openai", "openai-eu"],
      "sort": "price"
    }
  }'

import Phaseo from "@phaseo/sdk";

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

const response = await client.generateResponse({
  model: "openai/gpt-5.4-nano",
  input: "Extract the action items.",
  provider: {
    only: ["openai", "openai-eu"],
    sort: "price",
  },
});

console.log(response.output_text);

from phaseo import Phaseo

client = Phaseo(api_key="YOUR_API_KEY")

response = client.generate_response(
    {
        "model": "openai/gpt-5.4-nano",
        "input": "Extract the action items.",
        "provider": {
            "only": ["openai", "openai-eu"],
            "sort": "price",
        },
    }
)

print(response.get("output_text"))

Esto limita la solicitud a esos proveedores y después aplica el método de clasificación elegido dentro del subconjunto.

3. Excluye un proveedor de la selección

Usa provider.ignore para omitir un proveedor en una solicitud o durante un despliegue temporal.

curl https://api.phaseo.app/v1/responses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "meta/llama-4-maverick",
    "input": "Summarize the transcript.",
    "provider": {
      "ignore": ["deepinfra"]
    }
  }'

import Phaseo from "@phaseo/sdk";

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

const response = await client.generateResponse({
  model: "meta/llama-4-maverick",
  input: "Summarize the transcript.",
  provider: {
    ignore: ["deepinfra"],
  },
});

console.log(response.output_text);

from phaseo import Phaseo

client = Phaseo(api_key="YOUR_API_KEY")

response = client.generate_response(
    {
        "model": "meta/llama-4-maverick",
        "input": "Summarize the transcript.",
        "provider": {
            "ignore": ["deepinfra"],
        },
    }
)

print(response.get("output_text"))

Esto resulta útil cuando:

un proveedor tiene problemas
estás validando otra ruta de proveedor
quieres comparar los resultados del enrutamiento sin editar un preset

4. Combina los controles con cuidado

Puedes combinar estos controles, pero mantén clara la intención:

usa order para indicar una preferencia
usa only para limitar el conjunto de candidatos
usa ignore para excluir un proveedor

Un patrón práctico combina:

only para limitar la solicitud a google-vertex y google-vertex-eu
order para priorizar google-vertex-eu
sort: "latency" para ordenar ese conjunto permitido

5. Cuándo trasladarlo a un preset

Si las mismas reglas de proveedor aparecen en varios servicios, deja de copiarlas en cada solicitud y pásalas a un preset. Usa el enrutamiento por solicitud cuando la excepción sea:

temporal
específica del solicitante
vinculada a un flujo de usuario

Guías relacionadas

Última modificación el 2 de octubre de 2026

Empieza aquí

Crear aplicaciones

Enrutamiento y políticas

Búsqueda y datos estructurados

Inicio rápido del SDK de agentes

Flujos avanzados de agentes

Fijar o excluir proveedores por solicitud

Objetivo

1. Prueba los proveedores en un orden específico

2. Limita la solicitud a un subconjunto fijo de proveedores

3. Excluye un proveedor de la selección

4. Combina los controles con cuidado

5. Cuándo trasladarlo a un preset

Guías relacionadas

​Objetivo

​1. Prueba los proveedores en un orden específico

​2. Limita la solicitud a un subconjunto fijo de proveedores

​3. Excluye un proveedor de la selección

​4. Combina los controles con cuidado

​5. Cuándo trasladarlo a un preset

​Guías relacionadas

Objetivo

1. Prueba los proveedores en un orden específico

2. Limita la solicitud a un subconjunto fijo de proveedores

3. Excluye un proveedor de la selección

4. Combina los controles con cuidado

5. Cuándo trasladarlo a un preset

Guías relacionadas