Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Risorse di competenze per gli agenti di intelligenza artificiale
<a name="catalog-skill-assets"></a>

**Nota**  
Il contesto aziendale e la ricerca semantica sono disponibili in anteprima AWS Glue e sono soggette a modifiche.

## Cosa sono le risorse relative alle competenze
<a name="catalog-skill-assets-overview"></a>

Le risorse di competenze sono risorse di catalogo che rimandano a una posizione URI contenente il contesto utilizzato dagli agenti di intelligenza artificiale quando lavorano con i dati. L'URI può fare riferimento a una posizione accessibile, ad esempio un file markdown in Amazon S3, un documento in un repository git o una pagina wiki, in cui archiviare conoscenze organizzative e di dominio, riferimenti e istruzioni specifici per uno o più set di dati.

Gli usi comuni dei contenuti relativi alle competenze includono:
+ Contesto organizzativo (ad esempio, quali team possiedono quali domini di dati, in che modo i team definiscono le metriche chiave e quali processi aziendali producono i dati)
+ Regole e vincoli di utilizzo dei dati specifici dell'organizzazione
+ Modelli di query comuni ed esempi SQL per i tuoi set di dati

Associate le competenze agli asset di dati utilizzando il `amazon::RelatedTo` modulo. Quando un agente recupera una risorsa, trova gli ID delle abilità associate, recupera la competenza e carica il contenuto dell'URI nel relativo contesto di ragionamento.

Esistono due tipi di abilità:
+ **Competenze personalizzate**: create da te, ricercabili tramite l'`SearchAssets`API. Gli identificatori non devono iniziare con `amazon.`
+ **Built-in competenze**: Amazon-owned immutabili, accessibili direttamente tramite ID (ad esempio,). `amazon.skill::querying-aws-s3`

## Creazione e associazione di un'abilità
<a name="catalog-skill-assets-create"></a>

### Fase 1: Creare l'abilità
<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\"}"}}'
```

### Fase 2: Associare l'abilità a una tabella
<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"]}'
```

## Come vengono definite le relazioni
<a name="catalog-skill-assets-relationships"></a>

Le relazioni utilizzano il `amazon::RelatedTo` modulo integrato. Una relazione dichiarata su uno degli asset viene visualizzata simmetricamente per entrambi nella ricerca basata sulle relazioni.

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

Attacca in linea durante la creazione dell'asset () o successivamente ()`PutAsset --forms`. `PutAttachment`

## Alla ricerca di risorse in materia di competenze
<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 competenze
<a name="catalog-skill-assets-builtin"></a>

Fai riferimento alle seguenti Amazon-owned competenze tramite ID:
+ `amazon.skill::querying-aws-s3`
+ `amazon.skill::querying-aws-cloudwatch`
+ `amazon.skill::querying-aws-sagemaker-catalog`

## Eliminazione di una risorsa di abilità
<a name="catalog-skill-assets-delete"></a>

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

**Nota**  
L'eliminazione di una risorsa di competenze non elimina il contenuto dell'URI di riferimento.

## Considerazioni
<a name="catalog-skill-assets-considerations"></a>
+ Esamina il contenuto delle competenze quando rinomini le colonne, rendi obsolete le tabelle o modifichi le metriche.
+ Durante l'anteprima, l'accesso viene gestito tramite ruoli IAM senza controllo degli accessi a livello di asset.
+ Gli agenti devono avere accesso all'URI della skill (ad esempio, `s3:GetObject` per gli URI di Amazon S3).
+ Mantieni concisi i contenuti relativi alle competenze per ridurre al minimo l'utilizzo delle finestre contestuali.