내장 도구 참조
AI가 사용하는 도구의 전체 목록과 권한 동작입니다. 도구는 AI 엔진의 등록 코드 기준입니다.
AI는 대화 중 이 도구들을 호출해 작업합니다. 도구를 쓰기 전에 권한 판단을 거칩니다.
파일·검색
| 도구 | 설명 | 기본 권한 |
|---|---|---|
read | 파일 읽기. PDF 등 문서는 document_*로 읽도록 안내됩니다. | 허용. .env, .env.*는 확인(.env.example 허용) |
glob | 파일 이름 패턴 검색 | 허용 |
grep | 파일 내용 검색 | 허용 |
edit | 파일 편집(문자열 치환) | 확인 |
write | 파일 생성·덮어쓰기 | 확인 |
apply_patch | 패치 방식의 파일 편집 | 확인 |
lsp | 언어 서버 조회(실험 기능) | 허용(제공 시) |
注記
모델에 따라 편집 도구가 달라집니다. GPT 계열 모델(gpt-, 단 oss·gpt-4 제외)은 apply_patch를, 그 외 모델은 edit/write를 사용합니다. 권한 화면에서는 모두 파일편집으로 표시됩니다.
실행
| 도구 | 설명 | 기본 권한 |
|---|---|---|
bash(shell) | 셸 명령 실행. 명령은 분류기로 분석되며 읽기 전용 명령은 묻지 않습니다. | 확인(읽기 전용 제외) |
웹
| 도구 | 설명 | 기본 권한 |
|---|---|---|
webfetch | URL 내용 가져오기 | 확인 |
문서
| 도구 | 설명 | 제공 조건 |
|---|---|---|
document_overview | 문서 크기·목차 확인 | PDF/Office/HWP 처리 가능 시 |
document_read | 범위 지정 읽기 | 위와 동일 |
document_search | 문서 내 검색 | 위와 동일 |
document_inspect | 요소 주소·속성 확인 | Office/HWP |
document_create | 새 문서 생성 | Office/HWP |
document_help | 형식별 편집 문법·디자인 규칙 안내 | Office/PDF 편집/HWP |
document_edit | 문서 수정(PDF는 페이지 단위) | Office/PDF 편집/HWP |
document_vision | 헬피비전 도큐먼트 OCR(PDF 전용, 파일을 엘리스 문서 서비스로 전송) | 항상(허용) |
자세한 사용법은 파일 첨부와 문서 작업을 참고하세요.
작업 관리
| 도구 | 설명 | 기본 권한 |
|---|---|---|
todowrite | 작업 목록 관리 | primary 에이전트 허용, 서브에이전트 거부 |
question | 사용자에게 질문 | build·plan 허용, 서브에이전트 거부 |
plan_enter / plan_exit | 계획 모드 전환 | 사용자 확인만 가능(자동 판정 제외) |
task | 서브에이전트 호출 | primary 허용, 서브에이전트 거부 |
skill | 스킬 로드 | 허용(customize-opencode 제외) |
결과 표시
| 도구 | 설명 | 기본 권한 |
|---|---|---|
present_files | 완성된 파일을 대화 안에 파일 카드로 표시. 파일을 읽거나 바꾸지 않습니다. | 허용(묻지 않음) |
확장
| 도구 | 설명 |
|---|---|
| MCP 도구 | 연결된 MCP 서버가 제공하는 도구. 기본 확인 대상 |
| 플러그인 도구 | 엔진 플러그인이 추가한 도구 |
execute | 코드 모드(실험 기능, 기본 비활성) |
권한 키 정리
| 권한 키 | 대상 |
|---|---|
read, edit, bash, glob, grep, list, lsp | 해당 도구 |
webfetch, websearch | 웹 도구 |
task | 서브에이전트 호출(패턴 = 에이전트 이름) |
skill | 스킬 로드(패턴 = 스킬 이름) |
external_directory | 프로젝트 밖 경로 접근 |
todowrite, question | 작업 목록, 사용자 질문 |
doom_loop | 같은 호출의 반복 감지(항상 확인) |
guard | 보호 파일·위험 명령(엘리스 추가, 항상 확인) |
network | 네트워크 경로·패키지 설치(엘리스 추가, 항상 확인) |