Google이 제공하는 코드 우선 Java 툴킷으로, Python ADK와 유사한 API를 통해 AI 에이전트를 구축·평가·배포할 수 있습니다.
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
OpenAI extra를 지정해 패키지를 설치합니다
pip install ag2[openai] - 2
OpenAI API 키를 환경 변수로 설정합니다
export OPENAI_API_KEY="<your-api-key>" - 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 통계는 매일 갱신됩니다.
관련 프로젝트
Google의 코드 우선 Python 프레임워크로, Gemini에 최적화되어 있지만 특정 모델에 종속되지 않으며 AI 에이전트를 구축·평가·배포할 수 있습니다.
Python과 TypeScript에서 도구, MCP, 메모리, 모델 간 이식성을 갖춘 AI 에이전트를 만들고 실행하는 오픈소스 SDK입니다.
서로 호출하고 협력하는 AI 에이전트 팀을 실행할 수 있는 셀프 호스팅 클라우드 플랫폼입니다.
지속형 인지 메모리, 선택형 HEXACO 성격, 멀티 에이전트 오케스트레이션과 13개 LLM 공급자를 지원하는 TypeScript AI 에이전트 프레임워크
자율형 AI 에이전트 구축을 위한 오픈소스 TypeScript 프레임워크이자 앱 스택으로, 코어 런타임과 플러그인, 로컬 우선 Eliza 앱을 제공합니다.