Repolode
제출하기
VRSEN

VRSEN/agency-swarm

명확한 역할을 맡은 AI 에이전트가 정의된 커뮤니케이션 흐름에 따라 서로 작업을 넘기는 멀티 에이전트 시스템 구축용 Python 프레임워크입니다.

GitHub에서 보기웹사이트
스타
4,629
포크
1,063
열린 이슈
9
마지막 커밋
6일 전

어떤 프로젝트인가요?

Agency Swarm은 실제 팀처럼 구성된 여러 AI 에이전트가 협력하는 애플리케이션을 만들기 위한 Python 프레임워크입니다. 에이전트마다 역할, 지침, 도구가 따로 있으며, 개발자는 어떤 에이전트가 누구에게 대화를 시작할 수 있는지 정의합니다. 이 프레임워크는 OpenAI Agents SDK를 기반으로 하며 그 위에 오케스트레이션 계층을 더합니다.

에이전트는 전용 send_message 도구로 소통하며, Agency에 설정하는 방향성 communication_flows로 서로 연락할 수 있는 대상을 정합니다. 도구는 @function_tool 데코레이터를 사용한 Python 함수, Pydantic 필드를 사용하는 BaseTool 하위 클래스, 또는 OpenAPI 스키마를 바탕으로 만들 수 있습니다. 대화 기록은 데이터베이스나 파일 저장소 등에 저장할 수 있도록 load 및 save 콜백을 통해 유지할 수 있습니다.

이 프로젝트는 Python 3.12 이상을 대상으로 하며 OpenAI 모델을 기본 지원합니다. Anthropic, Gemini, Azure OpenAI 같은 다른 제공업체 모델도 LiteLLM을 통해 사용할 수 있습니다. 에이전시를 실행하는 웹 데모와 터미널 인터페이스도 제공합니다.

핵심 기능

  • 01에이전트마다 고유한 지침, 도구, 모델 설정이 있는 역할을 정의합니다.
  • 02방향성 communication_flows로 에이전트 간 통신을 제한합니다.
  • 03Python 함수, BaseTool 클래스 또는 OpenAPI 스키마에서 타입 안전한 도구를 생성합니다.
  • 04load 및 save 콜백을 통해 대화 기록을 유지합니다.
  • 05웹 데모, 터미널 UI 또는 비동기 get_response API로 실행할 수 있습니다.

활용 사례

  • CEO 에이전트가 개발자 및 어시스턴트 에이전트에게 작업을 위임하는 등, 전문화된 에이전트 팀을 프로토타이핑합니다.
  • OpenAPI 스키마로 정의된 기존 API를 에이전트가 호출하는 사내 자동화를 구축합니다.
  • 세션이 바뀌어도 대화 상태를 저장해야 하는 멀티 에이전트 워크플로를 실행합니다.

빠른 시작

  1. 1

    pip으로 프레임워크를 설치합니다

    pip install -U agency-swarm
  2. 2

    OpenAI API 키를 .env 파일이나 셸에 설정합니다

    export OPENAI_API_KEY="YOUR_API_KEY"
  3. 3

    Agency Starter Template에서 시작하고 README에 따라 에이전트와 통신 흐름을 정의합니다

사용 전 알아둘 점

  • Python 3.12 이상이 필요합니다.
  • 에이전트를 실행하려면 OpenAI API 키 또는 지원되는 다른 모델 제공업체가 필요합니다.
  • v0.x에서 마이그레이션하려면 프로젝트를 새 SDK 기반 버전에 맞게 조정해야 합니다.

포함된 컬렉션

멀티 에이전트 오케스트레이션 프레임워크오픈소스 AI 에이전트 프레임워크와 앱

토픽

#multi-agent#llm#agents#python#openai#orchestration

자주 묻는 질문

agency-swarm은(는) 무엇인가요?
명확한 역할을 맡은 AI 에이전트가 정의된 커뮤니케이션 흐름에 따라 서로 작업을 넘기는 멀티 에이전트 시스템 구축용 Python 프레임워크입니다. Agency Swarm은 실제 팀처럼 구성된 여러 AI 에이전트가 협력하는 애플리케이션을 만들기 위한 Python 프레임워크입니다. 에이전트마다 역할, 지침, 도구가 따로 있으며, 개발자는 어떤 에이전트가 누구에게 대화를 시작할 수 있는지 정의합니다. 이 프레임워크는 OpenAI Agents SDK를 기반으로 하며 그 위에 오케스트레이션 계층을 더합니다.
agency-swarm은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
agency-swarm은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
agency-swarm은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. agency-swarm의 마지막 커밋은 2026년 11월 2일입니다.
agency-swarm은(는) 어디에 사용할 수 있나요?
CEO 에이전트가 개발자 및 어시스턴트 에이전트에게 작업을 위임하는 등, 전문화된 에이전트 팀을 프로토타이핑합니다. OpenAPI 스키마로 정의된 기존 API를 에이전트가 호출하는 사내 자동화를 구축합니다. 세션이 바뀌어도 대화 상태를 저장해야 하는 멀티 에이전트 워크플로를 실행합니다.
agency-swarm는 어떻게 설치하나요?
pip으로 프레임워크를 설치합니다: pip install -U agency-swarm OpenAI API 키를 .env 파일이나 셸에 설정합니다: export OPENAI_API_KEY="YOUR_API_KEY" Agency Starter Template에서 시작하고 README에 따라 에이전트와 통신 흐름을 정의합니다
agency-swarm은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/VRSEN/agency-swarm

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트