Cortex Code CLI¶

Cortex Code CLI 설치¶

Cortex Code CLI를 설치하려면 터미널에서 다음 명령을 실행합니다.

curl -LsS https://ai.snowflake.com/static/cc-scripts/install.sh | sh

이 명령은 최신 버전의 Cortex Code CLI를 설치하는 설치 스크립트를 다운로드하고 실행합니다. 기본적으로 cortex 실행 파일은 ``~/.local/bin``에 설치됩니다.

Snowflake에 연결하기¶

Cortex Code CLI를 설치한 후 cortex 명령을 실행합니다. 설정 마법사가 Snowflake에 대한 연결 선택 또는 설정을 포함한 초기 구성 단계를 안내합니다.

첫 번째 프롬프트에는 ~/.snowflake/connections.toml 파일의 기존 연결에서 연결을 선택하거나 새 연결을 생성하라는 메시지가 표시됩니다.

• 기존 연결을 사용하려면 위쪽 및 아래쪽 화살표 키를 사용하여 목록에서 연결을 선택한 다음 Enter 키를 누릅니다.

• 새 연결을 생성하려면 아래쪽 화살표 키를 :ui:`More options*`이 강조 표시될 때까지 눌러 선택한 다음 Enter 키를 누릅니다. 프롬프트에 따라 Snowflake 계정 세부 정보를 입력합니다.

Cortex Code 사용 시작¶

연결되면 첫 번째 요청을 시도합니다.

What can I do with Cortex Code?

자연어 요청(예: “PII 태그가 있는 테이블을 찾아 줘” 또는 “SALES_MART.REVENUE용 Streamlit 앱을 만들어 줘”)을 입력하면 Cortex Code가 Snowflake 네이티브 스킬 및 사용자가 구성한 모든 MCP 도구를 오케스트레이션하여 요청을 이행하려고 시도합니다. MCP 도구 구성에 대한 자세한 내용은 모델 컨텍스트 프로토콜(MCP) 섹션을 참조하세요.

요청을 처리하면서 Cortex Code CLI는 터미널에 추론 단계와 작업을 표시합니다. 때때로 사용자에게 필요한 정보를 요청할 수 있습니다. 계획 모드인 경우 사용자에게 각 작업을 확인하도록 요청합니다.

What databases do I have access to?
List every table tagged PII = TRUE in ANALYTICS_DB
Show the lineage from RAW_DB.ORDERS to downstream dashboards

Write a query for top 10 customers by revenue
Add a 7-day moving average and show me the results
Explain why this query is slow and optimize it

Build a Streamlit dashboard on SALES_MART.REVENUE with filters for date and region
Create a dbt project to transform raw sales data

Use the @models/revenue.yaml semantic model to answer "What was revenue last month?"
Debug my semantic model at @models/revenue.yaml

전제 조건¶

Cortex Code CLI를 사용하려면 다음이 필요합니다.

• Cortex Code CLI로 사용하려는 데이터에 액세스하고 해당 데이터에 대한 작업을 수행하는 데 필요한 권한이 있는 Snowflake 사용자 계정. SNOWFLAKE.CORTEX_USER 데이터베이스 역할도 있어야 합니다.

• Snowflake 서버에 대한 네트워크 액세스 권한.

• 워크스테이션에 설치된 Snowflake CLI.

• 지원되는 플랫폼 중 하나:

  • Apple Silicon 또는 Intel 기반 macOS

  • Intel 기반 Linux

  • Intel 기반 Windows Subsystem for Linux(WSL)

  참고

  Snowflake는 수시로 다른 플랫폼에 대한 지원을 추가할 수 있습니다. 특정 플랫폼 요구 사항이 있는 경우 Snowflake 담당자에게 알려주세요.

• 플랫폼의 bash, zsh 또는 fish 셸에 대한 로컬 터미널 액세스 권한.

추가 구성 옵션, 문제 해결 및 고급 설정은 Cortex Code CLI 참조 섹션을 참조하세요.

모델 및 플랫폼 가용성¶

ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = 'AWS_US';

법적 고지¶

Cortex Code 구성에서 `모델 및 서비스 패스스루 약관 <https://www.snowflake.com/en/legal/optional-offerings/offering-specific-terms/ai-features/model-pass-through-terms/>`_에 제공된 모델을 사용하는 경우, 해당 모델의 사용에는 해당 페이지에 나와 있는 해당 모델에 대한 조항이 추가로 적용됩니다.

입력 및 출력의 데이터 분류는 다음 테이블과 같습니다.

자세한 내용은 Snowflake AI 및 ML 섹션을 참조하십시오.