Modelos e provedores

A cada execução, o SDK determina qual modelo e qual transporte usar. Na maioria dos aplicativos, mantenha essa configuração simples. Escolha os modelos explicitamente, use a integração padrão com a OpenAI e só altere o provedor ou o transporte quando o fluxo de trabalho exigir.

Comece escolhendo o modelo explicitamente

Em produção, prefira escolher o modelo explicitamente a depender do modelo que sua versão do SDK usa por padrão.

• Defina model no agente quando esse especialista precisar regularmente de um perfil diferente de qualidade, latência ou custo.
• Defina um modelo padrão para a execução quando um fluxo de trabalho precisar alterar de uma só vez a escolha de modelo de vários agentes.
• Defina OPENAI_DEFAULT_MODEL quando quiser que os agentes de um mesmo processo usem um modelo padrão caso omitam 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 a maioria dos novos fluxos de trabalho com o SDK, comece com gpt-6-astra e só passe para uma variante menor quando a latência ou o custo justificar a mudança. Consulte a página Guia de modelos para ver as recomendações atuais de seleção de modelos para toda a plataforma.

Escolha a estratégia mais simples para definir o modelo padrão

Se a sua equipe precisa saber exatamente qual modelo será usado por padrão, defina esse modelo explicitamente em vez de depender do padrão do SDK.

Provedores e transporte

Observe duas diferenças importantes.

• O transporte WebSocket da API Responses continua usando o ciclo normal do agente, com texto e ferramentas. Esse ciclo é separado do fluxo das sessões de voz.
• As sessões de áudio em tempo real por WebRTC ou WebSocket servem para interações de baixa latência com voz ou imagens. Para esse tipo de interação, consulte Agentes de voz e o guia da API de áudio em tempo real.

Os detalhes de configuração do provedor, o gerenciamento do ciclo de vida do provedor e as APIs auxiliares de transporte variam conforme a linguagem. Mantenha esses detalhes na documentação do SDK para evitar duplicá-los aqui.

Configurações do modelo, prompts e suporte a recursos

A escolha do modelo é apenas parte do contrato de execução.

• Use modelSettings para ajustar o esforço de raciocínio, o nível de detalhamento das respostas e o comportamento das ferramentas.
• Use prompt quando quiser que uma configuração de prompt salva controle a execução, em vez de incluir o prompt de sistema completo no código.
• Alguns recursos do SDK dependem da integração com a API Responses da OpenAI em vez das interfaces de compatibilidade mais antigas. Consulte a documentação do SDK quando precisar de recursos avançados de carregamento de ferramentas ou de transporte.

Mantenha o contrato do modelo junto à definição do agente quando ele fizer parte da configuração própria desse especialista. Defina esse contrato como padrão para o fluxo de trabalho somente quando um grupo de agentes precisar usar a mesma configuração em tempo de execução.

Próximos passos

Depois de definir o contrato de execução, consulte o guia que melhor se aplica ao restante do seu fluxo de trabalho.