ALTER AGENT¶

기존 :doc:`Cortex Agent </user-guide/snowflake-cortex/cortex-agents>`의 속성 또는 사양을 수정합니다.

참고 항목:: CREATE AGENT, DESCRIBE AGENT, DROP AGENT, SHOW AGENTS

구문¶

ALTER AGENT <name> SET
  [ COMMENT = '<string>' ]
  [ PROFILE = '<string>' ]

ALTER AGENT <name> MODIFY LIVE VERSION SET SPECIFICATION = <specification>

Copy

필수 매개 변수¶

name

변경할 에이전트의 식별자(예: 이름)를 지정하는 문자열입니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

선택적 매개 변수¶

SET ...

에이전트에 대해 하나 이상의 지정된 속성 또는 매개 변수를 설정합니다.

COMMENT = comment

에이전트에 대한 설명을 지정합니다.

PROFILE = string

표시 이름, 아바타, 색상과 같은 에이전트 프로필 정보를 지정합니다. 다음과 같이 문자열 형식을 지정합니다.

'{"display_name": "<display_name>", "avatar": "<avatar>", "color": "<color>"}'

Copy

다음 테이블은 문자열의 키-값 페어를 설명합니다.

키	타입	설명
`display_name`	String	에이전트의 표시 이름입니다.
`avatar`	String	아바타 이미지 파일 이름 또는 식별자입니다.
`color`	String	에이전트의 색상 테마(예: “파란색”, “녹색”, “빨간색”)입니다.

MODIFY LIVE VERSION SET SPECIFICATION specification

에이전트에 대한 대체 설정을 포함하는 VARCHAR 값을 YAML 또는 JSON 오브젝트로 지정합니다.

달러 기호로 묶인 리터럴: $$ … $$
작은따옴표로 묶인 문자열: ‘…’

사양 오브젝트의 최대 길이는 100,000바이트입니다.

중요

새 사양은 기존 사양을 완전히 대체합니다. 새 사양에 포함되지 않은 필드는 제거됩니다.

YAML 오브젝트의 구조는 다음과 같아야 합니다.

models:
  orchestration: <model_name>

orchestration:
  budget:
      seconds: <number_of_seconds>
      tokens: <number_of_tokens>

instructions:
  response: '<response_instructions>'
  orchestration: '<orchestration_instructions>'
  system: '<system_instructions>'
  sample_questions:
      - question: '<sample_question>'
        answer: '<sample_answer>'
      ...

tools:
  - tool_spec:
      type: '<tool_type>'
      name: '<tool_name>'
      description: '<tool_description>'
      input_schema:
          type: 'object'
          properties:
            <property_name>:
              type: '<property_type>'
              description: '<property_description>'
          required: <required_property_names>
  ...

tool_resources:
  <tool_name>:
    <resource_key>: '<resource_value>'
    ...
  ...

Copy

JSON 오브젝트의 구조는 다음과 같아야 합니다.

{
  "models": {
    "orchestration": "<model_name>"
  },
  "orchestration": {
    "budget": {
      "seconds": <number_of_seconds>,
      "tokens": <number_of_tokens>
    }
  },
  "instructions": {
    "response": "<response_instructions>",
    "orchestration": "<orchestration_instructions>",
    "system": "<system_instructions>",
    "sample_questions": [
      {
        "question": "<sample_question>",
        "answer": "<sample_answer>"
      }
    ]
  },
  "tools": [
    {
      "tool_spec": {
        "type": "<tool_type>",
        "name": "<tool_name>",
        "description": "<tool_description>",
        "input_schema": {
          "type": "object",
          "properties": {
            "<property_name>": {
              "type": "<property_type>",
              "description": "<property_description>"
            }
          },
          "required": ["<required_property_names>"]
        }
      }
    }
  ],
  "tool_resources": {
    "<tool_name>": {
      "<resource_key>": "<resource_value>"
    }
  }
}

Copy

다음 테이블은 이 오브젝트의 키-값 페어를 설명합니다.

키	타입	설명
`models`	ModelConfig	에이전트에 대한 선택적 모델 구성입니다. 오케스트레이션 모델을 포함합니다(예: clade-4-sonnet). 입력하지 않으면 모델이 자동으로 선택됩니다. 현재 `오케스트레이션` 단계에만 사용 가능합니다.
`orchestration`	OrchestrationConfig	예산 제약 조건(예: 초, 토큰)을 포함한 선택적 오케스트레이션 구성입니다.
`instructions`	AgentInstructions	응답, 오케스트레이션, 시스템, 샘플 질문 등 에이전트의 동작에 대한 선택적 지침입니다.
`tools`	:ref:`label_snowflake_agent_object_Tool`의 배열	에이전트가 사용할 수 있는 선택적 도구 목록입니다. 각 도구에는 유형, 이름, 설명, 입력 스키마가 있는 :code:`tool_spec`이 포함됩니다. 도구의 :code:`tool_resources`에 해당 구성이 있을 수 있습니다.
`tool_resources`	:ref:`label_snowflake_agent_object_ToolResource`의 맵	도구 배열에서 참조되는 각 도구에 대한 선택적 구성입니다. 키는 해당 도구의 이름과 일치해야 합니다.

액세스 제어 요구 사항¶

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한	오브젝트	참고
OWNERSHIP 또는 MODIFY	에이전트	에이전트 속성 또는 사양을 수정하는 데 필요합니다. OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

권한

오브젝트

참고

OWNERSHIP 또는 MODIFY

에이전트

에이전트 속성 또는 사양을 수정하는 데 필요합니다.

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

스키마의 오브젝트에 대한 작업을 수행하려면 상위 데이터베이스에 대한 하나 이상의 권한과 상위 스키마에 대한 하나 이상의 권한이 필요합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

라이브 버전의 사양을 수정하면 새 사양이 기존 사양을 완전히 대체합니다. 새 사양에 포함되지 않은 필드는 제거됩니다.
YAML 및 JSON 형식 모두 사양에 지원됩니다.
유효하지 않은 사양 필드로 인해 오류가 발생합니다.
메타데이터 관련:

주의

고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.

예¶

에이전트에 대한 설명을 업데이트합니다.

ALTER AGENT my_support_agent SET COMMENT = 'Customer support agent for product inquiries';

Copy

에이전트의 프로필을 업데이트합니다.

ALTER AGENT my_support_agent SET PROFILE = '{"display_name": "Support Bot", "avatar": "bot-icon.png"}';

Copy

설명과 프로필을 함께 업데이트합니다.

ALTER AGENT my_support_agent
  SET COMMENT = 'Production support agent',
      PROFILE = '{"display_name": "Customer Assistant", "avatar": "assistant.png"}';

Copy

YAML 형식을 사용하여 라이브 버전 사양을 업데이트합니다.

ALTER AGENT my_support_agent
  MODIFY LIVE VERSION SET SPECIFICATION =
  $$
  models:
    orchestration: claude-4-sonnet

  orchestration:
    budget:
      seconds: 30
      tokens: 50000

  instructions:
    system: "You are a helpful customer support assistant."
    response: "Always be concise and accurate."
    sample_questions:
      - question: "What is the status of my order?"
        answer: "I can help you check your order status. Please provide your order number."
  $$;

Copy

JSON 형식을 사용하여 라이브 버전 사양을 업데이트합니다.

ALTER AGENT my_support_agent
  MODIFY LIVE VERSION SET SPECIFICATION = '{"models":{"orchestration":"claude-4-sonnet"},"orchestration":{"budget":{"seconds":45,"tokens":80000}}}';

Copy