Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Aset keterampilan untuk agen AI
<a name="catalog-skill-assets"></a>

**catatan**  
Konteks bisnis dan pencarian semantik dalam pratinjau AWS Glue dan dapat berubah sewaktu-waktu.

## Apa itu aset keterampilan
<a name="catalog-skill-assets-overview"></a>

Aset keterampilan adalah aset katalog yang mengarah ke lokasi URI yang berisi konteks yang digunakan agen AI saat bekerja dengan data Anda. URI dapat mereferensikan lokasi yang dapat diakses—seperti file penurunan harga di Amazon S3, dokumen dalam repositori git, atau halaman wiki — tempat Anda menyimpan pengetahuan, referensi, dan instruksi organisasi dan domain khusus untuk satu atau beberapa kumpulan data.

Penggunaan umum untuk konten keterampilan meliputi:
+ Konteks organisasi (misalnya, tim mana yang memiliki domain data mana, bagaimana tim mendefinisikan metrik kunci, dan proses bisnis apa yang menghasilkan data)
+ Aturan dan batasan penggunaan data khusus untuk organisasi Anda
+ Pola kueri umum dan contoh SQL untuk kumpulan data Anda

Anda mengaitkan keterampilan dengan aset data menggunakan `amazon::RelatedTo` formulir. Ketika agen mengambil aset, ia menemukan ID keterampilan terkait, mengambil keterampilan, dan memuat konten URI ke dalam konteks penalarannya.

Ada dua jenis keterampilan:
+ **Keterampilan khusus** - Dibuat oleh Anda, dapat dicari melalui API. `SearchAssets` Pengidentifikasi tidak boleh dimulai dengan `amazon.`
+ **Built-in keterampilan** — Amazon-owned, tidak dapat diubah, diakses oleh ID secara langsung (misalnya,`amazon.skill::querying-aws-s3`).

## Menciptakan dan mengasosiasikan keterampilan
<a name="catalog-skill-assets-create"></a>

### Langkah 1: Buat keterampilan
<a name="catalog-skill-assets-create-skill"></a>

```
aws glue put-asset \
    --asset-type-id "amazon::Skill" \
    --identifier "sales-table-skill" \
    --name "sales-table-skill" \
    --forms '{"amazon::Skill":{"FormTypeId":"amazon::Skill","Content":"{\"uri\": \"s3://my-bucket/skills/sales-table-skill.md\"}"}}'
```

### Langkah 2: Kaitkan keterampilan dengan tabel
<a name="catalog-skill-assets-create-associate"></a>

```
aws glue put-attachment \
    --asset-identifier "arn:aws:glue:us-east-1:123456789012:table/mydb/sales_transactions" \
    --attachment-name relatedTo \
    --form-type-id "amazon::RelatedTo" \
    --content '{"assetIdentifiers":["sales-table-skill"]}'
```

## Bagaimana hubungan didefinisikan
<a name="catalog-skill-assets-relationships"></a>

Hubungan menggunakan `amazon::RelatedTo` formulir bawaan. Relasi yang dideklarasikan pada salah satu aset muncul secara simetris untuk keduanya dalam pencarian berbasis hubungan.

```
{ "assetIdentifiers": ["<related-asset-id>"] }
```

Lampirkan sebaris saat membuat aset (`PutAsset --forms`) atau afterward (`PutAttachment`).

## Mencari aset keterampilan
<a name="catalog-skill-assets-list"></a>

```
aws glue search-assets \
    --filter-clause '{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Skill"}}}' \
    --max-results 20
```

## Built-in keterampilan
<a name="catalog-skill-assets-builtin"></a>

Referensi Amazon-owned keterampilan berikut dengan ID:
+ `amazon.skill::querying-aws-s3`
+ `amazon.skill::querying-aws-cloudwatch`
+ `amazon.skill::querying-aws-sagemaker-catalog`

## Menghapus aset keterampilan
<a name="catalog-skill-assets-delete"></a>

```
aws glue delete-asset \
    --identifier {{skill-asset-id}}
```

**catatan**  
Menghapus aset keterampilan tidak akan menghapus konten di URI yang direferensikan.

## Pertimbangan-pertimbangan
<a name="catalog-skill-assets-considerations"></a>
+ Tinjau konten keterampilan saat Anda mengganti nama kolom, menghentikan tabel, atau memodifikasi metrik.
+ Selama pratinjau, akses dikelola melalui peran IAM tanpa kontrol akses tingkat aset.
+ Agen harus memiliki akses ke URI keterampilan (misalnya, `s3:GetObject` untuk URI Amazon S3).
+ Jaga konten keterampilan tetap ringkas untuk meminimalkan penggunaan jendela konteks.