참조

이 페이지에서는 Snowflake Intelligence 작업에 대한 참조 정보를 제공합니다. 다음 개념을 다룹니다.

  • Cortex Agent를 생성, 관리, 상호 작용하는 데 사용할 수 있는 REST API 엔드포인트 및 SQL 명령

  • 지원되는 AI 모델 및 해당 리전별 가용성

  • 모델 사용 및 데이터 분류에 대한 법적 고지

SQL 명령 및 API 참조

Snowflake는 Snowflake Intelligence 와 함께 사용할 Cortex Agent를 생성하고 상호 작용할 수 있는 다음과 같은 프로그래밍 방식의 메서드를 제공합니다.

Cortex Agent 오브젝트 REST API

Cortex Agent 오브젝트 REST API는 Snowflake Intelligence 와 통합되는 AI 기반 애플리케이션을 구축하기 위한 포괄적인 엔드포인트 세트를 제공합니다. REST API를 사용하여 에이전트 오브젝트를 관리하고 데이터와의 상호 작용을 오케스트레이션할 수 있습니다.

에이전트 관리 작업

에이전트 오브젝트 REST API는 Cortex Agent 오브젝트 관리를 위해 다음 작업을 지원합니다.

작업

엔드포인트

설명

만들기

POST /api/v2/databases/{database}/schemas/{schema}/agents

지정된 특성과 도구 구성을 사용하여 새 Cortex Agent를 생성합니다.

설명

GET /api/v2/databases/{database}/schemas/{schema}/agents/{name}

기존 에이전트의 구성 및 메타데이터를 검색합니다.

업데이트

PUT /api/v2/databases/{database}/schemas/{schema}/agents/{name}

기존 에이전트의 구성, 도구 또는 지침을 수정합니다.

목록

GET /api/v2/databases/{database}/schemas/{schema}/agents

필터링 옵션과 함께 지정된 데이터베이스 및 스키마의 모든 에이전트를 나열합니다.

삭제

DELETE /api/v2/databases/{database}/schemas/{schema}/agents/{name}

계정에서 에이전트를 제거합니다.

요청 매개 변수, 응답 스키마, 예제를 포함한 자세한 API 사양은 Cortex Agents REST API 섹션을 참조하세요.

에이전트 SQL 명령

Snowflake는 Snowflake Intelligence 와 함께 사용할 Cortex Agent 오브젝트를 생성하고 관리하는 SQL 명령을 제공합니다.

에이전트 관리 명령

다음 SQL 명령은 Cortex Agent 관리에 사용할 수 있습니다.

명령

설명

CREATE AGENT

새 Cortex Agent를 생성하거나 기존 에이전트를 지정된 특성, 프로필 설정 및 YAML 사양으로 바꿉니다.

DESCRIBE AGENT

기존 에이전트에 대한 전체 구성, 사양 및 메타데이터를 검색합니다.

SHOW AGENTS

필터링 및 페이지 매김 옵션과 함께 액세스 권한이 있는 모든 Cortex Agent를 나열합니다.

DROP AGENT

현재 또는 지정된 스키마에서 에이전트를 제거합니다.

자세한 SQL 구문, 매개 변수, 예제는 :doc:`Cortex Agent 명령 </sql-reference/commands-cortex-agent>`을 참조하세요.

지원되는 모델 및 지역

Snowflake Intelligence 는 label-cortex_agents_models`에 나열된 모델을 지원합니다. 계정에 해당 모델에 대한 액세스 권한이 있는 한 이러한 모델을 사용할 수 있습니다. 자세한 내용은 :ref:`label-cortex_llm_access_control 섹션을 참조하십시오.

에이전트를 생성할 때 모델에 대해 :ui:`Auto`를 선택하는 것이 좋습니다. 이를 통해 Snowflake Intelligence 는 계정에 가장 적합한 모델을 자동으로 선택하고 새 모델을 사용할 수 있게 되면 자동으로 개선합니다.

목록에 있는 모델은 모든 리전<label-cortex_llm_availability>`에서 제공되지 않을 수 있지만, Cortex 리전 간 추론을 사용하여 모든 클라우드 또는 리전에서 |sf-intelligence| 를 사용할 수 있습니다. 여기에는 클라우드 및 모델이 제공되지 않는 리전도 포함됩니다. Cortex 리전 간 추론 구성에 대한 자세한 내용은 :doc:/user-guide/snowflake-cortex/cross-region-inference` 섹션을 참조하세요.

  • AWS US - AWS에서 Claude 4는 최고 품질과 최고의 속도 성능을 제공합니다. Cortex 리전 간 추론 기능이 없으면, Claude 3.5는 :code:`aws_us`에서만 사용 가능합니다.

  • Azure US - 동부 US에서 |sf-intelligence|를 사용 중이라면, Cortex 리전 간 추론 없이 GPT 4.1을 사용할 수 있습니다. :code:`azure_us`의 경우 다른 리전 및 모델 조합에는 Cortex 리전 간 추론 설정이 필요합니다.

  • AWS EU - :code:`aws_eu`에 Cortex 리전 간 추론을 구성하는 경우 이 리전에서 Claude 4를 사용할 수 있습니다.

  • AWS APJ - :code:`aws_apj`에 Cortex 리전 간 추론을 구성하는 경우 이 리전에서 Claude 4를 사용할 수 있습니다.