agent-zero 사용방법

이 가이드에서는 Agent Zero의 사용 및 구성 시나리오를 살펴봅니다. 설치 후 참고 가이드입니다.

기본 작업 #

Agent Zero는 인터페이스를 통해 여러 가지 기본 작업을 제공합니다.

프레임워크 재시작 #

다시 시작 버튼을 사용하면 터미널을 사용하지 않고도 Agent Zero 프레임워크를 빠르게 다시 시작할 수 있습니다.

• 사이드바에서 “다시 시작” 버튼을 클릭하세요
• “다시 시작…”이라는 파란색 알림이 나타납니다.
• 완료되면 녹색 성공 메시지 “다시 시작됨”이 표시됩니다.
• 프레임워크는 현재 채팅 기록과 컨텍스트를 유지하면서 다시 초기화됩니다.

팁

다음과 같은 경우 재시작 기능을 사용하세요.

• 예상치 못한 동작이 발생하면 프레임워크를 재설정하세요.
• 에이전트가 응답하지 않을 때 시스템을 다시 초기화합니다.

액션 버튼 #

Agent Zero는 채팅 입력 상자 아래에 향상된 제어와 가시성을 위한 일련의 작업 버튼을 제공합니다.

채팅 흐름 제어 #

• 에이전트 일시 중지/재개: 채팅 흐름을 일시 중지하고 다시 시작하는 토글 버튼
  • 진행 중인 에이전트 작업을 일시 중지하려면 클릭하세요.
  • 일시 중지 시 “에이전트 재개” 변경
  • 다시 클릭하면 채팅 흐름과 명령 실행이 재개됩니다.

지식 및 파일 관리 #

• 지식 가져오기: 외부 파일을 에이전트의 지식 기반으로 가져옵니다.
  • .txt, .pdf, .csv, .html, .json, 및 .md형식을 지원합니다 .
  • 파일은 다음 위치에 저장됩니다.\knowledge\custom\main
  • 성공 메시지는 성공적인 가져오기를 확인합니다.
  • 자세한 내용은 지식을 참조하세요

파일 브라우저: Agent Zero 환경에서 파일 관리 #

• 새 파일 및 폴더 업로드
• 파일(파일 이름 클릭) 또는 폴더(zip 아카이브) 다운로드
• 파일 및 폴더 삭제
• “위로” 버튼을 사용하여 디렉토리를 탐색합니다.
• 파일 이름 변경 및 검색 지원이 곧 제공됩니다.
• 자세한 기능은 파일 브라우저 섹션을 참조하세요 .

디버깅 및 모니터링 #

• 컨텍스트: LLM에 전송된 전체 컨텍스트 창을 봅니다.
  • 시스템 프롬프트 포함
  • 현재 대화 맥락을 보여줍니다
  • 활성 지침 및 매개변수를 표시합니다.

역사: #

JSON 형식으로 채팅 기록에 접근

• LLM에서 처리된 대화를 확인하세요.
• 디버깅 및 에이전트 동작 이해에 유용합니다.

• 넛지: 에이전트의 마지막 프로세스를 다시 시작합니다.
  • 에이전트가 응답하지 않을 때 유용합니다.
  • 마지막 작업을 다시 시도합니다
  • 멈춘 상태에서 회복하는 데 도움이 됩니다.

팁

컨텍스트 및 기록 버튼을 사용하여 상담원이 사용자의 지시를 어떻게 해석하는지 파악하고 예상치 못한 동작을 디버깅하세요.

파일 첨부 #

Agent Zero는 원활한 파일 작업을 위해 채팅 인터페이스에서 직접 파일 첨부를 지원합니다.

파일 첨부 #

• 채팅 입력창 왼쪽에 있는 첨부파일 아이콘(📎)을 클릭하세요.
• 첨부할 파일을 하나 이상 선택하세요
• 보내기 전에 첨부 파일을 미리 확인하세요.
  • 파일 이름은 유형(HTML, PDF, JPG 등)과 함께 표시됩니다.
  • 이미지는 사용 가능한 경우 썸네일로 표시됩니다.
  • 파일은 채팅 입력 영역에 나열되어 전송을 기다리고 있습니다.

첨부 파일 작업 #

• 파일은 메시지에서 직접 참조할 수 있습니다.
• Agent Zero는 다음을 수행할 수 있습니다.
  • 첨부 파일 처리
  • 특정 디렉토리로 파일 이동
  • 여러 파일에 대해 동시에 작업 수행
  • 자세한 응답으로 성공적인 파일 작업 확인

팁

여러 파일을 작업하는 경우, 한 번에 모두 첨부한 후 처리 방법을 안내해 드릴 수 있습니다. 담당자가 일괄 처리하면서 진행 상황을 알려 드립니다.

도구 사용 #

에이전트 제로의 힘은 도구 를 활용하는 능력에서 비롯됩니다 . 도구를 효과적으로 활용하는 방법은 다음과 같습니다.

• 도구 이해: Agent Zero에는 지식(SearXNG 기반), 코드 실행, 커뮤니케이션과 같은 기본 도구가 포함되어 있습니다. 이러한 도구의 기능과 활용 방법을 이해하세요.

도구 사용 예: 웹 검색 및 코드 실행 #

Agent Zero에게 재무 분석 작업을 수행해 달라고 요청한다고 가정해 보겠습니다. 다음과 같은 프롬프트가 표시될 수 있습니다.

전문 재무 분석가가 되어 주세요. 지난달 비트코인/USD 가격 추세를 확인하고, 차트를 만들어 보세요. 차트에는 암호화폐 관련 주요 뉴스 날짜와 관련된 주요 내용이 강조되어 있어야 합니다. ‘검색 엔진’과 ‘문서 쿼리 도구’를 사용하여 가격과 뉴스를 찾고, ‘코드 실행 도구’를 사용하여 나머지 작업을 수행하세요.

그러면 Agent Zero는 다음을 수행할 수 있습니다.

1. 비트코인 가격과 암호화폐에 대한 뉴스를 신뢰할 수 있는 출처에 문의하려면 search_engine및 를 사용하세요 .document_query_tool
2. 검색 결과에서 가격을 추출하고 뉴스를 저장하며, 해당 날짜와 가격에 미칠 수 있는 영향을 추출합니다.
3. code_execution_tool추출된 데이터와 뉴스 날짜를 입력으로 사용하여 그래프를 생성하고 주요 포인트를 강조하는 Python 스크립트를 실행합니다 .
4. /work_dir사용자에게 응답하여 찾을 수 있는 최종 차트를 반환합니다 response_tool.

메모

첫 번째 실행은 code_execution_toolAgent Zero Docker 이미지를 다운로드하고 빌드하는 데 시간이 걸릴 수 있습니다. 이후 실행은 더 빨라집니다.

이 예제는 여러 도구를 결합하여 분석 작업을 수행하는 방법을 보여줍니다. 신속한 엔지니어링 및 도구 활용법을 숙달하면 Agent Zero의 잠재력을 최대한 활용하여 복잡한 문제를 해결할 수 있습니다.

다중 에이전트 협력 #

Agent Zero의 독특한 기능 중 하나는 다중 에이전트 협력입니다.

• 하위 에이전트 생성: 에이전트는 하위 에이전트를 생성하여 하위 작업을 위임할 수 있습니다. 이를 통해 복잡성을 관리하고 작업 부하를 분산하는 데 도움이 됩니다.
• 소통: 상담원들은 서로 소통하며 정보를 공유하고 업무를 조율할 수 있습니다. 시스템 프롬프트와 메시지 기록은 이러한 소통을 안내하는 데 중요한 역할을 합니다.
• 계층 구조: 에이전트 제로는 상위 에이전트가 하위 에이전트에게 작업을 위임하는 계층 구조를 사용합니다 . 이를 통해 체계적인 문제 해결과 효율적인 자원 배분이 가능합니다.

신속한 엔지니어링 #

Agent Zero를 최대한 활용하려면 효과적인 신속한 엔지니어링이 필수적입니다. 다음은 몇 가지 팁과 기술입니다.

• 명확하고 구체적으로 작성하세요: 원하는 결과를 명확하게 명시하세요. 구체적으로 작성할수록 Agent Zero가 귀하의 요청을 더 잘 이해하고 이행할 수 있습니다. 모호하거나 모호한 표현은 피하세요.
• 맥락 제공: 필요한 경우 상담원이 작업을 더 잘 이해할 수 있도록 배경 정보나 맥락을 제공하세요. 여기에는 관련 세부 정보, 제약 조건 또는 원하는 응답 형식이 포함될 수 있습니다.
• 복잡한 작업 세분화: 복잡한 작업의 경우, 더 작고 관리하기 쉬운 하위 작업으로 나누세요. 이렇게 하면 상담원이 문제를 더 쉽게 추론하고 해결책을 도출할 수 있습니다.
• 반복적 개선: 첫 시도에서 완벽한 결과를 기대하지 마세요. 다양한 프롬프트를 실험하고, 상담원의 응답에 따라 지침을 개선하고, 원하는 결과를 얻을 때까지 반복하세요. 예를 들어 풀스택 웹앱 개발 작업을 100% 성공하려면 몇 시간 동안 반복해야 할 수도 있습니다.

음성 인터페이스 #

Agent Zero는 자연스러운 음성 상호작용을 위해 TTS(텍스트-음성) 및 STT(음성-텍스트) 기능을 모두 제공합니다.

텍스트 음성 변환 #

상담원의 음성 응답을 활성화합니다.

• 사이드바의 환경 설정 섹션에서 “음성” 스위치를 전환합니다.
• 상담원은 시스템에 내장된 음성 합성기를 사용하여 메시지를 말합니다.
• 입력 영역 위에 있는 “말하기 중지” 버튼을 클릭하면 진행 중인 말을 즉시 중지할 수 있습니다.

• 이 인터페이스를 사용하면 응답이 너무 길거나 대화 중에 개입하고 싶을 때 언제든지 말을 멈출 수 있습니다.

TTS는 최신 브라우저에서 제공하는 표준 음성 인터페이스를 사용합니다. 로봇처럼 들릴 수 있지만 효과적이며 복잡한 AI 모델을 필요로 하지 않습니다. 이를 통해 모바일 기기를 포함한 다양한 플랫폼에서 낮은 지연 시간과 빠른 응답을 보장합니다.

팁

텍스트-음성 변환 기능은 다음과 같은 경우에 유용합니다.

• 에이전트 응답을 받는 동안 멀티태스킹
• 접근성 목적
• 더욱 상호작용적인 경험 만들기

음성-텍스트 변환 #

OpenAI의 Whisper 모델을 사용하여 에이전트에게 음성 메시지를 보냅니다(OpenAI API 키가 필요하지 않습니다!):

1. 녹음을 시작하려면 입력 영역의 마이크 버튼을 클릭하세요.
2. 버튼 색상은 현재 상태를 나타냅니다.
   • 회색: 비활성
   • 빨간색: 듣기
   • 녹색: 녹음 중
   • 청록색: 기다리다
   • 시안(펄싱): 처리 중

사용자는 상호 작용 경험을 최적화하기 위해 메시지를 보내기 전에 무음 임계값과 메시지 지속 시간과 같은 설정을 조정할 수 있습니다.

설정 페이지에서 STT 설정을 구성하세요.

• 모델 크기: 기본(74M, 영국식) 또는 기타 모델 중에서 선택하세요
  • 참고: 대형 및 터보 모델만 여러 언어를 지원합니다.
• 언어 코드: 선호하는 언어를 설정하세요(예: ‘en’, ‘fr’, ‘it’, ‘cz’)
• 침묵 감지:
  • 임계값: 감도 조정(값이 낮을수록 더 민감함)
  • 지속 시간: 녹음이 종료되기 전에 무음이 지속되는 시간을 설정합니다.
  • 시간 초과: 마이크를 닫기 전 최대 대기 시간을 설정합니다.

중요한

모든 STT 및 TTS 기능은 Docker 컨테이너 내에서 로컬로 작동하므로 외부 서버나 OpenAI API로 데이터가 전송되지 않습니다. 이를 통해 기능을 유지하면서 사용자 개인 정보 보호가 강화됩니다.

수학 표현식 #

Agent Zero는 아름다운 수학적 조판을 위해 KaTeX를 지원합니다.

• 인라인 수학:$...$ 인라인 표현식에 단일 달러 사용
  • 예: 유형The area of a circle is $A = πr^2$
  • 렌더링: 원의 면적은 다음과 같습니다.에이=파이아르 자형2
• 디스플레이 수학:$$...$$ 중앙에 표시된 방정식에 두 배 달러를 사용하세요.
  • 예: 유형$$F = G\frac{m_1m_2}{r^2}$$
  • 중심 방정식으로 렌더링합니다

• 복잡한 수학: 다음에 대한 전체 KaTeX 구문을 지원합니다.
  • 분수, 지수 및 제곱근
  • 행렬과 배열
  • 그리스 문자와 수학 기호
  • 적분, 합, 한계
  • 수학적 정렬 및 방정식

팁

에이전트에게 수학 문제를 풀어달라고 요청하면, 명확하고 전문적인 수학적 표현을 위해 KaTeX 형식을 사용하여 자동으로 응답합니다.

파일 브라우저 #

Agent Zero는 작업 공간을 관리하기 위한 강력한 파일 브라우저 인터페이스를 제공합니다.

인터페이스 개요 #

• 탐색 표시줄 : 상위 디렉토리의 “위” 버튼과 함께 현재 디렉토리 경로를 표시합니다.
• 파일 목록 : 주요 정보와 함께 파일 및 디렉토리를 표시합니다.
  • 이름(정렬 가능)
  • 바이트 단위 크기
  • 마지막 수정 타임스탬프
• 작업 아이콘 : 각 파일/디렉토리에는 다음이 있습니다.
  • 다운로드 버튼
  • 삭제 버튼(확인 포함)

특징 #

• 디렉토리 탐색 :
  • 디렉토리를 클릭하여 들어가세요
  • 상위 디렉토리로 이동하려면 “위로” 버튼을 사용하세요.
  • 현재 경로는 항상 컨텍스트에 표시됩니다.

메모

파일 브라우저를 사용하면 버튼을 클릭하면 사용자가 Agent Zero 루트 폴더로 이동할 수 있지만 UpAgent의 작업 디렉토리는 항상 다음과 같습니다./work_dir

• 파일 작업 :
  • 새 파일 및 디렉토리 만들기
  • 기존 파일 및 디렉토리 삭제
  • 로컬 시스템에 파일을 다운로드하세요
  • 로컬 시스템에서 파일 업로드
• 파일 정보 :
  • 파일 유형(폴더, 코드 파일, 문서)에 대한 시각적 표시기
  • 사람이 읽을 수 있는 형식의 크기 정보
  • 마지막 수정 타임스탬프
• 대량 작업 :
  • 여러 파일을 동시에 업로드
  • 여러 파일을 한 번에 선택하고 관리하세요

팁

파일 브라우저는 Agent Zero 기능과 완벽하게 통합됩니다. 대화 중에 파일을 직접 참조할 수 있으며, Agent가 파일을 관리, 수정 및 정리하는 데 도움을 줄 수 있습니다.

백업 및 복원 #

Agent Zero는 데이터와 구성을 보호하는 포괄적인 백업 및 복원 시스템을 제공합니다. 이 기능을 사용하면 작업을 안전하게 보호하고 Agent Zero 설정을 여러 시스템 간에 마이그레이션할 수 있습니다.

백업 생성 #

설정 인터페이스를 통해 백업 기능에 액세스하세요.

1. 사이드바에서 설정 버튼을 클릭하세요
2. 백업 탭 으로 이동합니다.
3. 백업 프로세스를 시작하려면 백업 만들기를 클릭하세요.

백업되는 내용 #

기본적으로 Agent Zero는 가장 중요한 데이터를 백업합니다.

• 지식 기반 : 사용자 정의 지식 파일 및 문서
• 메모리 시스템 : 에이전트의 기억과 학습된 정보
• 채팅 기록 : 모든 대화 및 상호 작용
• 구성 파일 : 설정, API 키 및 시스템 환경 설정
• 사용자 정의 도구 : 추가하거나 수정한 모든 도구
• 업로드된 파일 : 작업한 문서 및 파일

백업 콘텐츠 사용자 지정 #

백업을 만들기 전에 포함할 내용을 사용자 지정할 수 있습니다.

• 패턴 편집 : 내장 편집기를 사용하여 백업할 파일과 폴더를 정확하게 지정합니다.
• 숨겨진 파일 포함 : 시스템 및 구성 파일을 포함할지 여부를 선택합니다.
• 미리 보기 파일 : 백업을 생성하기 전에 정확히 무엇이 포함될지 확인하세요
• 정리된 보기 : 파일은 쉽게 검토할 수 있도록 디렉토리별로 그룹화됩니다.

팁

백업 시스템은 패턴 일치를 사용하므로 특정 파일 형식을 포함하거나 제외할 수 있습니다. 예를 들어 모든 .py파일을 백업하고 임시 .tmp파일은 제외할 수 있습니다.

백업 만들기 #

1. 필요한 내용을 백업하고 있는지 확인하려면 파일 미리 보기를 검토하세요.
2. 백업에 설명적인 이름을 지정하세요
3. 백업 생성을 클릭하여 아카이브를 생성합니다.
4. 백업 파일은 ZIP 아카이브로 자동 다운로드됩니다.

메모

백업 생성은 데이터 양에 따라 몇 분 정도 걸릴 수 있습니다. 생성 과정에서 진행 상황이 업데이트됩니다.

백업에서 복원 #

복원 프로세스를 통해 이전 백업에서 Agent Zero 설정을 복구할 수 있습니다.

복원 시작 #

1. 설정 → 백업 탭 으로 이동합니다 .
2. 백업에서 복원을 클릭하세요
3. 백업 ZIP 파일을 업로드하세요

복원 전 검토 #

업로드 후 복원을 검토하고 사용자 지정할 수 있습니다.

• 메타데이터 검사 : 백업이 생성된 시기와 위치에 대한 정보를 확인합니다.
• 복원 패턴 편집 : 복원할 파일을 정확하게 선택하세요
• 변경 사항 미리 보기 : 어떤 파일이 복구될지, 덮어쓸지, 건너뛸지 확인하세요.
• 교차 시스템 호환성 : 다른 시스템에서 복원할 때 경로가 자동으로 조정됩니다.

복원 옵션 #

복원 시 기존 파일을 처리하는 방법을 구성합니다.

• 덮어쓰기 : 기존 파일을 백업 버전으로 바꿉니다.
• 건너뛰기 : 기존 파일 유지, 누락된 파일만 복원
• 기존 파일 백업 : 덮어쓰기 전에 기존 파일의 백업 사본을 만듭니다.

복원 전 청소 #

선택적으로 복원하기 전에 기존 파일을 정리합니다.

• 스마트 정리 : 복원하기 전에 백업 패턴과 일치하는 파일을 제거합니다.
• 미리 보기 정리 : 삭제하기 전에 어떤 파일이 삭제되는지 확인하세요.
• 안전한 작업 : 지정된 패턴과 일치하는 파일에만 영향을 미칩니다.

모범 사례 #

백업을 생성해야 하는 경우 #

• 주요 변경 사항 전 : 중요한 수정 사항이 있을 경우 항상 백업하세요.
• 정기 일정 : 작업의 주간 또는 월간 백업을 만듭니다.
• 시스템 업데이트 전 : Agent Zero 또는 시스템 구성 요소를 업데이트하기 전에 백업하세요.
• 프로젝트 이정표 : 중요한 작업을 완료할 때 백업을 저장합니다.

백업 관리 #

• 설명적 이름 : “project-completion-2024-01″과 같이 명확한 이름을 사용하세요.
• 외부 저장소 : Agent Zero 외부의 안전한 위치에 백업 파일을 보관하세요.
• 여러 버전 : 다양한 기간 동안 여러 백업 버전을 유지합니다.
• 테스트 복원 : 가끔씩 백업 복원을 테스트하여 제대로 작동하는지 확인합니다.

보안 고려 사항 #

• API 키 : 백업에는 API 키와 중요한 구성이 포함됩니다.
• 안전한 저장 : 백업 파일을 안전하게 저장하고 공유하지 마세요
• 깨끗한 시스템 : 새 시스템으로 복원할 때 모든 구성을 확인하십시오.

일반적인 사용 사례 #

시스템 마이그레이션 #

Agent Zero를 새로운 서버나 컴퓨터로 옮기기:

1. 원본 시스템에 전체 백업을 만듭니다.
2. 새 시스템에 Agent Zero 설치
3. 모든 데이터와 설정을 마이그레이션하려면 백업을 복원하세요.

프로젝트 보관 #

완료된 프로젝트 보존:

1. 프로젝트별 백업 패턴 생성
2. 관련 파일과 대화만 포함합니다.
3. 백업을 프로젝트 아카이브로 저장합니다.

개발 스냅샷 #

진행 중인 작업 상태 저장:

1. 개발 중에 자주 백업을 만드세요
2. 설명적인 이름을 사용하여 진행 상황을 추적하세요
3. 문제가 발생하면 이전 버전을 복원하세요

팀 협업 #

Agent Zero 구성 공유:

1. 공유 구성 및 도구를 사용하여 백업 만들기
2. 팀원은 일관된 설정을 얻기 위해 복원할 수 있습니다.
3. 문서 및 프로젝트 파일을 포함합니다

중요한

중요한 데이터를 백업 및 복원하기 전에 항상 안전한 환경에서 백업 및 복원 프로세스를 테스트하세요. 여러 개의 백업 버전을 보관하고 안전하고 쉽게 접근할 수 있는 장소에 보관하세요.

팁

백업 시스템은 다양한 운영 체제와 Agent Zero 설치 환경에서 작동하도록 설계되었습니다. Windows 시스템의 백업은 Linux에서도 작동하며, 그 반대의 경우도 마찬가지입니다.