외부 에이전트 수정

외부 에이전트 수정 (ALTER EXTERNAL AGENT)

이 기능은 중화인민공화국에서는 사용할 수 없어요.

기존 외부 에이전트의 속성을 수정해요. 외부 에이전트는 AI Observability와 함께 사용하기 위해 Snowflake에서 생성형 AI 애플리케이션을 나타내요.

참고:

출처: 문서

ALTER EXTERNAL AGENT [ IF EXISTS ]  SET
  [ COMMENT = '' ]

ALTER EXTERNAL AGENT [ IF EXISTS ]  ADD VERSION

name

external agent를 변경할 식별자(즉, 이름)를 지정하는 String이에요.

식별자에 공백이나 특수 문자가 포함되어 있으면 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶인 식별자는 대소문자를 구분하기도 해요.

자세한 내용은 식별자 요구 사항을 참고하세요.

SET ...

external agent에 대해 하나 이상의 지정된 속성을 설정해요.

COMMENT = comment

external agent에 대한 설명을 지정해요.

ADD VERSION version_name

external agent에 새 버전을 추가해요. 버전은 애플리케이션의 서로 다른 구현을 나타내며, 예를 들어 서로 다른 리트리버, 프롬프트, LLM 또는 추론 구성 등을 의미해요.

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.

권한	객체	설명
OWNERSHIP	External Agent	OWNERSHIP은 객체에 대한 특별한 권한으로, 객체를 생성한 역할에 자동으로 부여되지만, 소유 역할(또는 MANAGE GRANTS 권한이 있는 역할)이 GRANT OWNERSHIP 명령을 사용하여 다른 역할로 이전할 수도 있어요.

스키마의 객체를 작업하려면 상위 데이터베이스에 대한 권한이 하나 이상, 상위 스키마에 대한 권한이 하나 이상 필요해요.

지정된 권한 집합으로 사용자 지정 역할을 만드는 방법은 을 참고하세요.

보호 가능한 객체에 대해 SQL 작업을 수행하기 위한 역할 및 권한 부여에 대한 일반적인 정보는 액세스 제어 개요를 참고하세요.

고객은 Snowflake 서비스를 사용할 때 (User 객체의 경우를 제외하고) 개인 데이터, 민감한 데이터, 수출 통제 데이터 또는 기타 규제 대상 데이터를 메타데이터로 입력하지 않도록 해야 해요. 자세한 내용은 Snowflake의 메타데이터 필드를 참고하세요.

external agent에 comment 설정하기:

ALTER EXTERNAL AGENT my_rag_app SET COMMENT = 'RAG application for customer support';

external agent에 버전 추가하기:

ALTER EXTERNAL AGENT my_rag_app ADD VERSION "v2";