참고: 이 문서 모음은 Gemini Enterprise의 Standard, Plus, 종량제, Frontline 버전을 위한 것입니다. Business 에디션 문서는 Gemini Enterprise - Business 에디션 고객센터를 참고하세요.

Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

스킬 만들기 및 관리

스킬은 Gemini Enterprise 어시스턴트가 법률 계약 검토 또는 브랜드 어조로 작성과 같은 특정 작업을 수행하는 데 도움이 되는 재사용 가능한 맞춤 안내입니다.

각 기술은 SKILL.md 프롬프트 파일이 포함된 패키지입니다. 기술 패키지에는 어시스턴트가 작업을 완료하는 데 사용하는 스크립트, 파일 또는 배경 컨텍스트도 포함될 수 있습니다. 기본적으로 Gemini Enterprise는 사용자가 만든 기술을 사용 설정합니다.

지원되는 버전

스킬을 만들거나 업로드하거나 사용하는 기능은 구독하는 Gemini Enterprise 버전에 따라 다릅니다.

Standard, Plus, 사용한 만큼만 지불: 커스텀 스킬을 만들고 업로드할 수 있으며, Google 관리 스킬과 나와 공유된 사용자 생성 스킬을 사용할 수 있습니다.
Frontline: Google 관리 스킬과 공유된 사용자 생성 스킬을 탐색, 설치, 사용할 수 있습니다. 맞춤 스킬을 만들거나 업로드할 수 없습니다.

개요

기술의 주요 측면은 다음과 같습니다.

개방형 표준: 개방형 기술 표준을 기반으로 빌드된 각 기술은 핵심 SKILL.md 파일로 정의되며 추가 파일 또는 스크립트로 확장할 수 있습니다.
모듈식 확장: 스킬을 사용하면 커스텀 요청 사항과 컨텍스트를 사용하여 에이전트에게 분야별 작업을 가르칠 수 있습니다.
동적 액세스: Gemini Enterprise는 질문이나 작업과 관련이 있을 때 이러한 특수 요청 사항에 자동으로 액세스합니다.

스킬 만들기

Gemini Enterprise 웹 앱에서 새 스킬을 만들려면 다음 단계를 따르세요.

Gemini Enterprise 웹 앱에 로그인합니다.
탐색 메뉴에서 기술을 클릭합니다.
추가 아이콘을 클릭하고 Gemini로 스킬 만들기를 클릭합니다.
스킬 이름을 입력합니다.
설명을 입력합니다. Gemini Enterprise는 설명을 사용하여 스킬이 프롬프트나 작업에 도움이 될 수 있는지 판단합니다. 설명에 트리거 요청 사항을 추가하여 Gemini Enterprise를 안내할 수도 있습니다.
채팅 상자 또는 안내 필드에 자연어를 사용하여 기술 안내를 제공합니다. 커스텀 마크다운 또는 YAML 프런트 매터가 있는 기존 SKILL.md 파일을 사용하여 스킬을 만들려면 스킬 업로드를 참조하세요.
저장을 클릭합니다. Gemini Enterprise는 기본적으로 새 스킬을 사용 설정합니다.

스킬 업로드

기존 기술을 추가하려면 마크다운 또는 ZIP 파일로 업로드하세요. Gemini Enterprise는 SKILL.md 파일에서 스킬 이름과 설명을 자동으로 추출합니다.

스킬 파일 형식 및 디렉터리 구조

스킬 패키지는 필수 SKILL.md 프롬프트 파일과 스크립트, 참고 문서, 애셋을 위한 선택적 하위 디렉터리로 구성됩니다. 독립형 SKILL.md 파일 또는 다음 디렉터리 구조의 ZIP 파일를 업로드할 수 있습니다.

my-skill/
├── SKILL.md              # Required: YAML frontmatter + Markdown instructions
├── scripts/              # Optional: executable helper scripts (Python, Bash)
├── references/           # Optional: supplementary context loaded as needed
└── assets/               # Optional: templates or images used in output

파일 또는 디렉터리	필수	설명
`SKILL.md`	예	스킬의 YAML 프런트매터 메타데이터 (예: `name` 및 `description`)와 Gemini Enterprise 어시스턴트를 안내하는 마크다운 안내가 포함됩니다.
`scripts/`	아니요	결정론적 또는 반복 작업에 사용할 수 있는 실행 가능한 Python 또는 Bash 도우미 스크립트
`references/`	아니요	스키마, 치트 시트, API 참고 문서와 같이 요청 시 로드되는 보충 컨텍스트입니다.
`assets/`	아니요	Gemini Enterprise의 프롬프트 컨텍스트에 직접 로드되지 않는 출력에 사용되는 파일 (예: 템플릿 또는 이미지)

YAML 프런트매터 요구사항

SKILL.md 파일은 파일의 맨 처음에 --- 구분 기호로 묶인 유효한 YAML 프런트매터 블록으로 시작해야 하며, 그 뒤에 마크다운 요청 사항 본문이 이어져야 합니다(하드 한도 500,000자(영문 기준), 이 한도를 초과하는 업로드는 실패함).

YAML 프런트매터는 다음 필드를 지원합니다.

필드	필수	형식 및 제약 조건
`name`	예	기술의 고유 식별자입니다(1~64자(영문 기준)). 소문자 (`a-z`), 숫자 (`0-9`), 하이픈 (`-`)만 포함해야 합니다. 하이픈(`-`)으로 시작하거나 끝나면 안 되며 연속된 하이픈 (`--`)을 포함하면 안 됩니다. 폴더 내에 업로드된 경우 `name` 값은 상위 폴더 이름과 일치해야 합니다.
`description`	예	스킬의 기능과 Gemini Enterprise가 이를 호출해야 하는 시점을 설명하는 기능 설명 (1~1,024자)입니다. Gemini Enterprise가 스킬이 관련성이 있는 시점을 식별하는 데 도움이 되는 트리거 키워드를 포함합니다. 이 한도는 엄격하게 적용됩니다. 설명이 1,024자를 초과하면 `A field in your SKILL.md is too long. Shorten the name, description or the instructions.` 오류가 발생하며 기술 업로드가 실패합니다.
`license`	아니요	스킬 패키지에 적용되는 소프트웨어 또는 콘텐츠 배포 라이선스(최대 1,024자)(예: 오픈소스 SPDX 라이선스 식별자(예: `Apache-2.0` 또는 `MIT`) 또는 `Proprietary`) 이 필드는 Gemini Enterprise 기업 사용자 또는 앱 구독 라이선스가 아닌 스킬 파일 자체의 사용 약관을 지정합니다. 지정된 경우 값은 비어 있으면 안 됩니다.
`metadata`	아니요	커스텀 태그, 작성자 또는 버전 매개변수의 선택적 키-값 맵입니다. 키는 스칼라 문자열이어야 하며 값은 스칼라 문자열 또는 스칼라 문자열 목록이어야 합니다.

`SKILL.md` 파일 예시

다음 예시에서는 유효한 SKILL.md 파일을 보여줍니다.

---
name: brand-voice-reviewer
description: Reviews marketing copy and legal contracts to ensure compliance with brand voice guidelines. Use when asked to review, edit, or draft customer-facing text.
---

# Brand Voice Reviewer

Follow these guidelines when reviewing or drafting customer-facing text:

1. Use clear, concise, and active language.
2. Avoid jargon and unverified claims.
3. Verify that terminology aligns with the company style guide.

ZIP 파일 제약 조건

스킬을 ZIP 파일로 업로드할 때는 파일이 다음 검증 요구사항을 충족하는지 확인하세요.

단일 SKILL.md 파일: 각 ZIP 파일에는 아카이브 루트 (SKILL.md) 또는 단일 최상위 래퍼 폴더 (최대 3단계 깊이, 예: my-skill/SKILL.md)에 있는 SKILL.md 파일이 정확히 하나 포함되어야 합니다.
보관 파일 크기: 최대 압축 ZIP 파일 크기는 100MB이고 압축되지 않은 최대 총크기는 100MB입니다.
파일 수: ZIP 파일당 최대 100개 파일
디렉터리 중첩 깊이: 기술 루트를 기준으로 최대 디렉터리 중첩 깊이는 10수준입니다.
경로 무결성: 중복 파일 경로 및 상위 디렉터리 참조(..)는 허용되지 않습니다.

웹 앱에 스킬 업로드

기술을 업로드하려면 다음 단계를 따르세요.

Gemini Enterprise 웹 앱에 로그인합니다.
탐색 메뉴에서 기술을 클릭합니다.
추가 아이콘을 클릭하고 기술 업로드를 클릭합니다.
마크다운 또는 ZIP 파일을 드래그하거나 찾아보고 가져오기를 클릭합니다. Gemini Enterprise는 기본적으로 이 스킬을 사용 설정합니다.

참고:

Upload failed.
Details: Request contains an invalid argument

와 같은 오류로 인해 업로드에 실패하면 다음을 확인하세요.

SKILL.md 파일은 --- 구분 기호로 묶인 유효한 YAML 프런트매터로 시작합니다.
프런트매터에는 글자 수 제한 내에서 필수 name 및 description 필드가 포함됩니다.
name 필드는 소문자, 숫자, 하이픈만 사용합니다 (ZIP 파일에 업로드된 경우 상위 폴더 이름과 일치).
보관 파일이 ZIP 파일 제약조건을 준수합니다.

스킬 둘러보기

다음 섹션을 사용하여 목록을 필터링하여 기술을 탐색하고 설치할 수 있습니다.

섹션	설명
전체	Google 관리 스킬과 사용자 생성 스킬 모두
Google	Google에서 제공하는 기본 제공 스킬입니다.
공유 문서함	다른 사용자가 나와 공유한 읽기 전용 사용자 생성 스킬입니다.

스킬을 탐색하고 설치하려면 다음 단계를 따르세요.

Gemini Enterprise 웹 앱에 로그인합니다.
탐색 메뉴에서 기술을 클릭합니다.
추가 아이콘을 클릭하고 스킬 찾아보기를 클릭합니다.
사용하려는 스킬을 찾아 + 설치를 클릭합니다.

스킬 업데이트

기존 기술을 업데이트하려면 다음 단계를 따르세요.

Gemini Enterprise 웹 앱에 로그인합니다.
탐색 메뉴에서 기술을 클릭합니다.
업데이트하려는 기술의 이름을 클릭합니다.
기술 옆에 있는 아이콘을 클릭하고 수정을 클릭합니다.
요청 사항, 이름 또는 설명을 필요한 만큼 업데이트합니다.
저장을 클릭합니다.

스킬 페이지로 돌아가려면 스킬을 클릭합니다.

스킬 공유

Gemini Enterprise 관리자가 스킬 공유를 사용 설정하면 내가 만든 스킬을 다른 사용자와 공유할 수 있습니다.

스킬을 공유하려면 다음 단계를 따르세요.

Gemini Enterprise 웹 앱에 로그인합니다.
탐색 메뉴에서 기술을 클릭합니다.
만든 스킬 중 공유하려는 스킬을 찾습니다.
기술 옆에 있는 아이콘을 클릭하고 공유를 클릭합니다.
스킬 공유 대화상자에서 스킬을 공유할 사용자의 이메일 주소를 쉼표로 구분하여 입력합니다.
완료를 클릭합니다.

스킬 사용하기

Gemini Enterprise 웹 앱의 채팅 대화 내에서 바로 스킬을 사용할 수 있습니다.

스킬 페이지에서 스킬 테스트하기

스킬 페이지에서 해당 스킬로 새 채팅 세션을 시작하여 스킬을 직접 테스트할 수 있습니다.

Gemini Enterprise 웹 앱에 로그인합니다.
탐색 메뉴에서 기술을 클릭합니다.
스킬 옆에 있는 아이콘을 클릭하고 새 채팅을 클릭합니다. Gemini Enterprise에서 선택한 스킬을 참조하는 새 채팅이 열립니다.

대화에서 기술 호출

대화 중에 동적으로 기술을 호출하여 어시스턴트의 대답을 맞춤설정할 수 있습니다.

Gemini Enterprise 어시스턴트와 채팅할 때 다음과 같은 방법으로 기술을 사용할 수 있습니다.

수동 멘션: 채팅 상자에서 @ 또는 / 멘션 기능을 사용하여 스킬을 명시적으로 호출할 수 있습니다 (예: @Brand Voice 또는 /Brand Voice). /를 입력하면 사용 가능한 스킬만 표시하는 메뉴가 열리고 @를 입력하면 일반 멘션 메뉴가 열립니다.
직접 요청: Gemini Enterprise에서 특정 스킬을 사용해야 하는 경우 프롬프트에서 직접 요청할 수 있습니다. 예를 들면 Use the brand voice skill to review this입니다.
자동 선택: Gemini Enterprise는 스킬의 설명과 트리거 요청 사항을 기반으로 작업과 관련이 있는 경우 스킬을 자동으로 사용합니다.

스킬 사용 중지하기

Gemini Enterprise에서 특정 스킬을 사용하지 못하게 하려면 사용 중지합니다. 스킬을 사용 중지하면 Gemini Enterprise가 대화에서 해당 스킬을 호출하지 않습니다.

스킬을 사용 중지하려면 다음 단계를 따르세요.

Gemini Enterprise 웹 앱에 로그인합니다.
탐색 메뉴에서 기술을 클릭합니다.
스킬 페이지에서 사용 중지하려는 스킬을 찾습니다.
스킬 옆의 전환 버튼을 사용 중지 위치로 클릭합니다.

스킬 제거하기

스킬 페이지에서 설치된 스킬을 삭제하려면 다음 단계를 따르세요.

Gemini Enterprise 웹 앱에 로그인합니다.
탐색 메뉴에서 기술을 클릭합니다.
스킬 옆에 있는 아이콘을 클릭하고 제거를 클릭합니다.

스킬 상태

스킬을 직접 사용 설정하거나 사용 중지하는 것 외에도 관리자가 스킬 상태를 변경할 수 있으며, 이는 스킬 사용 가능 여부에 영향을 미칩니다.

정지됨: 관리자가 기술을 일시적으로 비활성화합니다. 정지 상태로 스킬 페이지에 계속 표시되지만 관리자가 다시 사용 설정할 때까지 다른 사용자는 대화에서 이를 호출할 수 없습니다. 스킬 소유자는 스킬을 업데이트하고 테스트할 수 있습니다.
사용 중지됨: 관리자가 다른 사용자에게 스킬을 일시적으로 숨겨 스킬 페이지에서 삭제합니다. 스킬은 스킬 소유자에게 계속 표시되며, 관리자가 다시 사용 설정할 때까지 스킬 소유자가 스킬을 업데이트하고 테스트할 수 있습니다.
삭제됨: 관리자가 Gemini Enterprise 웹 앱에서 스킬을 영구적으로 삭제하므로 더 이상 사용할 수 없습니다.

제한사항

이 섹션에는 Gemini Enterprise의 스킬 제한사항이 나와 있습니다.

에이전트에서 역량을 사용할 수 없습니다.
스킬은 Python 및 Bash 실행만 지원합니다.
웹 앱 편집기를 사용하면 양식 필드에 지침을 입력하거나 어시스턴트와 채팅하여 기술을 만들 수 있으며, 그러면 단일 SKILL.md 파일이 자동으로 생성됩니다. 추가 스크립트나 파일이 필요한 더 복잡한 기술은 ZIP 파일로 업로드해야 합니다.
자연어 기술 생성은 대화 컨텍스트나 커넥터를 입력으로 사용하여 기술을 만들지 않습니다.
스킬에 SKILL.md 파일이 하나만 있는 경우 Canvas에서 가장 잘 작동합니다.
SKILL.md 파일에는 name의 경우 64자(영문 기준), description의 경우 1,024자(영문 기준), 마크다운 안내 본문의 경우 500,000자(영문 기준)의 엄격한 길이 제한이 있습니다. 업로드된 ZIP 파일은 100MB (압축 또는 비압축), 파일 100개 또는 디렉터리 중첩 10개 수준을 초과할 수 없습니다.

다음 단계

관리자 방법을 알아보세요스킬 관리.