openai/swarm

어떤 프로젝트인가요?

핵심 기능

• 01Agent 객체는 지침과 모델이 호출할 수 있는 Python 함수를 함께 묶습니다.
• 02핸드오프를 사용하면 한 에이전트가 대화를 다른 에이전트에 넘길 수 있습니다.
• 03컨텍스트 변수는 함수와 동적 지침에 전달됩니다.
• 04서버 측 상태 없이 Chat Completions API를 기반으로 동작합니다.
• 05스트리밍 응답과 명령줄 데모 루프를 지원합니다.

활용 사례

• 멀티 에이전트 핸드오프와 도구 호출이 실제로 어떻게 동작하는지 학습합니다.
• 요청을 전문 에이전트에 라우팅하는 분류 흐름을 프로토타이핑합니다.
• 작업별로 에이전트를 분리한 고객 서비스 데모를 만듭니다.

빠른 시작

1. 1

   pip를 사용해 GitHub에서 Swarm을 설치합니다(Python 3.10 이상 필요).

   pip install git+https://github.com/openai/swarm.git
2. 2

   README의 사용 예시처럼 Swarm 클라이언트를 만들고 에이전트와 함수를 정의한 다음 client.run()을 호출합니다.

사용 전 알아둘 점

• !Swarm은 실험 및 교육용이며 프로덕션에서 사용하도록 설계되지 않았습니다.
• !README에 따르면 Swarm은 OpenAI Agents SDK로 대체되었으며, 프로덕션에는 이 SDK를 권장합니다.
• !Swarm은 Chat Completions API를 기반으로 하며 호출 간 상태를 유지하지 않으므로 대화 기록을 직접 관리해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

swarm은(는) 무엇인가요?

Chat Completions API를 기반으로 Agent와 핸드오프를 활용해 여러 에이전트를 가볍게 오케스트레이션하는 실험적·교육용 Python 프레임워크입니다. Swarm은 여러 LLM 에이전트를 조율하기 위한 Python 프레임워크입니다. 핵심 프리미티브는 두 가지입니다. 지침과 호출 가능한 함수를 묶는 Agent, 그리고 한 에이전트가 대화를 다른 에이전트에 넘기도록 하는 핸드오프입니다. 클라이언트의 run() 메서드는 새 함수 호출이 더 이상 없을 때까지 모델 응답 생성, 도구 실행, 에이전트 전환을 반복한 뒤 업데이트된 메시지, 활성 에이전트, 컨텍스트 변수를 반환합니다.

swarm은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

swarm은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

swarm은(는) 아직 유지보수되고 있나요?

6개월 이상 커밋 없음. swarm의 마지막 커밋은 2026년 4월 15일입니다.

swarm은(는) 어디에 사용할 수 있나요?

멀티 에이전트 핸드오프와 도구 호출이 실제로 어떻게 동작하는지 학습합니다. 요청을 전문 에이전트에 라우팅하는 분류 흐름을 프로토타이핑합니다. 작업별로 에이전트를 분리한 고객 서비스 데모를 만듭니다.

swarm는 어떻게 설치하나요?

pip를 사용해 GitHub에서 Swarm을 설치합니다(Python 3.10 이상 필요).: pip install git+https://github.com/openai/swarm.git README의 사용 예시처럼 Swarm 클라이언트를 만들고 에이전트와 함수를 정의한 다음 client.run()을 호출합니다.

swarm은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/openai/swarm