Repolode
ag2ai

ag2ai/ag2

LLM과 도구를 사용하는 AI 에이전트를 만들고, 멀티 에이전트 워크플로에서 에이전트끼리 협업하도록 조율하는 Python 프레임워크입니다.

스타
5,010
포크
754
열린 이슈
70
마지막 커밋
13시간 전

어떤 프로젝트인가요?

AG2(구 AutoGen)는 작업을 해결하기 위해 여러 에이전트를 구축하고 조율하는 오픈 소스 Python 프레임워크입니다. `Agent`는 모델 제공자와 통신하고, `@tool`이 적용된 Python 함수를 호출하며, 전체 도구 호출 루프를 실행합니다. `ag2[openai]`, `ag2[anthropic]`, `ag2[gemini]`, `ag2[ollama]`와 같은 extras를 설치해 각 제공자를 사용할 수 있습니다.

멀티 에이전트 작업을 위해 AG2 v1.0은 에이전트 등록, write-ahead log, 감사 추적을 관리하는 `Hub`를 사용합니다. 에이전트는 `conversation`, `consulting`, `discussion`, `workflow`와 같은 타입 지정 채널을 통해 메시지를 주고받습니다. 또한 프로젝트는 opt-in 지식 저장소, 기록 압축, `context.input(...)`을 통한 human-in-the-loop 입력을 지원하는 하네스 계층도 제공합니다. 버전 1.0은 기존 `autogen` 네임스페이스에서 바로 업그레이드할 수 없으며, 기존 네임스페이스는 이제 별도 저장소인 ag2-classic에서 관리됩니다.

핵심 기능

  • 01비동기 `ask()` 호출과 여러 턴에 걸친 대화 이어가기를 지원하는 Agent 클래스.
  • 02`@tool`이 적용된 일반 Python 함수로 도구 호출.
  • 03옵션 extras로 설치할 수 있는 여러 LLM 제공자 지원.
  • 04실행 중 사람의 입력을 받기 위해 일시 중지하는 human-in-the-loop 기능.
  • 05타입 지정 채널과 write-ahead log를 사용하는 Hub 기반 멀티 에이전트 오케스트레이션.
  • 06지속성 메모리를 위한 opt-in 지식 저장소와 기록 압축.

활용 사례

  • LLM API를 통해 사용자 정의 Python 도구를 호출하는 단일 어시스턴트 에이전트 구축.
  • 대화를 통해 결과물을 다듬도록 플래너 에이전트와 리뷰어 에이전트 조율.
  • 도구가 실행되기 전에 사람의 확인을 받아야 하는 승인 단계 추가.
  • Python에서 에이전트 기반 리서치 또는 멀티 에이전트 워크플로 프로토타이핑.

빠른 시작

  1. 1

    OpenAI extra를 지정해 패키지를 설치합니다

    pip install ag2[openai]
  2. 2

    OpenAI API 키를 환경 변수로 설정합니다

    export OPENAI_API_KEY="<your-api-key>"
  3. 3

    README의 first-agent 예제를 저장하고 실행합니다

사용 전 알아둘 점

  • Python 3.10 이상이 필요합니다.
  • 예제를 실행하려면 유료 OpenAI API 키 또는 다른 모델 제공업체의 키가 필요합니다.
  • AG2 Classic에서 바로 업그레이드할 수 없습니다. autogen import와 classic agent 클래스가 제거되었습니다.

토픽

자주 묻는 질문

ag2은(는) 무엇인가요?
LLM과 도구를 사용하는 AI 에이전트를 만들고, 멀티 에이전트 워크플로에서 에이전트끼리 협업하도록 조율하는 Python 프레임워크입니다. AG2(구 AutoGen)는 작업을 해결하기 위해 여러 에이전트를 구축하고 조율하는 오픈 소스 Python 프레임워크입니다. `Agent`는 모델 제공자와 통신하고, `@tool`이 적용된 Python 함수를 호출하며, 전체 도구 호출 루프를 실행합니다. `ag2[openai]`, `ag2[anthropic]`, `ag2[gemini]`, `ag2[ollama]`와 같은 extras를 설치해 각 제공자를 사용할 수 있습니다.
ag2은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
ag2은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
ag2은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. ag2의 마지막 커밋은 2026년 10월 21일입니다.
ag2은(는) 어디에 사용할 수 있나요?
LLM API를 통해 사용자 정의 Python 도구를 호출하는 단일 어시스턴트 에이전트 구축. 대화를 통해 결과물을 다듬도록 플래너 에이전트와 리뷰어 에이전트 조율. 도구가 실행되기 전에 사람의 확인을 받아야 하는 승인 단계 추가. Python에서 에이전트 기반 리서치 또는 멀티 에이전트 워크플로 프로토타이핑.
ag2는 어떻게 설치하나요?
OpenAI extra를 지정해 패키지를 설치합니다: pip install ag2[openai] OpenAI API 키를 환경 변수로 설정합니다: export OPENAI_API_KEY="<your-api-key>" README의 first-agent 예제를 저장하고 실행합니다
ag2은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ag2ai/ag2

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

관련 프로젝트