Membuat dan mengelola keahlian

Keterampilan adalah petunjuk kustom yang dapat digunakan kembali untuk membantu asisten Gemini Enterprise melakukan tugas tertentu, seperti meninjau kontrak hukum atau menulis dengan gaya bahasa brand Anda.

Catatan: Untuk membuat keterampilan, administrator Anda harus mengaktifkan fitur keterampilan. Demikian pula, untuk membagikan skill, administrator Anda juga harus mengaktifkan berbagi skill, yang dapat dikonfigurasi untuk memerlukan peninjauan administrator atau mengizinkan berbagi langsung. Untuk mengetahui informasi selengkapnya, lihat Mengelola keterampilan.

Setiap skill adalah paket yang berisi file perintah SKILL.md. Paket keterampilan juga dapat mencakup skrip, file, atau konteks latar belakang yang digunakan asisten untuk menyelesaikan tugas. Secara default, Gemini Enterprise mengaktifkan keterampilan yang Anda buat.

Edisi yang didukung

Kemampuan untuk membuat, mengupload, atau menggunakan keterampilan bergantung pada edisi Gemini Enterprise yang Anda langgan:

• Standard, Plus, dan Bayar sesuai penggunaan: Anda dapat membuat dan mengupload keahlian kustom, serta menggunakan keahlian yang dikelola Google dan keahlian buatan pengguna yang dibagikan kepada Anda.
• Frontline: Anda dapat menjelajahi, menginstal, dan menggunakan keahlian yang dikelola Google dan keahlian buatan pengguna yang dibagikan kepada Anda. Anda tidak dapat membuat atau mengupload keterampilan kustom.

Ringkasan

Aspek utama keterampilan meliputi:

• Standar Terbuka: Dibuat berdasarkan standar keterampilan terbuka, setiap keterampilan ditentukan oleh file SKILL.md inti dan dapat diperluas dengan file atau skrip tambahan.
• Ekstensi modular: Keahlian memungkinkan Anda mengajari agen tugas khusus domain menggunakan petunjuk dan konteks kustom.
• Akses dinamis: Gemini Enterprise mengakses petunjuk khusus ini secara otomatis saat relevan dengan pertanyaan atau tugas Anda.

Buat keahlian

Catatan: Anda tidak dapat membuat keterampilan dengan edisi Gemini Enterprise Frontline. Untuk mengetahui informasi selengkapnya, lihat Edisi yang didukung.

Untuk membuat keterampilan baru di aplikasi web Gemini Enterprise, ikuti langkah-langkah berikut:

1. Login ke aplikasi web Gemini Enterprise.
2. Di menu navigasi, klik Skills.
3. Klik ikon add, lalu klik Create skill with Gemini.
4. Masukkan nama untuk keahlian Anda.
5. Masukkan deskripsi. Gemini Enterprise menggunakan deskripsi tersebut untuk menentukan apakah keahlian tersebut dapat membantu menyelesaikan perintah atau tugas. Anda juga dapat menambahkan petunjuk pemicu ke deskripsi untuk membantu memandu Gemini Enterprise.
6. Berikan petunjuk keterampilan menggunakan bahasa alami di kotak chat atau kolom Instructions. Untuk membuat keahlian menggunakan file SKILL.md yang ada dengan front matter Markdown atau YAML kustom, lihat Mengupload keahlian.
7. Klik Simpan. Gemini Enterprise mengaktifkan kemampuan baru secara default.

Upload keahlian

Catatan: Anda tidak dapat mengupload keterampilan dengan edisi Gemini Enterprise Frontline. Untuk mengetahui informasi selengkapnya, lihat Edisi yang didukung.

Untuk menambahkan keterampilan yang ada, upload keterampilan tersebut sebagai file Markdown atau file ZIP. Gemini Enterprise otomatis mengekstrak nama dan deskripsi keahlian dari file SKILL.md.

Format file dan struktur direktori skill

Paket keahlian terdiri dari file perintah SKILL.md yang diperlukan dan subdirektori opsional untuk skrip, dokumentasi referensi, dan aset. Anda dapat mengupload file SKILL.md mandiri atau file ZIP dengan struktur direktori berikut:

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

File atau direktori	Wajib	Deskripsi
SKILL.md	Ya	Berisi metadata frontmatter YAML keahlian (seperti name dan description) diikuti dengan petunjuk Markdown yang memandu asisten Gemini Enterprise.
scripts/	Tidak	Skrip bantuan Python atau Bash yang dapat dieksekusi untuk operasi deterministik atau berulang.
references/	Tidak	Konteks tambahan yang dimuat sesuai permintaan, seperti skema, tips, atau dokumentasi referensi API.
assets/	Tidak	File yang digunakan dalam output (seperti template atau gambar) yang tidak dimuat langsung ke dalam konteks perintah Gemini Enterprise.

Persyaratan frontmatter YAML

File SKILL.md harus diawali dengan blok frontmatter YAML yang valid yang diapit di antara pembatas --- di awal file, diikuti dengan isi petunjuk Markdown (batas ketat 500.000 karakter; upload yang melebihi batas ini akan gagal).

Frontmatter YAML mendukung kolom berikut:

Kolom	Wajib	Format dan batasan
name	Ya	ID unik untuk keterampilan (1 hingga 64 karakter). Hanya boleh berisi huruf kecil (a-z), angka (0-9), dan tanda hubung (-). Tidak boleh diawali atau diakhiri dengan tanda hubung (-) atau berisi tanda hubung berturut-turut (--). Jika diupload di dalam folder, nilai name harus cocok dengan nama folder induk.
description	Ya	Deskripsi fungsional (1 hingga 1.024 karakter) yang menjelaskan fungsi keahlian dan kapan Gemini Enterprise harus memanggilnya. Sertakan kata kunci pemicu untuk membantu Gemini Enterprise mengidentifikasi kapan keahlian tersebut relevan. Ini adalah batas mutlak; jika deskripsi melebihi 1.024 karakter, upload skill akan gagal dengan error: A field in your SKILL.md is too long. Shorten the name, description or the instructions.
license	Tidak	Lisensi distribusi software atau konten yang berlaku untuk paket skill (hingga 1.024 karakter), seperti ID lisensi SPDX open source (misalnya, Apache-2.0 atau MIT) atau Proprietary. Kolom ini menentukan persyaratan penggunaan file skill itu sendiri, bukan lisensi langganan aplikasi atau pengguna Gemini Enterprise. Jika ditentukan, nilai tidak boleh kosong.
metadata	Tidak	key-value map opsional dari tag kustom, penulis, atau parameter versi. Kunci harus berupa string skalar, dan nilai harus berupa string skalar atau daftar string skalar.

Contoh file SKILL.md

Contoh berikut menunjukkan file SKILL.md yang valid:

---
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.

Batasan file ZIP

Saat mengupload skill sebagai file ZIP, pastikan arsip tersebut memenuhi persyaratan validasi berikut:

• Satu file SKILL.md: Setiap arsip ZIP harus berisi tepat satu file SKILL.md yang terletak di root arsip (SKILL.md) atau dalam satu folder wrapper tingkat teratas (hingga kedalaman 3 tingkat, seperti my-skill/SKILL.md).
• Ukuran arsip: Ukuran maksimum file ZIP yang dikompresi adalah 100 MB dan ukuran total maksimum yang tidak dikompresi adalah 100 MB.
• Jumlah file: Maksimum 100 file per file ZIP.
• Kedalaman bertingkat direktori: Kedalaman bertingkat direktori maksimum 10 tingkat relatif terhadap root keahlian.
• Integritas jalur: Jalur file duplikat dan referensi direktori induk (..) tidak diizinkan.

Mengupload keahlian ke aplikasi web

Untuk mengupload keterampilan, ikuti langkah-langkah berikut:

1. Login ke aplikasi web Gemini Enterprise.
2. Di menu navigasi, klik Skills.
3. Klik ikon add, lalu klik Upload skill.
4. Tarik atau cari file Markdown atau ZIP, lalu klik Impor. Gemini Enterprise mengaktifkan kemampuan ini secara default.

Catatan: Jika upload Anda gagal dengan error seperti Upload failed. Details: Request contains an invalid argument, verifikasi hal berikut:

• File SKILL.md Anda dimulai dengan frontmatter YAML yang valid yang diapit dalam pembatas ---.
• Frontmatter menyertakan kolom name dan description yang diperlukan dalam batas karakternya.
• Kolom name hanya menggunakan huruf kecil, angka, dan tanda hubung (dan cocok dengan nama folder induk jika diupload dalam file ZIP).
• Arsip Anda mematuhi batasan file ZIP.

Jelajahi keahlian

Anda dapat menjelajahi dan menginstal keterampilan dengan menggunakan bagian berikut untuk memfilter daftar:

Bagian	Deskripsi
Semua	Baik keahlian yang dikelola Google maupun keahlian yang dibuat pengguna.
Google	Kemampuan bawaan yang disediakan oleh Google.
Dibagikan kepada saya	Keahlian hanya baca yang dibuat pengguna dan dibagikan oleh pengguna lain kepada Anda.

Untuk menjelajahi dan menginstal skill, ikuti langkah-langkah berikut:

1. Login ke aplikasi web Gemini Enterprise.
2. Di menu navigasi, klik Skills.
3. Klik ikon tambahkan, lalu klik Jelajahi keahlian.
4. Temukan skill yang ingin Anda gunakan, lalu klik + Instal.

Memperbarui keahlian

Untuk memperbarui keterampilan yang ada, ikuti langkah-langkah berikut:

1. Login ke aplikasi web Gemini Enterprise.
2. Di menu navigasi, klik Skills.
3. Klik nama keterampilan yang ingin Anda perbarui.
4. Klik ikon di samping keterampilan dan klik Edit.
5. Lakukan pembaruan yang diperlukan pada petunjuk, nama, atau deskripsi.
6. Klik Simpan.

Untuk kembali ke halaman Keahlian, klik Keahlian.

Membagikan keahlian

Jika administrator Gemini Enterprise Anda mengaktifkan berbagi keahlian, Anda dapat membagikan keahlian yang Anda buat kepada pengguna lain.

Catatan: Berbagi keterampilan tidak akan mengirimkan notifikasi email. Untuk menemukan keterampilan, penerima harus membuka bagian Dibagikan kepada saya di Jelajahi keterampilan.

Untuk membagikan keterampilan, ikuti langkah-langkah berikut:

1. Login ke aplikasi web Gemini Enterprise.
2. Di menu navigasi, klik Skills.
3. Temukan keterampilan yang Anda buat dan ingin Anda bagikan.
4. Klik ikon di samping keahlian dan klik Bagikan.
5. Dalam dialog Share skill, masukkan alamat email yang dipisahkan koma dari pengguna yang ingin Anda ajak berbagi skill.
6. Klik Done.

Catatan: Jika administrator Gemini Enterprise Anda memerlukan persetujuan untuk permintaan berbagi, pengguna lain tidak dapat mengakses skill tersebut hingga administrator Anda menyetujui permintaan tersebut.

Menggunakan keahlian

Anda dapat menggunakan keahlian langsung dalam percakapan chat di aplikasi web Gemini Enterprise.

Menguji keahlian dari halaman Keahlian

Anda dapat menguji keahlian langsung dari halaman Skills dengan memulai sesi percakapan baru dengan keahlian tersebut:

1. Login ke aplikasi web Gemini Enterprise.
2. Di menu navigasi, klik Skills.
3. Klik ikon di samping keterampilan dan klik Percakapan baru. Gemini Enterprise akan membuka percakapan baru yang merujuk ke skill yang dipilih.

Memanggil keterampilan dalam percakapan

Anda dapat memanggil skill secara dinamis selama percakapan untuk menyesuaikan respons asisten.

Catatan: Anda dapat menggunakan keterampilan dan agen secara dinamis, tetapi Anda tidak dapat memanggil agen dan keterampilan dalam perintah yang sama.

Saat melakukan percakapan dengan asisten Gemini Enterprise, Anda dapat menggunakan kemampuan dengan cara berikut:

• Sebutan manual: Anda dapat secara eksplisit memanggil kemampuan menggunakan fitur sebutan @ atau / di kotak chat (misalnya, @Brand Voice atau /Brand Voice). Mengetik / akan membuka menu yang hanya menampilkan kemampuan yang tersedia, sedangkan mengetik @ akan membuka menu sebutan umum.
• Permintaan langsung: Jika Anda memerlukan Gemini Enterprise untuk menggunakan keahlian tertentu, Anda dapat memintanya langsung dalam perintah Anda. Contoh, Use the brand voice skill to review this.
• Pemilihan otomatis: Gemini Enterprise otomatis menggunakan keahlian jika relevan dengan tugas Anda berdasarkan deskripsi keahlian dan petunjuk pemicu.

Menonaktifkan keahlian

Untuk mencegah Gemini Enterprise menggunakan keahlian tertentu, nonaktifkan keahlian tersebut. Jika Anda menonaktifkan keahlian, Gemini Enterprise tidak akan memanggilnya dalam percakapan.

Untuk menonaktifkan keterampilan, ikuti langkah-langkah berikut:

1. Login ke aplikasi web Gemini Enterprise.
2. Di menu navigasi, klik Skills.
3. Di halaman Keahlian, temukan keahlian yang ingin Anda nonaktifkan.
4. Klik tombol di samping keterampilan ke posisi Nonaktif.

Meng-uninstal keahlian

Untuk menghapus keahlian yang diinstal dari halaman Keahlian, ikuti langkah-langkah berikut:

1. Login ke aplikasi web Gemini Enterprise.
2. Di menu navigasi, klik Skills.
3. Klik ikon di samping skill, lalu klik Uninstall.

Catatan: Menonaktifkan keahlian akan menjeda pemicuan otomatis, tetapi tetap menyimpannya di halaman Keahlian Anda. Meng-uninstal keahlian akan menghapusnya dari halaman Keahlian, tetapi keahlian tersebut tetap tersedia di Jelajahi keahlian untuk Anda instal ulang.

Status skill

Selain mengaktifkan atau menonaktifkan keterampilan sendiri, administrator Anda dapat mengubah status keterampilan, yang memengaruhi ketersediaannya:

• Ditangguhkan: Administrator Anda menonaktifkan keterampilan untuk sementara. Skill tersebut tetap terlihat di halaman Skills dengan status ditangguhkan, tetapi pengguna lain tidak dapat memanggilnya dalam percakapan hingga administrator mengaktifkannya kembali. Pemilik keahlian dapat memperbarui dan menguji keahlian.
• Dinonaktifkan: Administrator Anda menyembunyikan sementara keahlian dari pengguna lain, sehingga menghapusnya dari halaman Keahlian mereka. Keterampilan tetap terlihat oleh pemilik keterampilan, yang dapat memperbarui dan mengujinya hingga administrator mengaktifkannya kembali.
• Dihapus: Administrator Anda menghapus keterampilan secara permanen dari aplikasi web Gemini Enterprise, sehingga Anda tidak dapat lagi menggunakannya.

Batasan

Bagian ini mencantumkan batasan untuk skill di Gemini Enterprise:

• Keterampilan tidak tersedia untuk digunakan dengan agen.
• Keterampilan hanya mendukung eksekusi Python dan Bash.
• Editor aplikasi web memungkinkan Anda membuat keahlian dengan memasukkan petunjuk di kolom formulir atau dengan melakukan chat dengan asisten, yang otomatis menghasilkan satu file SKILL.md. Anda harus mengupload keterampilan yang lebih kompleks yang memerlukan skrip atau file tambahan sebagai file ZIP.
• Pembuatan keterampilan bahasa alami tidak menggunakan konteks percakapan atau konektor Anda sebagai input untuk membuat keterampilan.
• Keahlian berfungsi paling baik dengan Canvas jika keahlian hanya memiliki satu file SKILL.md.
• File SKILL.md memiliki batas panjang yang ketat, yaitu 64 karakter untuk name, 1.024 karakter untuk description, dan 500.000 karakter untuk isi petunjuk Markdown. File ZIP yang diupload tidak boleh melebihi 100 MB (dikompresi atau tidak dikompresi), 100 file, atau 10 tingkat penyusunan bertingkat direktori.

Langkah berikutnya

• Pelajari cara administrator mengelola keahlian.