Last translated: 16 Jun 2025

Translation Not Available Yet

This repository's README hasn't been translated yet. Once translated, it will be easier to read and understand in your native language (中文).

After translating, add the links to README so others can view it directly.

📢 새 소식: Agent Zero 이제 MCP 서버 & 클라이언트 기능을 포함합니다! 📢

Agent Zero는 이제 다른 LLM 도구를 위한 MCP 서버로 작동할 수 있으며 외부 MCP 서버를 도구로 사용할 수 있습니다.

시연 영상

사용자와 함께 성장하고 학습하는 개인적이고 유기적인 에이전트 프레임워크

  • Agent Zero는 미리 정의된 에이전트 프레임워크가 아닙니다. 동적이고 유기적으로 성장하며 사용하면서 학습하도록 설계되었습니다.
  • Agent Zero는 완전히 투명하며, 읽기 쉽고 이해하기 쉬우며, 사용자 정의가 가능하고 상호작용이 가능합니다.
  • Agent Zero는 컴퓨터를 도구로 사용하여 (사용자의) 작업을 수행합니다.

💡 주요 기능

  1. 범용 어시스턴트
  • Agent Zero는 특정 작업을 위해 미리 프로그래밍되지 않았습니다(하지만 그렇게 할 수는 있습니다). 일반적인 개인 어시스턴트로 사용될 수 있습니다. 작업을 주면 정보를 수집하고 명령과 코드를 실행하며 다른 에이전트 인스턴스와 협력하여 최선을 다해 작업을 완료합니다.
  • 지속적인 메모리를 가지고 있어 이전 솔루션, 코드, 사실, 지시사항 등을 기억하여 미래에 작업을 더 빠르고 안정적으로 해결할 수 있습니다.

Agent 0 작업 중

  1. 컴퓨터를 도구로 사용
  • Agent Zero는 운영 체제를 도구로 사용하여 작업을 수행합니다. 단일 목적의 도구가 미리 프로그래밍되어 있지 않습니다. 대신 필요에 따라 자체 코드를 작성하고 터미널을 사용하여 자체 도구를 만들고 사용할 수 있습니다.
  • 기본적으로 제공되는 도구는 온라인 검색, 메모리 기능, 통신(사용자 및 다른 에이전트와의), 코드/터미널 실행뿐입니다. 그 외의 모든 것은 에이전트 자체가 생성하거나 사용자가 확장할 수 있습니다.
  • 도구 사용 기능은 매우 작은 모델에서도 호환성과 안정성을 극대화하기 위해 처음부터 개발되었습니다.
  • 기본 도구: Agent Zero에는 지식, 웹페이지 콘텐츠, 코드 실행, 통신 등의 도구가 포함되어 있습니다.
  • 사용자 정의 도구 생성: Agent Zero의 기능을 확장하기 위해 자신만의 사용자 정의 도구를 만들 수 있습니다.
  • 인스트루먼트: 인스트루먼트는 Agent Zero가 호출할 수 있는 사용자 정의 함수와 절차를 생성할 수 있는 새로운 유형의 도구입니다.
  1. 다중 에이전트 협업
  • 모든 에이전트는 상위 에이전트로부터 작업과 지시를 받습니다. 모든 에이전트는 상위 에이전트에게 보고합니다.
  • 체인의 첫 번째 에이전트(Agent 0)의 경우 상위는 인간 사용자이며, 에이전트는 차이를 인식하지 못합니다.
  • 모든 에이전트는 하위 작업을 분해하고 해결하기 위해 하위 에이전트를 생성할 수 있습니다. 이는 모든 에이전트가 컨텍스트를 깨끗하고 집중적으로 유지하는 데 도움이 됩니다.

다중 에이전트 다중 에이전트 2

  1. 완전한 사용자 정의 및 확장 가능
  • 이 프레임워크의 거의 모든 것이 하드코딩되지 않았습니다. 숨겨진 것이 없습니다. 모든 것을 사용자가 확장하거나 변경할 수 있습니다.
  • 전체 동작은 prompts/default/agent.system.md 파일의 시스템 프롬프트로 정의됩니다. 이 프롬프트를 변경하면 프레임워크가 크게 달라집니다.
  • 프레임워크는 에이전트를 어떤 식으로도 제한하거나 안내하지 않습니다. 에이전트가 따라야 하는 하드코딩된 레일이 없습니다.
  • 모든 프롬프트, 에이전트의 통신 루프에서 전송되는 모든 작은 메시지 템플릿은 prompts/ 폴더에서 찾을 수 있으며 변경할 수 있습니다.
  • 모든 기본 도구는 python/tools/ 폴더에서 찾을 수 있으며 변경하거나 복사하여 새로운 사전 정의된 도구를 만들 수 있습니다.

프롬프트

  1. 통신이 핵심
  • 적절한 시스템 프롬프트와 지시를 주면 에이전트는 기적을 일으킬 수 있습니다.
  • 에이전트는 상위 및 하위와 통신하여 질문하고 지시를 주며 지침을 제공할 수 있습니다. 시스템 프롬프트에서 에이전트에게 효과적인 통신 방법을 지시하세요.
  • 터미널 인터페이스는 실시간으로 스트리밍되며 상호작용이 가능합니다. 언제든지 중단하고 개입할 수 있습니다. 에이전트가 잘못된 방향으로 가는 것을 보면 즉시 중단하고 바로 알려주세요.
  • 이 프레임워크에는 많은 자유가 있습니다. 에이전트에게 정기적으로 상위에게 보고하여 계속할 수 있는지 허가를 요청하도록 지시할 수 있습니다. 하위 작업을 위임할 때 점수 시스템을 사용하도록 지시할 수 있습니다. 상위는 하위의 결과를 다시 확인하고 이의를 제기할 수 있습니다. 가능성은 무한합니다.

🚀 Agent Zero로 만들 수 있는 것들

  • 개발 프로젝트 - "실시간 데이터 시각화가 포함된 React 대시보드 생성"
  • 데이터 분석 - "지난 분기 NVIDIA 판매 데이터를 분석하고 트렌드 보고서 작성"
  • 콘텐츠 생성 - "마이크로서비스에 대한 기술 블로그 포스트 작성"
  • 시스템 관리 - "웹 서버 모니터링 시스템 설정"
  • 연구 - "CoT 프롬프팅에 관한 최근 AI 논문 5편을 수집하고 요약"

해킹 에디션

  • Agent Zero는 또한 Kali linux 기반의 해킹 에디션을 제공하며, 사이버 보안 작업을 위해 수정된 프롬프트를 사용합니다.
  • 설정은 일반 버전과 동일하며, frdel/agent-zero-run:hacking 이미지를 frdel/agent-zero-run 대신 사용하면 됩니다.

참고: 해킹 에디션과 모든 프롬프트 및 기능은 다음 릴리스에서 메인 브랜치로 병합될 예정입니다.

⚙️ 설치

Agent Zero 설치 방법을 배우려면 비디오를 클릭하세요:

쉬운 설치 가이드

Windows, macOS, Linux에 대한 자세한 설정 가이드와 비디오는 Agent Zero 문서의 이 페이지에서 확인할 수 있습니다.

⚡ 빠른 시작

# Pull and run with Docker

docker pull frdel/agent-zero-run
docker run -p 50001:80 frdel/agent-zero-run

# Visit http://localhost:50001 to start

🐳 완전한 Docker화, 음성-텍스트 및 TTS 포함

설정

  • 사용자 정의 가능한 설정을 통해 사용자는 에이전트의 동작과 응답을 자신의 필요에 맞게 조정할 수 있습니다.
  • 웹 UI 출력은 매우 깔끔하고 유동적이며, 색상이 풍부하고 읽기 쉽고 상호작용이 가능합니다. 숨겨진 것이 없습니다.
  • 웹 UI 내에서 직접 채팅을 로드하거나 저장할 수 있습니다.
  • 터미널에서 보는 것과 동일한 출력이 모든 세션에 대해 logs/ 폴더에 HTML 파일로 자동 저장됩니다.

시간 예시

  • 에이전트 출력은 실시간으로 스트리밍되며, 사용자는 따라 읽으면서 언제든지 개입할 수 있습니다.
  • 코딩이 필요하지 않으며, 프롬프팅과 통신 기술만 필요합니다.
  • 견고한 시스템 프롬프트를 사용하면 작은 모델에서도 정확한 도구 사용이 가능한 안정적인 프레임워크입니다.

👀 유의사항

  1. Agent Zero는 위험할 수 있습니다!
  • 적절한 지시가 주어지면 Agent Zero는 컴퓨터, 데이터 또는 계정과 관련된 잠재적으로 위험한 행동을 포함한 많은 것을 할 수 있습니다. 항상 Docker와 같은 격리된 환경에서 Agent Zero를 실행하고 원하는 것이 무엇인지 주의하세요.
  1. Agent Zero는 프롬프트 기반입니다.
  • 전체 프레임워크는 prompts/ 폴더에 의해 안내됩니다. 에이전트 지침, 도구 사용법, 메시지, 유틸리티 AI 함수 등 모든 것이 여기에 있습니다.

📚 문서 읽기

페이지설명
설치설치, 설정 및 구성
사용법기본 및 고급 사용법
아키텍처시스템 설계 및 구성 요소
기여기여 방법
문제 해결일반적인 문제 및 해결 방법

출시 예정

  • MCP
  • 지식 및 RAG 도구

🎯 변경 로그

v0.8.5 - MCP 서버 + 클라이언트

릴리스 비디오

  • Agent Zero는 이제 MCP 서버로 작동할 수 있습니다.
  • Agent Zero는 외부 MCP 서버를 도구로 사용할 수 있습니다.

v0.8.4.1 - 2

기본 모델을 gpt-4.1로 설정

  • 코드 실행 도구 개선
  • 브라우저 에이전트 개선
  • 메모리 개선
  • 컨텍스트 관리와 관련된 다양한 버그 수정
  • 메시지 포맷팅 개선
  • 스케줄러 개선
  • 새로운 모델 제공자
  • 입력 도구 수정
  • 호환성 및 안정성 개선

v0.8.4

릴리스 비디오

  • 원격 접근 (모바일)

v0.8.3.1

릴리스 비디오

  • 자동 임베딩

v0.8.3

릴리스 비디오

  • 계획 및 스케줄링

v0.8.2

릴리스 비디오

  • 터미널에서의 멀티태스킹
  • 채팅 이름

v0.8.1

릴리스 비디오

  • 브라우저 에이전트
  • UX 개선

v0.8

릴리스 비디오

  • Docker 런타임
  • 새로운 메시지 기록 및 요약 시스템
  • 에이전트 동작 변경 및 관리
  • 텍스트-음성 변환(TTS) 및 음성-텍스트 변환(STT)
  • 웹 UI의 설정 페이지
  • Perplexity + DuckDuckGo를 대체하는 SearXNG 통합
  • 파일 브라우저 기능
  • KaTeX 수학 시각화 지원
  • 채팅 내 파일 첨부

v0.7

릴리스 비디오

  • 자동 메모리
  • UI 개선
  • 인스트루먼트
  • 확장 프레임워크
  • 반성 프롬프트
  • 버그 수정

🤝 커뮤니티 및 지원