🪴 디지털 가든

Qwen-Agent 프레임워크 정보

7 min read

Qwen-Agent는 Alibaba Cloud의 Qwen 모델을 기반으로 한 LLM(Large Language Model) 애플리케이션 개발 프레임워크입니다. 이 프레임워크는 Qwen 모델의 명령어 추종, 도구 사용, 계획, 기억 능력을 활용하여 실용적인 환경에서 에이전트로 기능할 수 있도록 설계되었습니다. Qwen-Agent는 LLM과 외부 도구를 결합하여 더 높은 수준의 에이전트를 만들 수 있는 모듈식 설계를 제공합니다.

주요 특징

  • 도구 통합 및 기능 호출: Qwen 모델이 호출할 수 있는 도구(함수, API)를 정의하는 것이 간단하며, OpenAI의 기능 호출 사양과 유사한 “기능 호출” JSON 유사 구문을 처리하여 모델이 호출을 출력하고 도구 결과를 받을 수 있습니다. Qwen-Agent는 웹 브라우징, 코드 실행, 데이터베이스 쿼리 등을 위한 즉시 사용 가능한 도구 플러그인과 함께 제공됩니다.
  • 계획 및 기억: 에이전트 프레임워크는 모델에 작업 기억과 계획기를 장착하여 다단계 작업을 해결할 수 있도록 합니다. 사용자가 각 단계를 프롬프트하는 대신 Qwen-Agent는 모델이 내부적으로 작업 순서를 계획하도록 할 수 있습니다. 예를 들어, 복잡한 쿼리에서 모델은 웹 검색, 결과 요약, 답변 초안 작성을 계획할 수 있습니다. Qwen-Agent는 과거 단계에 대한 기억을 유지하여 모델이 도구가 반환한 내용을 기억하고 다음 단계를 위해 프롬프트에 다시 피드할 수 있습니다.

Qwen-Agent 애플리케이션 예시

Qwen-Agent로 구축된 몇 가지 애플리케이션은 도구를 사용하고 계획을 수행하는 방법을 보여줍니다.

  • 코드 인터프리터 통합: Qwen-Agent는 데이터 분석, 계산 및 시각화 작업을 위해 Python 코드를 실행할 수 있는 내장 코드 인터프리터를 제공합니다. 이는 Qwen에게 OpenAI의 코드 인터프리터와 유사한 기능을 제공하며, 사용자는 파일을 업로드하거나 데이터를 제공할 수 있고, Qwen은 Python 코드를 작성 및 실행하여 데이터를 분석하거나 플롯을 생성합니다.
  • 브라우저 도우미 (BrowserQwen Chrome 확장 프로그램): 브라우저 도우미는 Qwen 모델을 사용하여 사용자 브라우저에서 웹 및 문서를 탐색하고 라이브 정보를 사용하여 쿼리에 응답합니다. BrowserQwen (GitHub에서 사용 가능)이라는 Chrome 확장 프로그램으로 제공됩니다. 현재 웹페이지/PDF에 대한 질문을 논의하거나 답변할 수 있으며 방문한 페이지 기록을 유지합니다.
  • 검색을 통한 100만 토큰 컨텍스트: Qwen-Agent의 혁신적인 사용법은 검색을 사용하여 컨텍스트 길이를 확장하는 것입니다. 연구자들은 표준 8k 컨텍스트 채팅 모델로 시작하여 세 단계를 통해 전체 책을 읽는 것과 같은 작업을 위해 100만 토큰 문서를 처리할 수 있도록 만들었습니다.

Qwen-Agent 설치 및 사용

Qwen-Agent를 설치하는 방법은 다음과 같습니다:

  • PyPI에서 안정 버전 설치: 
    pip install -U "qwen-agent[gui,rag,code_interpreter,python_executor]"
    최소 요구 사항만 설치하려면 pip install -U qwen-agent를 사용합니다.
  • 소스에서 최신 개발 버전 설치: 
    git clone https://github.com/QwenLM/Qwen-Agent.git
cd Qwen-Agent
pip install -e ./ "[gui,rag,code_interpreter,python_executor]"
    최소 요구 사항만 설치하려면 pip install -e ./를 사용합니다.

Qwen-Agent를 사용하려면 Alibaba Cloud의 DashScope에서 제공하는 모델 서비스를 사용하거나 오픈 소스 Qwen 모델을 사용하여 자체 모델 서비스를 배포하고 사용할 수 있습니다.

Qwen-Agent를 활용한 웹 요약 확장 프로그램 구축

Qwen-Agent를 사용하여 웹페이지 내용을 실시간으로 요약하는 브라우저 확장 프로그램을 구축할 수 있습니다. 여기에는 다음이 포함됩니다:

  • FastAPI 백엔드는 웹페이지 텍스트를 받아 요약을 반환합니다.
  • Chrome 확장 프로그램 팝업은 보이는 페이지 콘텐츠를 캡처합니다.
  • 요약이 생성될 때 스트리밍 UI가 제공됩니다.
  • 백엔드는 Ollama를 통해 로컬에서 실행되는 Qwen3:1.7B로 구동됩니다.

Qwen 개발의 차별점

Qwen 모델은 강력한 다국어 성능, 오픈 소스 가용성, 엔터프라이즈 적응성, 도구 사용, 계획 및 기능 호출과 같은 에이전트 기능에 대한 전반적인 강조와 같은 전체적인 접근 방식으로 인해 DeepSeek-R1 및 OpenAI 모델 중에서 돋보입니다. Qwen-Agent와 같은 에이전트 프레임워크에서 구현할 수 있는 광범위한 오픈 소스 모델은 모든 Qwen 개발을 포괄적인 에이전트 에코시스템과 유사하게 만듭니다.

그래프 뷰