Cortex Code CLI 에이전트 도구

Cortex Code는 파일 작업, 셸 명령, 웹 액세스 등을 위한 포괄적인 도구 세트에 액세스할 수 있습니다. 추가로 설치할 필요가 없습니다. 이러한 도구는 Cortex Code CLI에 내장되어 있으며 바로 사용할 수 있습니다. Cortex Code는 요청에 따라 적절한 도구를 자동으로 사용합니다. 수동으로 호출할 필요가 없습니다. 원하는 내용을 설명하기만 하면 됩니다. 예:

Read the first 10 lines of the file src/main.py
Search for TODO comments in all Python files
Execute a bash command to list running processes
Copy

사용자 지정 스킬을 생성할 때 스킬이 사용할 수 있는 도구를 지정해야 합니다. 스킬 섹션을 참조하십시오.

파일 도구

읽기

로컬 파일 시스템에서 파일 내용을 읽습니다. 다음을 지원합니다.

  • 줄 번호가 있는 텍스트 파일

  • 이미지(PNG, JPG 등) - 시각적으로 표시됨

  • PDFs - 페이지별 추출

  • Jupyter 노트북 - 출력이 있는 셀

  • 줄 범위: @file.py$10-20

쓰기

파일을 생성하거나 덮어씁니다. 다음을 지원합니다.

  • 상위 디렉터리를 자동으로 생성

  • 세션 통계에 대한 줄 변경 사항 추적

  • 기존 파일 덮어쓰기

편집

파일에서 검색하고 바꿉니다. 다음을 지원합니다.

  • 정확한 문자열 대체

  • 변경 전 diff 미리 보기

  • 전역 대체를 위해 replace_all 지원

Glob

패턴 일치로 파일을 찾습니다. 예제:

패턴

설명

**/*.py

모든 Python 파일

src/**/*.ts

src/ 디렉터리의 TypeScript 파일

**/test_*.py

Python 테스트 파일

!node_modules

패턴 제외

Grep

정규식을 사용하여 파일 내용을 검색합니다. 다음을 지원합니다.

  • 재귀 검색

  • 정규식 패턴

  • 바이너리 파일 감지

  • 출력 모드: 내용, 파일, 개수

셸 도구

Bash

셸 명령을 실행합니다. 다음을 지원합니다.

  • 스트리밍 출력

  • 백그라운드 실행(run_in_background)

  • 시간 제한 제어(기본값 2분, 최대 10분)

  • 샌드박스 런타임 지원

BashOutput

백그라운드 셸 프로세스에서 출력을 검색합니다.

  • 정규식으로 출력 필터링

  • 상태 확인

  • run_in_background와 함께 사용

KillShell

실행 중인 백그라운드 셸을 종료합니다.

에이전트 도구

RunSubagent

특수 작업을 위한 하위 에이전트를 시작합니다. 유형:

  • 범용: 모든 도구, 연구 작업

  • 탐색: 빠른 코드베이스 탐색

  • 계획: 아키텍처 및 계획

  • .cortex/agents/의 사용자 지정 에이전트

자세한 내용은 하위 에이전트 섹션을 참조하십시오.

AskUserQuestion

실행 중에 사용자에게 입력하라는 메시지를 표시합니다. 다음을 지원합니다.

  • 객관식 질문

  • 자유 형식 입력

  • 다중 선택 옵션

검토

품질 보증을 위해 검토 하위 에이전트를 시작합니다.

웹 도구

WebSearch

여러 엔진을 사용하여 웹을 검색합니다. 다음을 지원합니다.

  • 대체 검색 엔진

  • 스니펫 추출

  • 결과 캐싱

  • 30초 시간 제한

참고

WebSearch를 사용하려면 Snowsight 의 Cortex Code 설정에서 웹 검색을 활성화해야 합니다. 웹 검색 섹션을 참조하십시오.

WebFetch

웹 URLs에서 콘텐츠를 검색합니다. 다음을 지원합니다.

  • HTML에서 텍스트로 변환

  • 콘텐츠 추출

  • 최대 10,000자

  • 30초 시간 제한

Snowflake 도구

SnowflakeSqlExecute

Snowflake에서 SQL 쿼리를 실행합니다. 다음을 지원합니다.

  • 권한 확인

  • 결과 캐싱

  • 토큰 새로 고침

  • 대규모 결과 오프로딩

SnowflakeObjectSearch

데이터베이스 오브젝트에 대한 의미 체계 검색입니다.

검색

테이블, 뷰, 스키마, 데이터베이스, 함수

반환

이름, 열, 설명

SnowflakeProductDocs

Snowflake 설명서를 검색합니다. 지원되는 카테고리는 다음과 같습니다.

  • 사용자 가이드

  • SQL 참조

  • 개발자 가이드

  • Cortex Code 항목

ReflectSemanticModel

Cortex Analyst 의미 체계 모델의 유효성을 검사합니다. 유효성 검사 단계는 다음과 같습니다.

  • 파일 존재

  • YAML 구문

  • 스키마 유효성 검사

  • 서버 측 유효성 검사

SnowflakeMultiCortexAnalyst

Cortex Analyst 쿼리를 실행합니다. 다음을 지원합니다.

  • 자연어를 SQL로 변환

  • 의미 체계 모델 지원

  • 검증된 쿼리 검색

데이터 도구

DataDiff

데이터베이스 및 테이블 간의 데이터를 비교합니다. 다음을 지원합니다.

  • Snowflake 연결 처리

  • 계정 식별자 파생

  • 300초 시간 제한

NotebookExecute

Jupyter 노트북을 실행합니다. 다음을 지원합니다.

  • 시간 제한 제어

  • 커널 관리

  • 매개 변수 삽입

  • 사용자 지정 Python 환경

NotebookEdit

Jupyter 노트북 셀을 편집합니다. 지원되는 모드는 다음과 같습니다.

  • 바꾸기: 셀 내용 바꾸기

  • 삽입: 새 셀 추가

  • 삭제: 셀 제거

계획 모드 도구

EnterPlanMode

복잡한 작업을 위한 계획 모드를 요청합니다. 다음을 지원합니다.

  • 사용자 승인 워크플로

  • 다단계 작업을 위한 자동 호출

ExitPlanMode

사용자에게 계획을 제시하고 계획 모드를 종료합니다. 다음을 지원합니다.

  • 계획 확인

  • 스트리밍 제어

메모리 도구

메모리

세션 전체에서 정보를 저장하고 검색합니다. 지원되는 명령은 다음과 같습니다.

  • 뷰: 저장된 메모리 보기

  • 생성: 새 메모리 저장

  • str_replace: 메모리 업데이트

  • 삽입: 메모리에 추가

  • 삭제: 메모리 제거

  • 이름 바꾸기: 메모리 파일 이름 바꾸기

참고

CORTEX_ENABLE_MEMORY 환경 변수를 설정하여 메모리 도구를 활성화해야 합니다.

권한 수준

도구마다 권한 요구 사항이 다릅니다.

레벨

도구

동작

안전

읽기, Glob, Grep

자동 승인됨

낮음

쓰기(새 파일)

일반적으로 자동 승인됨

Medium

편집, Bash(안전)

확인 모드에서 메시지 표시

높음

Bash(위험), SQL 쓰기

항상 메시지 표시

중요

rm -rf, sudo

추가 확인

자세한 내용은 보안 섹션을 참조하세요.