도구 및 기능
개요
도구는 에이전트가 대화 중에 수행할 수 있는 작업입니다. 에이전트가 웹을 검색하거나, 명령을 실행하거나, 파일을 읽거나, 기기를 제어해야 할 때 도구를 사용합니다.
Neotask는 파일 관리, 코드 실행, 브라우저 자동화, 기기 제어, 메시지, 웹 검색 등을 다루는 풍부한 내장 도구 세트를 제공합니다.
파일 작업
에이전트는 워크스페이스의 파일을 읽고, 쓰고, 편집할 수 있습니다:
- 읽기, 파일 내용 읽기
- 쓰기, 파일 생성 또는 덮어쓰기
- 편집, 파일의 특정 부분에 대한 타겟 편집
- 패치 적용, 복잡한 파일 수정을 위한 멀티 헝크 통합 diff 적용
코드 실행
에이전트는 구성 가능한 격리 수준으로 셸 명령을 실행할 수 있습니다:
- 게이트웨이 실행, 게이트웨이를 호스팅하는 머신에서 직접 명령 실행
- 샌드박스 실행, 리소스 제한이 있는 격리된 Docker 컨테이너에서 명령 실행
- 노드 실행, 연결된 컴패니언 기기(macOS, Linux 노드)에서 명령 실행
실행 기능
- 구성 가능한 타임아웃 (기본값 30분)
- 백그라운드 작업 관리 (목록, 폴링, 종료, 지우기)
- 장기 실행 명령의 자동 백그라운드 처리
- 인터랙티브 프로그램을 위한 TTY 지원
- 권한이 필요한 작업을 위한 상승 모드 (게이트웨이 호스트 전용)
승인 워크플로
민감한 명령은 실행 전 사용자 승인이 필요할 수 있습니다:
- 허용 목록, 사전 승인된 명령만 실행
- 요청, 알 수 없는 명령은 승인 프롬프트 표시
- 전체, 제한 없음
브라우저 자동화
에이전트는 완전한 Chromium 기반 브라우저(Chrome, Brave, 또는 Edge)를 제어합니다:
작업
- 탐색, URL 열기 및 페이지 간 탐색
- 상호작용, 클릭, 타이핑, 호버, 드래그, 선택, 폼 채우기
- 캡처, 스크린샷 촬영, PDF 내보내기
- 검사, DOM 또는 접근성 트리 스냅샷
- 실행, 페이지 컨텍스트에서 JavaScript 실행
- 업로드, 웹 폼에 파일 업로드
- 관리, 다이얼로그 처리(알림, 확인), 콘솔 출력 읽기
브라우저 프로필
계정 분리를 위한 여러 격리된 브라우저 프로필:
- 각 프로필에는 자체 쿠키, 스토리지, 히스토리가 있음
- 프로그래밍 방식 제어를 위한 자동 할당 CDP 포트
- 원격 브라우저 지원 (다른 머신의 브라우저에 연결)
캔버스 및 A2UI
에이전트-UI(A2UI) 시스템은 에이전트가 연결된 기기에서 인터랙티브 시각 콘텐츠를 렌더링할 수 있게 합니다:
- 표시, 기기 캔버스에 웹 페이지 또는 커스텀 콘텐츠 표시
- 탐색, 캔버스 창에 표시되는 내용 제어
- 평가, 캔버스 컨텍스트에서 JavaScript 실행
- 스냅샷, 현재 표시되는 내용 캡처
- A2UI 푸시, 캔버스에 구조화된 UI 업데이트 전송 (JSONL 페이로드)
- A2UI 초기화, 캔버스 상태 지우기
캔버스 렌더링은 macOS(WebKit), iOS(SwiftUI), Android(Jetpack Compose), 웹(WebChat)에서 사용 가능합니다.
노드 기기 기능
연결된 컴패니언 앱을 통해 에이전트는 다음을 수행할 수 있습니다:
카메라
- 스냅, 사진 촬영 (전면 또는 후면 카메라)
- 클립, 구성 가능한 지속 시간 및 FPS로 비디오 클립 녹화
화면
- 녹화, 구성 가능한 지속 시간 및 품질로 화면 녹화 캡처
위치
- 가져오기, 정확도 선택으로 GPS 좌표 검색
알림
- 알림, 제목, 본문, 우선순위가 포함된 기본 OS 알림 전송
시스템 명령
- 실행, 노드 기기에서 셸 명령 실행
- 확인, 노드에서 명령 사용 가능 여부 확인
메시지
에이전트는 연결된 채널에서 메시지를 보내고 관리할 수 있습니다:
- 보내기, 연결된 채널/수신자에게 메시지 보내기
- 편집, 이전에 보낸 메시지 편집
- 반응, 메시지에 반응 추가
- 스레드, 스레드 생성 및 그 안에서 답장
- 투표, 지원되는 플랫폼에서 투표 생성
- 음성, 음성 채널 상태 확인 (Discord)
웹
- 검색, Brave Search API를 통한 웹 검색
- 가져오기, 웹 페이지 검색 및 HTML을 마크다운/텍스트로 변환
메모리 및 컨텍스트
- 메모리 검색, 에이전트 메모리 파일에 대한 벡터 유사도 검색
- 메모리 가져오기, 이름으로 특정 메모리 파일 검색
세션 관리
- 세션 목록, 에이전트 전체의 활성 세션 보기
- 세션 히스토리, 모든 세션의 기록 가져오기
- 세션으로 보내기, 다른 에이전트 세션에 메시지 보내기
- 서브 에이전트 생성, 격리된 서브 에이전트 실행 시작
- 에이전트 목록, 사용 가능한 에이전트 보기
자동화
- 크론, 예약 작업 생성, 편집, 실행 및 관리
- 게이트웨이, 게이트웨이 재시작, 구성 변경 적용, 업데이트 실행
이미지 분석
에이전트는 구성된 비전 모델을 사용하여 이미지를 분석할 수 있습니다, 콘텐츠 설명, 텍스트 추출, 객체 식별, 시각 콘텐츠에 대한 질문 답변.
도구 그룹
도구는 쉬운 권한 관리를 위해 그룹으로 구성됩니다:
| 그룹 | 도구 |
|---|---|
| runtime | exec, bash, process |
| fs | read, write, edit, apply_patch |
| sessions | sessions_list, sessions_history, sessions_send, sessions_spawn, session_status |
| memory | memory_search, memory_get |
| web | web_search, web_fetch |
| ui | browser, canvas |
| automation | cron, gateway |
| messaging | message |
| nodes | nodes |