차이

문서의 선택한 두 판 사이의 차이를 보여줍니다.

--- ai:assistant_ops_available_tools [2026-04-09 11:55] – 비서운용가이드 초기 문서 생성 [기존 위키에서 이전] 172.19.176.1
+++ ai:assistant_ops_available_tools [2026-10-30 14:55] (현재) – 바깥 편집 127.0.0.1
@@ 줄 1: / 줄 1: @@
 ====== 사용가능한 도구 ======
-비서가 업무에 활용할 수 있는 도구를 정리하는 페이지입니다.
+이 문서는 비서가 실제 업무에서 활용할 수 있는 도구와 사용 범위를 정리한 운영 안내서입니다.
+비서는 단순 응답형 챗봇이 아니라, 파일 확인, 문서 수정, 검색, 메시지 전송, 자동화 실행, Google Workspace 연동 등 다양한 작업을 도구를 통해 수행할 수 있습니다.
-===== 주요 범주 =====
+===== 기본 원칙 =====
-  * OpenClaw 기본 도구
+  * 비서는 추측보다 ''실제 확인''을 우선합니다.
-  * Google Workspace 연동 도구
+  * 가능한 경우 도구를 사용해 근거를 확인한 뒤 답변합니다.
-  * 위키/문서 조회 도구
+  * 도구마다 역할과 강점이 다르므로 작업 목적에 맞게 선택해서 사용합니다.
-  * 로컬 스크립트 및 자동화 도구
+  * 외부 전송, 삭제, 되돌리기 어려운 변경은 신중하게 다룹니다.
-===== 운영 메모 =====
+===== 1. OpenClaw 기본 도구 =====
-  * 외부 전송이나 삭제처럼 되돌리기 어려운 작업은 사전 확인이 필요합니다.
+아래 도구들은 비서가 기본적으로 사용할 수 있는 핵심 도구입니다.
-  * 조회, 정리, 분석 성격의 내부 작업은 우선 실행 후 결과를 보고합니다.
-  * 도구별 사용법과 제한사항은 실제 운영에 맞게 계속 업데이트합니다.
+==== 1-1. 파일 읽기 ====
+도구 명칭: ''read''
+용도:
+  * 문서 내용 확인
+  * 설정 파일 점검
+  * 업무 메모 및 기록 확인
+  * 운영 문서, 가이드, 로그 확인
+활용 예시:
+  * AGENTS.md, USER.md, MEMORY.md 같은 운영 문서 확인
+  * 저장된 보고서나 메모 파일 읽기
+==== 1-2. 파일 쓰기 ====
+도구 명칭: ''write''
+용도:
+  * 새 문서 작성
+  * 결과 파일 저장
+  * 초안 문서 생성
+  * 정리본 작성
+활용 예시:
+  * 새 운영 문서 작성
+  * 분석 결과를 파일로 저장
+주의사항:
+  * 기존 내용을 전체 덮어쓸 수 있으므로 범위를 명확히 확인해야 합니다.
+==== 1-3. 파일 수정 ====
+도구 명칭: ''edit''
+용도:
+  * 특정 문장 수정
+  * 링크 추가
+  * 문단 교체
+  * 오타 및 표현 정리
+활용 예시:
+  * 위키 문서 하단에 새 항목 추가
+  * 기존 설명 문구만 부분 수정
+==== 1-4. 명령 실행 ====
+도구 명칭: ''exec''
+용도:
+  * 시스템 상태 확인
+  * 파일/폴더 조회
+  * 위키 원문 가져오기
+  * 스크립트 실행
+  * 간단한 자동화 처리
+활용 예시:
+  * 파이썬 스크립트 실행
+  * 시스템 점검 명령 수행
+  * 위키 페이지 원문 조회
+주의사항:
+  * 강력한 도구이므로 파급효과가 있는 명령은 신중하게 다뤄야 합니다.
+==== 1-5. 실행 작업 관리 ====
+도구 명칭: ''process''
+용도:
+  * 실행 상태 확인
+  * 중간 로그 조회
+  * 작업 종료
+  * 추가 입력 전달
+활용 예시:
+  * 오래 걸리는 백그라운드 작업 진행 상황 확인
+==== 1-6. 웹 검색 ====
+도구 명칭: ''web_search''
+용도:
+  * 최신 정보 검색
+  * 기사, 블로그, 문서 탐색
+  * 공식 사이트 및 참고 자료 확인
+활용 예시:
+  * 특정 서비스의 최신 변경사항 확인
+  * 공식 문서나 보도자료 탐색
+==== 1-7. 웹페이지 읽기 ====
+도구 명칭: ''web_fetch''
+용도:
+  * 기사 본문 확인
+  * 안내 페이지 요약
+  * 문서 내용 추출
+  * 검색 결과 후속 확인
+활용 예시:
+  * 검색 결과로 찾은 문서의 실제 본문 검토
+==== 1-8. 브라우저 ====
+도구 명칭: ''browser''
+용도:
+  * 웹페이지 열기
+  * 화면 상태 확인
+  * 버튼 클릭
+  * 입력칸 작성
+  * 스크린샷 확보
+활용 예시:
+  * 웹 UI 구조 확인
+  * 로그인된 브라우저 화면 점검
+==== 1-9. 캔버스 ====
+도구 명칭: ''canvas''
+용도:
+  * 화면 표시
+  * 화면 내용 확인
+  * 시각적 상태 점검
+==== 1-10. 메시지 전송 ====
+도구 명칭: ''message''
+용도:
+  * 작업 결과 보고
+  * 안내 메시지 전송
+  * 이모지 반응 남기기
+  * 알림 발송
+활용 예시:
+  * 채팅방에 완료 보고 전송
+  * 특정 메시지에 반응 추가
+주의사항:
+  * 외부로 나가는 행동이므로 사용자를 대신한 의사 표현에는 주의가 필요합니다.
+==== 1-11. 음성 변환 ====
+도구 명칭: ''tts''
+용도:
+  * 텍스트를 음성으로 변환
+  * 듣기용 안내 생성
+==== 1-12. 기억 검색 ====
+도구 명칭: ''memory_search'', ''memory_get''
+용도:
+  * 이전 결정사항 확인
+  * 사용자 선호 복기
+  * 과거 작업 맥락 확인
+활용 예시:
+  * 예전에 정리해둔 기준이나 메모 다시 확인
+==== 1-13. 세션 / 보조 에이전트 관리 ====
+도구 명칭: ''sessions_spawn'', ''sessions_send'', ''sessions_list'', ''sessions_history'', ''sessions_yield'', ''subagents'', ''agents_list''
+용도:
+  * 보조 세션 생성
+  * 별도 작업 위임
+  * 진행 상태 확인
+  * 필요 시 종료 또는 제어
+활용 예시:
+  * 긴 조사 작업을 별도 세션에 맡기기
+  * 코딩 또는 분석 작업을 분리 실행
+==== 1-14. 상태 확인 ====
+도구 명칭: ''session_status''
+용도:
+  * 현재 시간 확인
+  * 세션 상태 확인
+  * 모델 및 실행 환경 점검
+===== 2. TOOLS.md 기반 추가 도구 =====
+비서는 OpenClaw 기본 도구 외에도 TOOLS.md에 정리된 외부 도구와 작업 방식을 활용할 수 있습니다.
+==== 2-1. Google Workspace CLI ====
+도구 명칭: ''gog'' 또는 ''gogcli''
+설명:
+  * Google Workspace 작업을 명령줄에서 처리하는 도구입니다.
+  * Gmail, Calendar, Drive, Chat, Docs, Sheets 등을 다룰 수 있습니다.
+주요 기능:
+  * Google Drive 파일 검색, 다운로드, 업로드, 공유
+  * Gmail 검색, 메일 발송, 스레드 조회
+  * Google Calendar 일정 조회, 생성, 응답
+  * Google Chat DM 및 스페이스 메시지 전송
+  * Google Docs 내용 읽기 및 내보내기
+  * Google Sheets 조회, 추가, 수정, 내보내기
+활용 예시:
+  * 공유 드라이브에서 파일 찾아서 PDF로 내보내기
+  * 안 읽은 메일 확인
+  * 캘린더 일정 생성
+  * 스프레드시트 데이터 읽기 및 업데이트
+주의사항:
+  * 인증이 필요한 도구이며, 에이전트별 설정 분리가 중요합니다.
+  * TOOLS.md에 적힌 환경변수와 인증 절차를 따라야 합니다.
+==== 2-2. MySQL 조회 ====
+도구 명칭: ''mysql''
+설명:
+  * 회사 내부 sales 데이터베이스를 조회할 때 사용하는 도구입니다.
+주요 기능:
+  * 테이블 조회
+  * 조건 검색
+  * 집계 조회
+  * CSV 추출
+중요 원칙:
+  * 읽기 전용으로 사용합니다.
+  * INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE 같은 변경 작업은 수행하지 않습니다.
+  * 쿼리 작성 전에는 반드시 스키마 문서를 확인합니다.
+==== 2-3. Python 스크립트 ====
+도구 명칭: ''python3''
+설명:
+  * 데이터 정리, 자동화, 간단한 프로그램 제작에 활용합니다.
+주요 활용:
+  * 텍스트/CSV/엑셀 처리
+  * API 호출
+  * 자동화 스크립트 작성
+  * 데이터 변환 및 가공
+관련 라이브러리 예시:
+  * ''pandas'' : 표 데이터 처리
+  * ''requests'' : 웹/API 요청
+  * ''bs4 (BeautifulSoup)'' : HTML 분석
+  * ''playwright'' : 브라우저 자동화
+==== 2-4. 웹 스크래핑 ====
+관련 도구 명칭: ''requests'', ''BeautifulSoup'', ''playwright''
+설명:
+  * 웹페이지 구조를 분석하고 필요한 데이터를 추출할 때 사용합니다.
+주요 기능:
+  * HTML 구조 분석
+  * 반복 데이터 추출
+  * CSV 저장
+  * JS 렌더링 페이지 수집
+주의사항:
+  * 고정 선택자를 무조건 신뢰하지 않고 매번 구조를 확인합니다.
+  * 과도한 요청은 피하고, robots.txt 및 정책을 고려합니다.
+==== 2-5. 인스타그램 수집 ====
+도구 명칭: ''instagrapi''
+설명:
+  * 인스타그램 게시물, 댓글, 계정 게시물 등을 수집할 때 활용할 수 있는 Python 기반 도구입니다.
+주요 기능:
+  * 게시물 댓글 수집
+  * 특정 계정 게시물 수집
+  * 해시태그 게시물 수집
+주의사항:
+  * 과도한 수집은 계정 제한 위험이 있으므로 속도와 양을 조절해야 합니다.
+===== 3. 비서가 주로 잘하는 작업 =====
+위 도구들을 조합하면 비서는 아래와 같은 업무를 안정적으로 지원할 수 있습니다.
+  * 문서 읽기 및 정리
+  * 위키 수정 및 초안 작성
+  * 인터넷 조사 및 자료 수집
+  * Google Workspace 문서/메일/시트 처리
+  * 파일 확인 및 기록 관리
+  * 운영 문서 업데이트
+  * 여러 자료를 기반으로 한 요약 정리
+  * 반복 작업의 부분 자동화
+  * 데이터 조회 및 정리
+===== 4. 운영상 주의할 작업 =====
+도구를 사용할 수 있다고 해서 모든 작업을 즉시 수행하는 것은 아닙니다.
+특히 아래 유형은 더 신중하게 판단해야 합니다.
+  * 파일 삭제
+  * 외부인 대상 메시지 발송
+  * 사용자를 대신한 공식적 표현
+  * 민감 정보 처리
+  * 데이터 변경 작업
+  * 되돌리기 어려운 변경
+===== 5. 요약 =====
+비서는 ''read'', ''write'', ''edit'', ''exec'' 같은 기본 도구와,
+''gog'', ''mysql'', ''python3'' 같은 외부 도구를 상황에 맞게 활용할 수 있습니다.
+따라서 단순 응답형 비서가 아니라, 실제 운영 업무를 보조하는 실행형 디지털 비서로 이해하면 됩니다.