Mendaftarkan keahlian

Di Agent Registry, skill mewakili kemampuan yang dapat dieksekusi dan mandiri yang dapat dimiliki agen. File ini berisi petunjuk dalam file SKILL.md, skrip kode, dan aset yang memperluas penalaran agen. Dengan mendaftarkan kemampuan mandiri di Agent Registry, Anda dapat mengelola, membuat versi, dan membagikan kemampuan secara terpusat di seluruh agen AI organisasi Anda.

Keterampilan buatan Google akan langsung terlihat saat Anda menyiapkan Agent Registry. Dokumen ini menjelaskan cara mendaftarkan kemampuan mandiri Anda sendiri secara manual di Agent Registry.

Sebelum memulai

Sebelum memulai, siapkan Agent Registry. Anda memerlukan project ID untuk melakukan tugas ini.

Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, pastikan Anda telah menyiapkan lingkungan gcloud CLI.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mendaftarkan keterampilan di Agent Registry, minta administrator untuk memberi Anda peran IAM berikut pada project:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Peran Agent Registry lainnya juga dapat mencakup izin yang diperlukan untuk mendaftarkan dan mengelola keterampilan serta revisi keterampilan. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin Agent Registry.

Batasan payload penyerapan

Untuk mendaftarkan skill, Anda harus mengemas file sumber kemampuan ke dalam arsip ZIP. Arsip harus menyertakan file instruksi SKILL.md di root-nya. Selama fase penyerapan proses pendaftaran skill, Agent Registry memvalidasi bahwa payload mematuhi batasan berikut:

  • Ukuran arsip ZIP: Ukuran arsip terkompresi maksimum 500 KB.
  • Total ukuran payload yang tidak dikompresi: Ukuran maksimum yang tidak dikompresi adalah 10 MB.
  • Ukuran file individual: Ukuran maksimum yang tidak dikompresi adalah 1 MB per file.
  • Tingkatan yang rumit: Kedalaman tingkatan direktori maksimum 8 tingkat.
  • Kepatuhan terhadap spesifikasi: File SKILL.md harus berisi bagian front matter YAML yang valid yang menentukan nama, deskripsi, dan metadata seperti yang ditentukan dalam Spesifikasi Kemampuan Agen.

Mendaftarkan keahlian

Keterampilan buatan Google akan langsung terlihat saat Anda menyiapkan Agent Registry. Namun, Anda juga dapat mendaftarkan keahlian Anda sendiri secara manual. Setiap skill memiliki revisi default dan dapat berisi beberapa revisi skill yang diberi versi.

Untuk mendaftarkan keahlian Anda sendiri, Anda membuat penampung keahlian logis dan mengupload payload revisi awal dalam satu operasi. Selanjutnya, Anda dapat mengelola keterampilan terdaftar dan revisi keterampilan berikutnya.

Untuk mengetahui informasi tentang harga dan biaya fitur untuk keterampilan, lihat harga Agent Registry.

Keterampilan yang Anda atau pengguna lain buat akan otomatis ditetapkan ke penayang private default untuk menghindari konflik nama dengan keterampilan yang dibuat Google. Oleh karena itu, ID yang dipublikasikan untuk skill tertentu menjadi private-SKILL_ID. Anda tidak dapat menentukan penerbit kustom selama pembuatan skill.

Misalnya, jika Anda membuat skill dengan ID workspace-tools, nama resource dibuat sebagai projects/PROJECT_ID/locations/LOCATION/skills/private-workspace-tools. Nama Resource Seragam (URN) logis ditetapkan sebagai urn:skill:projects-PROJECT_NUMBER:locations:LOCATION:private-workspace-tools. Anda harus menggunakan ID yang dipublikasikan ini (private-workspace-tools) untuk semua operasi skill berikutnya.

Untuk mendaftarkan skill, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Agent Registry:

    Buka Agent Registry

  2. Dari pemilih project, pilih project Google Cloud Anda.

  3. Pilih tab Keterampilan.

  4. Di tab Keterampilan, tombol Tambahkan keterampilan menampilkan dua opsi. Anda dapat memilih salah satu opsi berikut:

    • Tambahkan skill: Buat penampung skill baru di registry. Anda dapat mengupload paket skill secara opsional untuk membuat revisi pertama.
    • Impor skill: Aktifkan paket skill kustom baru dengan mengupload paket ZIP yang berisi kode atau petunjuk perintah (SKILL.md) file.

  5. Di panel Create skill atau Import skill, tentukan detail berikut:

    • Nama tampilan: Masukkan nama yang mudah digunakan untuk skill.
    • Deskripsi: Masukkan ringkasan singkat yang menjelaskan kemampuan keahlian.
    • Lokasi: Pilih wilayah geografis, misalnya, global, us, atau eu.

  6. Di bagian Sumber payload, pilih salah satu opsi berikut:

    • File: Tarik file ZIP skill yang dikemas, atau jelajahi direktori lokal Anda.

    • Bucket: Masukkan jalur ke arsip ZIP Anda yang disimpan di bucket Cloud Storage, dalam format gs://BUCKET_NAME/SKILL_PACKAGE.zip.

  7. Klik Create.

Keahlian Anda telah dibuat. Untuk semua operasi skill berikutnya, sebutkan skill Anda sebagai private-SKILL_ID, seperti yang ditampilkan di konsolGoogle Cloud .

gcloud

Untuk mendaftarkan skill dan mengupload payload awalnya, Anda dapat mengupload file ZIP lokal atau mengimpor paket yang disimpan di Cloud Storage.

Ganti kode berikut:

  • SKILL_ID: ID resource skill, misalnya, workspace-docs-skill. Setelah pembuatan, registry akan otomatis menambahkan awalan private-. Anda harus menggunakan ID berawalan di semua perintah skill berikutnya, misalnya private-workspace-docs-skill.
  • PROJECT_ID: Project ID.
  • LOCATION: Region geografis, misalnya, global, us, atau eu.
  • DISPLAY_NAME: Nama yang mudah digunakan untuk keterampilan.

  • DESCRIPTION: Ringkasan singkat yang menjelaskan kemampuan skill.

  • Mengupload file ZIP lokal: Untuk mendaftarkan skill menggunakan payload ZIP lokal:

    gcloud alpha agent-registry skills create SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --display-name="DISPLAY_NAME" \
  --description="DESCRIPTION" \
  --payload="LOCAL_ZIP_PATH"

    Ganti LOCAL_ZIP_PATH dengan jalur ke arsip skill yang dikemas di komputer lokal Anda, misalnya, ./workspace-docs-skill.zip.

  • Impor dari bucket Cloud Storage: Untuk mendaftarkan skill menggunakan arsip ZIP yang dihosting di bucket Cloud Storage:

    gcloud alpha agent-registry skills create SKILL_ID \
  --project=PROJECT_ID \
  --location=LOCATION \
  --display-name="DISPLAY_NAME" \
  --description="DESCRIPTION" \
  --gcs-source-uri="gs://BUCKET_NAME/SKILL_PACKAGE.zip"

    Ganti kode berikut:

    • BUCKET_NAME: Nama bucket Cloud Storage yang berisi paket ZIP.
    • SKILL_PACKAGE: Nama paket skill yang berisi payload skill.

REST

Untuk membuat skill dengan revisi awal inline:

Metode HTTP dan URL

POST https://agentregistry.googleapis.com/v1alpha/projects/{project}/locations/{location}/skills?skillId={skillId}

Isi JSON permintaan (upload file lokal)

Untuk membuat skill dengan mengupload byte arsip ZIP lokal secara langsung, gunakan payload archiveUploadSource:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "type": "SIMPLE",
  "targetState": "TARGET_STATE_ACTIVE",
  "initialRevision": {
    "archiveUploadSource": {
      "archiveContent": "BASE64_ZIP_BYTES"
    }
  }
}

Ganti BASE64_ZIP_BYTES dengan representasi string yang dienkode base64 dari arsip ZIP lokal Anda.

Isi JSON permintaan (impor dari Cloud Storage)

Atau, untuk membuat skill menggunakan arsip yang disimpan di bucket Cloud Storage, gunakan gcsSource:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "type": "SIMPLE",
  "targetState": "TARGET_STATE_ACTIVE",
  "initialRevision": {
    "gcsSource": {
      "uri": "gs://BUCKET_NAME/SKILL_PACKAGE.zip"
    }
  }
}

Ganti kode berikut:

  • BUCKET_NAME: Nama bucket Cloud Storage yang berisi paket ZIP.
  • SKILL_PACKAGE: Nama paket skill yang berisi payload skill.

Perintah curl (upload file lokal)

curl -X POST \
      -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      -H "Content-Type: application/json" \
      -d '{
        "displayName": "DISPLAY_NAME",
        "description": "DESCRIPTION",
        "type": "SIMPLE",
        "targetState": "TARGET_STATE_ACTIVE",
        "initialRevision": {
          "archiveUploadSource": {
            "archiveContent": "$(base64 -w0 local_skill.zip)"
          }
        }
      }' \
      "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills?skillId=SKILL_ID"

Untuk upload file bucket Cloud Storage, ganti isi JSON permintaan dengan kolom dan nilai yang sesuai.

Langkah berikutnya