Snowflake Intelligence 의 개요¶

Snowflake Intelligence 오브젝트 만들기¶

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

Snowflake Intelligence UISQL

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 오브젝트는 에이전트 목록을 포함하는 계정 수준 오브젝트입니다. 이 오브젝트에서 에이전트를 추가하거나 제거하여 사용자를 위해 선별된 에이전트 목록을 만들 수 있습니다. 에이전트 추가 또는 제거에 대한 자세한 내용은 Snowflake Intelligence 에서 에이전트의 가시성 구성하기 섹션을 참조하세요.

Snowflake Intelligence 권한 부여¶

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

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

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

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

  Copy

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

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

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

  Copy

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

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

  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;

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

사용자를 위해 Snowflake Intelligence 를 설정하려면 에이전트 권한을 구성해야 합니다. 에이전트에 필요한 권한에 대한 자세한 내용은 액세스 제어 요구 사항 섹션을 참조하세요.

Snowflake Intelligence 오브젝트로 에이전트 관리¶

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

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

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

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

에이전트 가시성 논리¶

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

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

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

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

Migrating from managing agent visibility with the SNOWFLAKE_INTELLIGENCE.AGENTS schema¶

If you’re using the SNOWFLAKE_INTELLIGENCE.AGENTS schema, your agents will continue to work, as detailed in 에이전트 가시성 논리. However, migrating to the Snowflake Intelligence object provides the following benefits:

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

• 권한 관리 개선: 에이전트를 생성하는 기능과 에이전트를 Snowflake 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 에 연결하기 전에 다음 전제 조건을 완료합니다.

• /user-guide/admin-security-privatelink`의 지침을 따라 AWS PrivateLink를 설정하거나 :doc:/user-guide/privatelink-azure`의 지침을 따라 Azure Private Link를 설정하세요.

• Ensure that a regionless-snowsight-privatelink-url is available by calling the SYSTEM$GET_PRIVATELINK_CONFIG function using the ACCOUNTADMIN system role.

Snowflake Intelligence 에 연결¶

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

• VPC 또는 VNET 엔드포인트의 DNS 이름에 다음 URL을 매핑하는 비공개 DNS 존 :code:`privatelink.snowflakecomputing.com`에 CNAME 레코드를 생성합니다.

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

  Copy

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

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

Copy

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

비공개 연결을 사용한 사용자 인증¶

비공개 연결을 사용하여 Snowflake Intelligence 에 액세스하는 사용자는 표준 Snowflake 인증 프로세스를 사용하며, 이를 위해서는 로그인 페이지에서 계정 식별자, 사용자 이름, 비밀번호를 제공해야 합니다.