Modelos y proveedores

En cada ejecución, el SDK determina qué modelo y qué transporte usar. En la mayoría de las aplicaciones, conviene mantener una configuración sencilla. Elige los modelos de forma explícita, usa la integración estándar de OpenAI de manera predeterminada y cambia el proveedor o el transporte solo cuando el flujo de trabajo lo requiera.

Empieza por elegir el modelo de forma explícita

En producción, elige el modelo de forma explícita en lugar de depender del que use de forma predeterminada tu versión del SDK.

• Configura model en un agente cuando ese especialista necesite habitualmente un perfil distinto de calidad, latencia o costo.
• Define un modelo predeterminado para la ejecución cuando un flujo de trabajo deba sustituir el modelo de varios agentes a la vez.
• Configura OPENAI_DEFAULT_MODEL cuando quieras definir, para todo el proceso, qué modelo usarán los agentes que omitan model.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24import { Agent, Runner } from "@openai/agents";

const fastAgent = new Agent({
  name: "Fast support agent",
  instructions: "Handle routine support questions.",
  model: "gpt-5.6-terra",
});

const generalAgent = new Agent({
  name: "General support agent",
  instructions: "Handle support questions carefully.",
});

const runner = new Runner({
  model: "gpt-6-astra",
});

await runner.run(fastAgent, "Summarize ticket 123.");
const result = await runner.run(
  generalAgent,
  "Investigate the billing issue on account 456."
);

console.log(result.finalOutput);

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29import asyncio

from agents import Agent, RunConfig, Runner

fast_agent = Agent(
    name="Fast support agent",
    instructions="Handle routine support questions.",
    model="gpt-5.6-terra",
)

general_agent = Agent(
    name="General support agent",
    instructions="Handle support questions carefully.",
)


async def main() -> None:
    await Runner.run(fast_agent, "Summarize ticket 123.")

    result = await Runner.run(
        general_agent,
        "Investigate the billing issue on account 456.",
        run_config=RunConfig(model="gpt-6-astra"),
    )
    print(result.final_output)


if __name__ == "__main__":
    asyncio.run(main())

Para la mayoría de los flujos de trabajo nuevos que usan el SDK, empieza con gpt-6-astra y cambia a una variante más pequeña solo si la latencia o el costo lo justifican. Consulta las recomendaciones vigentes para toda la plataforma en la guía para elegir un modelo.

Elige la estrategia más sencilla para definir los modelos predeterminados

Si para tu equipo es importante saber exactamente qué modelo se usará de forma predeterminada, defínelo tú en lugar de depender del modelo de respaldo del SDK.

Proveedores y transporte

Ten en cuenta estas dos diferencias:

• El transporte WebSocket de Responses sigue usando el ciclo habitual del agente para procesar texto y usar herramientas. Las sesiones de voz usan un mecanismo independiente.
• Las sesiones de audio en vivo por WebRTC o WebSocket permiten interacciones de baja latencia con voz o imágenes. Para trabajar con estas sesiones, consulta Agentes de voz y la guía de la API de audio en vivo.

La configuración específica de los proveedores, la gestión de su ciclo de vida y las API auxiliares de transporte dependen del lenguaje. Mantén esos detalles en la documentación del SDK para evitar duplicarlos aquí.

Configuración del modelo, prompts y funciones compatibles

La elección del modelo es solo una parte del contrato de ejecución.

• Usa modelSettings para ajustar el esfuerzo de razonamiento, el nivel de detalle de las respuestas y el comportamiento de las herramientas, entre otros parámetros.
• Usa prompt cuando quieras que una configuración de prompt guardada controle la ejecución, en lugar de incluir el prompt del sistema completo en el código.
• Algunas funciones del SDK dependen de la integración con Responses de OpenAI y no están disponibles a través de las interfaces de compatibilidad anteriores. Consulta la documentación del SDK cuando necesites funciones avanzadas de carga de herramientas o de transporte.

Define el contrato del modelo junto a la definición del agente cuando sea propio de ese especialista. Configúralo como valor predeterminado del flujo de trabajo solo cuando varios agentes deban usar la misma configuración en tiempo de ejecución.

Próximos pasos

Una vez que hayas definido el contrato de ejecución, continúa con la guía que corresponda al resto del diseño de tu flujo de trabajo.