|sf-intelligence|의 개요

|sf-intelligence|를 사용하여 조직 내 데이터를 기반으로 인사이트를 확보하고 조치를 취합니다. |sf-intelligence|를 사용하면 다음을 수행할 수 있습니다.

  • 자연어를 사용하여 차트를 만들고 즉각적인 답변을 얻습니다. 기술적 전문 지식 없이도 사용자 지정 대시보드를 기다릴 필요 없이 추세를 발견하고 데이터를 분석할 수 있습니다.

  • 정형 데이터와 비정형 데이터가 함께 포함된 수천 개의 데이터 소스를 액세스하고 분석합니다. 스프레드시트, 문서, 이미지, 데이터베이스의 인사이트를 동시에 연결할 수 있습니다.

|sf-intelligence|는 에이전트를 사용하며, 이는 하나 이상의 의미 체계 뷰, 의미 체계 모델, Cortex Search Service 및 도구와 연결된 AI 모델입니다. 에이전트는 질문에 답변하고, 인사이트를 제공하며, 시각화를 보여줄 수 있습니다. |sf-intelligence|는 Cortex AISQL, |cortex-analyst| 및 Cortex Search를 기반으로 합니다.

다음 섹션을 사용하여 |sf-intelligence|를 설정하고 데이터 활용을 시작합니다. |sf-intelligence|에 대한 빠른 시작 가이드를 보려면 `Snowflake Intelligence 시작하기<https://quickstarts.snowflake.com/guide/getting-started-with-snowflake-intelligence/index.html>`_ 섹션을 참조하세요.

지원되는 모델 및 지역

|sf-intelligence|는 다음 모델을 지원합니다. 계정에 해당 모델에 대한 액세스 권한이 있는 한 이러한 모델을 사용할 수 있습니다. 자세한 내용은 모델 액세스 제어 섹션을 참조하십시오.

  • Claude 4.5

  • Claude 4.0

  • Claude 3.7

  • Claude 3.5

  • GPT 5

  • GPT 4.1

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

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

  • AWS US - In AWS, Claude 4+ offers the highest quality and best speed performance. We recommend that you set up Cortex Cross-region inference for aws_us to use Claude 4 and get the best performance. Without Cortex Cross-region inference, you are restricted to using Claude 3.5 in aws_us.

  • Azure US - If you are using Snowflake Intelligence in East US, you can use GPT 4.1+ without Cortex Cross-region inference. Other region and model combinations require Cortex Cross-region inference setup for azure_us.

  • AWS EU - You can use Claude 4+ in this region as long as you configure Cortex Cross-region inference for aws_eu.

  • AWS APJ - You can use Claude 4+ in this region as long as you configure Cortex Cross-region inference for aws_apj.

Snowflake Intelligence 설정하기

To set up Snowflake Intelligence for your users, do the following:

참고

  • ACCOUNTADMIN 역할은 Snowflake Intelligence 오브젝트를 생성하는 데 필요한 CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT 권한이 있는 유일한 역할입니다.

Create a Snowflake Intelligence object

Snowflake Intelligence UI 또는 SQL 중 하나를 사용하여 Snowflake Intelligence 오브젝트를 생성할 수 있습니다.

Snowflake는 처음으로 Snowflake Intelligence 설정을 수정할 때 Snowflake Intelligence 오브젝트를 자동으로 생성합니다. UI를 사용하여 생성된 경우 Snowflake Intelligence 오브젝트의 이름은 :code:`SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT`가 됩니다. 다른 이름을 지정할 수 없습니다.

  1. Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 AI & ML » Agents 를 선택합니다.

  3. Snowflake Intelligence 탭을 선택합니다.

  4. Open settings 를 선택합니다. Snowflake Intelligence 오브젝트가 아직 없는 경우 자동으로 생성됩니다. 그런 다음 오브젝트에 에이전트를 추가할 수 있습니다.

에이전트 추가

Snowflake Intelligence 오브젝트는 에이전트 목록을 포함하는 계정 수준 오브젝트입니다. 이 오브젝트에서 에이전트를 추가하거나 제거하여 사용자를 위해 선별된 에이전트 목록을 만들 수 있습니다. 에이전트 추가 또는 제거에 대한 자세한 내용은 Configure the visibility of agents in Snowflake Intelligence 섹션을 참조하세요.

Grant Snowflake Intelligence privileges

다음 권한은 Snowflake Intelligence 오브젝트에 대한 액세스를 제어합니다.

  • CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT: Snowflake Intelligence 오브젝트를 생성할 수 있는 계정 수준 권한입니다. 이 권한은 기본적으로 ACCOUNTADMIN에 부여됩니다.

    이 권한을 다른 역할에 부여하려면 다음 명령을 실행합니다.

    GRANT CREATE SNOWFLAKE INTELLIGENCE ON ACCOUNT TO ROLE <role_name>;
    Copy

  • USAGE: 사용자가 Snowflake Intelligence 오브젝트에 추가된 에이전트 목록을 보고 구성 값을 확인할 수 있는 오브젝트 수준 권한입니다.

    To grant this privilege, run the following command:

    GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE <role_name>;
    Copy

  • ALTER: 사용자가 Snowflake Intelligence 오브젝트에서 에이전트를 추가하거나 제거하고 구성 값을 변경할 수 있는 오브젝트 수준 권한입니다. 계정 관리자에게는 기본적으로 이 권한이 있습니다.

    To grant this privilege, run the following command:

    GRANT MODIFY ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE <role_name>;
    Copy

Snowflake Intelligence 오브젝트가 모든 사용자에게 표시되도록 하려면 PUBLIC 역할에 오브젝트에 대한 USAGE 권한을 부여합니다.

GRANT USAGE ON SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT TO ROLE PUBLIC;
Copy

ADMIN에게는 Snowflake Intelligence 오브젝트에 대한 ALTER 권한도 있습니다. 이를 통해 오브젝트에서 에이전트를 추가하거나 제거하여 사용자를 위해 선별된 에이전트 목록을 만들 수 있습니다.

To set up Snowflake Intelligence for your users, you must configure agent privileges. For information about the privileges required for agents, see 액세스 제어 요구 사항.

중요

기본적으로 |sf-intelligence|는 사용자의 기본 역할과 기본 웨어하우스를 사용합니다. |sf-intelligence|를 사용하도록 다른 사용자를 초대할 때는 해당 사용자가 기본 역할과 웨어하우스를 설정했는지 확인합니다.

참고

|sf-intelligence|의 모든 쿼리는 사용자의 자격 증명을 사용합니다. 사용자와 연관된 모든 역할 기반 액세스 제어 및 데이터 마스킹 정책은 에이전트와의 모든 상호 작용 및 대화에도 자동으로 적용됩니다.

에이전트 생성하기

시작하려면 사용자가 |sf-intelligence|에서 상호 작용할 수 있는 에이전트를 만듭니다. 에이전트 생성에 대한 자세한 내용은 에이전트 생성하기 섹션을 참조하세요.

Configure the visibility of agents in Snowflake Intelligence

Snowflake Intelligence 오브젝트를 만들지 않고 에이전트를 추가하지 않은 경우 사용자는 계정에서 액세스할 수 있는 모든 에이전트를 볼 수 있습니다.

최적의 환경을 위해 Snowflake Intelligence 오브젝트에 에이전트를 추가하여 선별된 에이전트 목록을 만듭니다. 이를 통해 모든 사용자를 위한 Snowflake Intelligence 인터페이스에 표시할 에이전트를 제어할 수 있습니다.

Snowflake Intelligence 오브젝트가 계정에 생성되었는지 확인하려면 다음 명령을 사용합니다.

SHOW SNOWFLAKE INTELLIGENCES;
Copy

참고

계정에는 하나의 Snowflake Intelligence 오브젝트만 존재할 수 있습니다.

Managing agents with the Snowflake Intelligence object

Snowflake Intelligence 오브젝트에 에이전트를 추가하려면 다음 명령을 사용합니다.

ALTER SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT ADD AGENT <db.schema.agent_name>;
Copy

Snowflake Intelligence 오브젝트에서 에이전트를 제거하려면 다음 명령을 사용합니다.

ALTER SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT DROP AGENT <db.schema.agent_name>;
Copy

참고

올바른 데이터베이스 및 스키마 권한이 있는 모든 사용자 또는 관리자는 에이전트를 생성할 수 있습니다. 그러나 에이전트는 Snowflake Intelligence 오브젝트에 자동으로 추가되지 않습니다. 사용자는 Snowflake Intelligence 오브젝트에 에이전트를 추가하려면 Snowflake Intelligence 오브젝트에 대한 ALTER 권한 및 에이전트에 대한 USAGE 권한이 있어야 합니다.

관리자는 Snowflake Intelligence 오브젝트에 에이전트를 추가하려면 에이전트에 대한 USAGE 권한이 있어야 합니다.

에이전트 가시성 논리

|sf-intelligence|는 다음 논리를 사용하여 사용자에게 표시되는 에이전트를 결정합니다.

  1. Snowflake Intelligence 오브젝트가 존재하고 하나 이상의 에이전트를 포함하는 경우, 사용자는 이 선별된 목록에서 액세스 권한이 있는 개별 에이전트를 볼 수 있습니다.

  2. Snowflake Intelligence 오브젝트가 존재하지만 에이전트 AND가 포함되지 않고 SNOWFLAKE_INTELLIGENCE.AGENTS 스키마가 하나 이상의 에이전트와 함께 존재하는 경우, 사용자는 SNOWFLAKE_INTELLIGENCE.AGENTS 스키마의 에이전트를 볼 수 있습니다. 이를 통해 |sf-intelligence|는 아직 에이전트를 마이그레이션하지 않은 경우 중단되지 않습니다.

  3. Snowflake Intelligence 오브젝트가 존재하지 않거나 에이전트 AND가 포함되지 않고 SNOWFLAKE_INTELLIGENCE.AGENTS 스키마가 존재하지 않거나 에이전트가 포함되지 않은 경우, 사용자는 계정에서 액세스할 수 있는 모든 에이전트를 볼 수 있습니다.

더 이상 사용되지 않는 SNOWFLAKE_INTELLIGENCE.AGENTS 스키마에서 마이그레이션하기

중요

SNOWFLAKE_INTELLIGENCE.AGENTS 스키마는 더 이상 사용되지 않습니다. 현재 이 스키마를 사용 중인 경우 Snowflake Intelligence 오브젝트로 마이그레이션하는 것이 좋습니다.

SNOWFLAKE_INTELLIGENCE.AGENTS 스키마를 사용 중인 경우 에이전트는 계속 작동합니다. 그러나 Snowflake Intelligence 오브젝트로의 마이그레이션은 다음과 같은 이점을 제공합니다.

  • 유연성: 단일 스키마에 에이전트를 중앙 집중화할 필요 없이 계정의 어느 곳에서나 에이전트를 생성하고 관리할 수 있습니다.

  • 권한 관리 개선: 에이전트를 생성하는 기능과 에이전트를 |sf-intelligence|에 게시하는 기능을 분리합니다.

  • 이름 충돌 방지: SNOWFLAKE_INTELLIGENCE.AGENTS 스키마 이름과의 잠재적 충돌을 제거합니다.

  • 더 쉬워진 에이전트 가시성 관리: 단일 오브젝트를 사용하여 모든 사용자에게 표시되는 에이전트를 제어합니다.

에이전트를 마이그레이션하기 전에 Snowflake Intelligence 오브젝트를 생성했는지 확인해야 합니다. Snowflake Intelligence 오브젝트 생성에 대한 자세한 내용은 Snowflake Intelligence 설정하기 섹션을 참조하세요.

오브젝트를 생성한 후 다음 코드를 사용하여 에이전트를 Snowflake Intelligence 오브젝트에 추가합니다.

ALTER SNOWFLAKE INTELLIGENCE SNOWFLAKE_INTELLIGENCE_OBJECT_DEFAULT ADD AGENT SNOWFLAKE_INTELLIGENCE.AGENTS.<agent_name>;
Copy

마이그레이션 후 SNOWFLAKE_INTELLIGENCE 데이터베이스 또는 AGENTS 스키마를 삭제하거나 이름을 바꿀 수 있습니다. 자세한 내용은 ALTER SCHEMA 섹션을 참조하십시오.

Configure Snowflake Intelligence with private connectivity

Snowflake Intelligence supports integration with AWS Privatelink and Azure Private Link to establish a private connection between your Virtual Private Cloud (VPC) or virtual network (VNet) and Snowflake Intelligence. Configuring private connectivity requires setting up the correct DNS resolution to direct traffic to the Snowflake Intelligence service through this private connection.

Note that AWS PrivateLink and Azure Private Link are not services provided by Snowflake. They are an AWS service and Microsoft service, respectively, that Snowflake supports to use with your Snowflake account.

전제 조건

Complete the following prerequisites before connecting to Snowflake Intelligence with private connectivity.

중요

Snowflake Intelligence exclusively uses the regionless URL format for private connectivity access. Unlike other private connectivity URLs used for Snowflake, you should not include a region identifier, such as us-west-2, in the hostname. Any attempts to connect using a region-specific URL will result in a failure.

|sf-intelligence|에 연결

Snowflake Intelligence가 하위 도메인을 사용하도록 DNS를 구성하여 |sf-intelligence|에 연결합니다.

  • Create a CNAME record in your private DNS zone, privatelink.snowflakecomputing.com, that maps the following URL to the DNS name of your VPC or VNET endpoint.

    si-<org-acct>.privatelink.snowflakecomputing.com
    Copy

구성이 완료되면 네트워크 내 사용자는 다음 URL로 이동하여 |sf-intelligence|에 액세스할 수 있습니다.

https://si-<org-acct>.privatelink.snowflakecomputing.com
Copy

이 연결은 비공개 연결을 통해 안전하게 라우팅됩니다.

User authentication with private connectivity

Users accessing Snowflake Intelligence with private connectivity use the standard Snowflake authentication process, which requires them to provide their account identifier, username, and password on the login page.

Snowflake 관리 MCP 서버를 사용하여 에이전트에 연결하기

Snowflake에서 생성한 모든 에이전트 또는 에이전트가 연결되는 도구에는 다른 시스템이 MCP에 연결할 수 있는 관리형 엔드포인트가 있을 수 있습니다. 이는 Claude Desktop, Langgraph 및 :doc:`MCP</user-guide/snowflake-cortex/cortex-agents-mcp>`와 통합되는 기타 도구 등의 도구를 위한 원활한 통합 계층을 제공합니다.

MCP 서버는 AI 에이전트가 Cortex Analyst 및 Cortex Search와 같은 도구를 검색 및 호출하고 필요한 데이터를 검색할 수 있는 표준 기반 인터페이스를 제공합니다. 자세한 내용은 Snowflake 관리형 MCP 서버 섹션을 참조하십시오.

Update Snowflake Intelligence settings

사용자가 Cortex Agent와 상호 작용하는 Snowflake Intelligence 인터페이스에 대한 설정을 수정할 수 있습니다.

  1. Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 AI & ML » Agents 를 선택합니다.

  3. Snowflake Intelligence 탭을 선택합니다.

  4. Select Open settings.

  5. General settings 섹션에서 다음 설정을 수정할 수 있습니다.

    • Brand display name: The name of the Snowflake Intelligence interface that is displayed to users.

    • Welcome message: 사용자가 처음 Snowflake Intelligence 인터페이스를 열 때 표시되는 메시지입니다.

    • Primary domain: 사용자가 |sf-intelligence|에 액세스하는 데 사용하는 도메인입니다.

  6. Save 를 선택합니다.

  7. Custom appearance 섹션에서 다음 설정을 수정할 수 있습니다.

    • Color theme: Snowflake Intelligence 인터페이스의 색상 테마입니다. 사용자 지정 기본 색상을 16진수 형식으로 제공할 수 있습니다.

    • Full-length logo 및 Compact logo: 탐색 창이 확장되거나 축소될 때 각각 표시되는 로고입니다.

    • Favicon: 브라우저 탭에 표시되는 아이콘입니다.

  8. Save 를 선택합니다.

문제 해결하기

table / search service / stage does not exist 오류가 발생하면 권한 문제가 있을 수 있습니다. 다음 권한이 올바르게 설정되었는지 확인합니다.

  • 각 의미 체계 모델의 경우:

    • 사용자의 기본 역할에는 의미 체계 모델 스테이지 또는 뷰의 데이터베이스 및 스키마, 그리고 테이블에 대한 USAGE 권한이 부여됩니다.

    • If using the older semantic model, the user’s default role is granted READ on the stage that stores the semantic model file.

    • If using a semantic view, the user’s default role is granted REFERENCES on the semantic view.

    • 사용자의 기본 역할에는 의미 체계 모델 또는 뷰에 정의된 각 테이블에 대한 SELECT 권한이 부여됩니다.

  • 각 Cortex Search Service의 경우:

    • 사용자의 기본 역할에는 Cortex Search Service의 데이터베이스 및 스키마에 대한 USAGE 권한이 부여됩니다.

    • 사용자에게는 Cortex Search Service에 대한 USAGE 권한이 부여됩니다.

언어: 한국어