모델과 제공자

SDK는 에이전트를 실행할 때마다 사용할 모델과 전송 방식을 결정합니다. 대부분의 애플리케이션에서는 설정을 간단하게 유지하세요. 모델을 명시적으로 지정하고 표준 OpenAI 경로를 기본으로 사용하세요. 제공자나 전송 방식은 워크플로우에 필요한 경우에만 별도로 지정하세요.

모델을 명시적으로 지정하기

프로덕션에서는 SDK 버전에 따라 달라질 수 있는 런타임 기본값에 의존하기보다 모델을 명시적으로 지정하세요.

• 특정 역할을 맡은 에이전트에 품질, 지연 시간 또는 비용 면에서 일관되게 다른 요건이 적용된다면 해당 에이전트에 model을 설정하세요.
• 한 워크플로우에서 여러 에이전트의 모델을 한꺼번에 바꾸려면 실행 단위 기본값을 설정하세요.
• OPENAI_DEFAULT_MODEL을 설정하면 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())

대부분의 새 SDK 워크플로우에서는 gpt-6-astra로 시작하세요. 지연 시간이나 비용을 줄이는 것이 충분히 중요할 때만 더 작은 베리언트로 전환하세요. 모델 선택에 관한 최신 권장 사항은 플랫폼 공통 모델 가이드를 참고하세요.

가장 간단한 기본값 설정 방식 선택하기

팀에서 어떤 모델을 기본값으로 사용할지 정확히 정해야 한다면 SDK 기본값에 의존하지 말고 직접 설정하세요.

제공자와 전송 방식

다음 두 가지를 구분하세요.

• Responses WebSocket 전송 방식도 텍스트와 도구를 사용하는 일반적인 에이전트 루프를 따릅니다. 음성 세션은 별도의 경로를 사용합니다.
• WebRTC 또는 WebSocket을 통한 실시간 오디오 세션은 지연 시간이 짧아야 하는 음성 또는 이미지 상호작용에 사용합니다. 이 경로를 사용하려면 음성 에이전트와 실시간 오디오 API 가이드를 참고하세요.

제공자의 세부 설정, 제공자 수명 주기 관리, 전송 헬퍼 API는 SDK 언어마다 다릅니다. 이러한 세부 사항은 각 언어의 SDK 문서에서 확인하세요.

모델 설정, 프롬프트 및 기능 지원

런타임 동작을 정할 때는 모델 선택 외에도 다음 사항을 고려하세요.

• modelSettings 설정으로 추론 강도, 응답의 상세도, 도구 동작 등을 조정하세요.
• 전체 시스템 프롬프트를 코드에 넣는 대신 저장된 프롬프트 설정으로 실행을 제어하려면 prompt를 사용하세요.
• 일부 SDK 기능은 기존 호환 인터페이스 대신 OpenAI Responses 경로를 사용해야 합니다. 고급 도구 로딩이나 전송 기능이 필요하면 SDK 문서를 확인하세요.

모델 설정이 특정 에이전트의 역할과 밀접하게 관련되어 있다면 에이전트 정의 가까이에 두세요. 여러 에이전트가 실행 시 같은 설정을 사용해야 할 때만 워크플로우 단위 기본값으로 옮기세요.

다음 단계

런타임 설정을 정했다면 워크플로우의 나머지 부분을 설계하는 데 필요한 가이드를 참고하세요.