Mengelola keahlian

Registry Agen memungkinkan Anda memeriksa, memperbarui, dan mengatur kemampuan mandiri sehingga Anda dapat mengontrol versi kemampuan dan status siklus proses yang tersedia untuk agen Anda. Setelah mendaftarkan keahlian mandiri, Anda dapat melihat detailnya, memperbarui deskripsi atau revisi defaultnya, mentransisikan status siklus prosesnya, atau menghapusnya dari Agent Registry. Anda juga dapat mencantumkan dan melihat keahlian yang dikelola Google, yang tersedia segera setelah Anda menyiapkan Agent Registry.

Sebelum memulai

  1. Menyiapkan Agent Registry.

  2. Dapatkan project ID untuk project tata kelola tempat Agent Registry diaktifkan.

  3. Daftarkan keahlian mandiri.

  4. Untuk menggunakan perintah Google Cloud CLI dalam dokumen ini, siapkan lingkungan gcloud CLI Anda.

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk mengelola keterampilan di Agent Registry, minta administrator untuk memberi Anda peran IAM berikut pada project tata kelola tempat Agent Registry diaktifkan:

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 mungkin juga menyertakan izin yang diperlukan untuk melihat, memperbarui, dan menghapus skill. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin Agent Registry.

Mencantumkan dan melihat keterampilan

Anda dapat menjelajahi semua kemampuan yang terdaftar atau menelusuri kemampuan tertentu:

Konsol

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

    Buka Agent Registry

  2. Pilih tab Keterampilan.
  3. Tinjau daftar keterampilan. Anda dapat memfilter tampilan menggunakan menu Location atau Status.
  4. Klik nama keahlian apa pun untuk membuka halaman Skill Details, yang menampilkan nama, deskripsi, versi aktif, ID keahlian, terakhir diperbarui, metadata kustom, dan histori revisi.

gcloud

Untuk mencantumkan semua skill di suatu lokasi, gunakan perintah gcloud alpha agent-registry skills list:

gcloud alpha agent-registry skills list \
    --project=PROJECT_ID \
    --location=LOCATION

Untuk melihat detail skill tertentu, gunakan perintah gcloud alpha agent-registry skills describe:

gcloud alpha agent-registry skills describe SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

Ganti kode berikut:

  • SKILL_ID: ID keterampilan yang ingin Anda tinjau. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
  • PROJECT_ID: project ID.
  • LOCATION: lokasi registry.

REST

Untuk mengambil daftar semua keterampilan, kirim permintaan GET:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills"

Untuk mengambil satu penampung keterampilan, kirim permintaan GET:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID"

Ganti kode berikut:

  • PROJECT_ID: project ID.
  • LOCATION: lokasi registry.
  • SKILL_ID: ID keterampilan yang ingin Anda tinjau. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.

Memperbarui metadata skill atau revisi default

Anda dapat mengubah nama tampilan, deskripsi, atau mengubah pointer revisi default secara manual untuk men-deploy versi yang berbeda. Untuk membuat revisi skill baru, lihat Mengelola revisi skill.

Untuk memperbarui metadata keahlian atau revisi default keahlian tertentu, ikuti langkah-langkah berikut:

Konsol

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

    Buka Agent Registry

  2. Pilih tab Keterampilan.
  3. Tinjau daftar keterampilan. Anda dapat memfilter tampilan menggunakan menu Location atau Status.
  4. Klik nama keahlian apa pun untuk membuka halaman Skill Details, yang menampilkan nama, deskripsi, versi aktif, ID keahlian, terakhir diperbarui, metadata kustom, dan histori revisi.

  5. Pilih salah satu opsi berikut:

    • Memperbarui metadata keterampilan:

      1. Klik Edit.
      2. Di panel Edit skill, perbarui nama tampilan atau deskripsi skill Anda.
      3. Klik Simpan.

    • Memperbarui revisi default:

      1. Temukan tabel Histori versi.
      2. Temukan revisi yang ingin Anda tetapkan sebagai aktif.
      3. Di kolom Tindakan, klik Aktifkan versi.

gcloud

  • Untuk memperbarui metadata skill, gunakan perintah gcloud alpha agent-registry skills update:

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

  • Untuk memperbarui revisi penyajian default skill, gunakan perintah gcloud alpha agent-registry skills update dan tentukan nama resource revisi target:

    gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --default-revision="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"

Ganti kode berikut:

  • SKILL_ID: ID keterampilan yang ingin Anda perbarui. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
  • PROJECT_ID: project ID.
  • LOCATION: lokasi registry.
  • DISPLAY_NAME: nama tampilan yang diperbarui.
  • DESCRIPTION: deskripsi yang diperbarui.
  • REVISION_ID: ID revisi keahlian yang ingin Anda tetapkan sebagai default.

REST

Kirim permintaan PATCH yang menentukan kolom yang ingin Anda perbarui:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
        "displayName": "DISPLAY_NAME",
        "description": "DESCRIPTION",
        "defaultRevision": "projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"
      }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=displayName,description,defaultRevision"

Ganti kode berikut:

  • DISPLAY_NAME: nama tampilan keterampilan yang diperbarui.
  • DESCRIPTION: deskripsi keterampilan yang diperbarui.
  • PROJECT_ID: project ID.
  • LOCATION: lokasi registry.
  • SKILL_ID: ID keterampilan yang ingin Anda perbarui. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
  • REVISION_ID: ID revisi skill yang ingin Anda aktifkan.

Mengelola status siklus proses skill

Untuk mengontrol cara penyelesaian skill saat runtime, Anda dapat mengubah status target skill:

  • Aktif: keahlian ditayangkan dan dapat diselesaikan sepenuhnya. Menetapkan keahlian ke Active mengharuskan kolom defaultRevision-nya mengarah ke revisi keahlian yang aktif.
  • Nonaktif: status awal default saat keahlian dibuat. Keahlian tidak disajikan saat runtime, penyelesaian keahlian langsung gagal, dan download payload diblokir. Keahlian juga ditempatkan dalam status Dinonaktifkan jika pointer defaultRevision-nya dihapus atau jika revisi default-nya dihapus. Tidak seperti status Decommissioned, Anda dapat mengaktifkan keterampilan yang dinonaktifkan dengan menetapkan defaultRevision yang valid dan memperbarui status targetnya ke Active.
  • Tidak digunakan lagi: keahlian masih dapat dimuat dan didownload, tetapi menunjukkan bahwa keahlian tersebut akan dinonaktifkan.
  • Dinonaktifkan: keahlian dinonaktifkan secara permanen, tidak lagi ditayangkan, dan tidak dapat dikembalikan ke status Aktif atau status lainnya. Keahlian hanya dapat dinonaktifkan setelah tidak digunakan lagi. Berikan waktu yang cukup untuk bermigrasi sebelum menonaktifkan skill. Karena status ini bersifat terminal, gunakan dengan hati-hati.

Untuk mentransisikan status siklus proses keterampilan:

Konsol

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

    Buka Agent Registry

  2. Pilih tab Keterampilan.
  3. Tinjau daftar keterampilan. Anda dapat memfilter tampilan menggunakan menu Location atau Status.
  4. Klik nama keahlian apa pun untuk membuka halaman Skill Details, yang menampilkan nama, deskripsi, versi aktif, ID keahlian, terakhir diperbarui, metadata kustom, dan histori revisi.
  5. Gunakan tombol kontrol status untuk mentransisikan status target. Tombol yang ditampilkan halaman bergantung pada status keterampilan saat ini, misalnya, Enable, Disable, Deprecate, atau Decommission.

gcloud

Perbarui container skill dengan perintah gcloud alpha agent-registry skills update dan flag --target-state:

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --target-state=DISABLED

Ganti kode berikut:

  • SKILL_ID: ID keterampilan yang ingin Anda perbarui. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
  • PROJECT_ID: project ID.
  • LOCATION: lokasi registry.

Nilai yang diizinkan untuk status target adalah:

  • ACTIVE
  • DISABLED
  • DEPRECATED
  • DECOMMISSIONED

REST

Kirim permintaan PATCH yang menentukan targetState dalam isi dan dalam masker update:

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "targetState": "TARGET_STATE_DISABLED"
    }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=targetState"

Ganti kode berikut:

  • PROJECT_ID: project ID.
  • LOCATION: lokasi registry.
  • SKILL_ID: ID keterampilan yang ingin Anda perbarui. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.

Nilai yang diizinkan untuk status target adalah:

  • TARGET_STATE_ACTIVE
  • TARGET_STATE_DISABLED
  • TARGET_STATE_DEPRECATED
  • TARGET_STATE_DECOMMISSIONED

Menghapus keterampilan

Menghapus container keahlian akan menghapus resource Skill dan semua resource SkillRevision yang tidak dapat diubah secara permanen. Agen yang mencoba menyelesaikan ID keterampilan yang dihapus akan gagal saat runtime.

Konsol

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

    Buka Agent Registry

  2. Pilih tab Keterampilan.
  3. Tinjau daftar keterampilan. Anda dapat memfilter tampilan menggunakan menu Location atau Status.
  4. Klik nama keterampilan yang ingin Anda hapus.
  5. Di halaman Skill Details, klik Delete.
  6. Pada dialog konfirmasi, masukkan DELETE dan klik Delete.

gcloud

Untuk menghapus skill, gunakan perintah gcloud alpha agent-registry skills delete:

gcloud alpha agent-registry skills delete SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

Ganti kode berikut:

  • SKILL_ID: ID keterampilan yang ingin Anda hapus. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.
  • PROJECT_ID: project ID.
  • LOCATION: lokasi registry.

REST

Untuk menghapus keahlian, kirim permintaan DELETE:

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?force=true"

Ganti kode berikut:

  • PROJECT_ID: project ID.
  • LOCATION: lokasi registry.
  • SKILL_ID: ID keterampilan yang ingin Anda hapus. Untuk kemampuan yang didaftarkan secara manual, sertakan awalan private-, seperti private-my-skill.

Langkah berikutnya