DESCRIBE EXTERNAL AGENT
DESCRIBE EXTERNAL AGENT
DESCRIBE EXTERNAL AGENT 명령은 외부 에이전트(external agent)의 속성을 설명하는 명령이에요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.
본문
외부 에이전트의 속성을 설명하는 명령입니다. 외부 에이전트는 AI 관찰 가능성(AI Observability)과 함께 사용하기 위해 Snowflake에서 생성형 AI 애플리케이션을 나타내요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.
관련 명령: CREATE EXTERNAL AGENT, ALTER EXTERNAL AGENT, DROP EXTERNAL AGENT, SHOW EXTERNAL AGENTS
Syntax
{ DESC | DESCRIBE } EXTERNAL AGENT <name>
Parameters
name— 설명할 외부 에이전트의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요. 자세한 내용은 Identifier requirements 문서를 참고하세요.
Output (출력)
명령 출력은 다음 컬럼으로 외부 에이전트 속성과 메타데이터를 제공해요.
Access control requirements (접근 제어 요구 사항)
이 SQL 명령을 실행하는 데 사용되는 역할은 최소한 다음 권한 중 하나를 보유해야 해요.
스키마의 객체를 조작하려면 상위 데이터베이스에 대한 권한과 상위 스키마에 대한 권한이 각각 최소 하나씩 필요합니다. 지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.
Examples (예제)
외부 에이전트를 설명해 봅시다.
DESCRIBE EXTERNAL AGENT my_rag_app;
특정 데이터베이스와 스키마의 외부 에이전트를 설명해 봅시다.
DESCRIBE EXTERNAL AGENT mydb.myschema.my_rag_app;