Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Atouts de compétences pour les agents d'IA
<a name="catalog-skill-assets"></a>

**Note**  
Le contexte commercial et la recherche sémantique sont en cours de prévisualisation AWS Glue et sont susceptibles d'être modifiés.

## Que sont les actifs de compétences
<a name="catalog-skill-assets-overview"></a>

Les actifs de compétences sont des actifs de catalogue qui pointent vers un emplacement URI contenant le contexte que les agents d'IA utilisent lorsqu'ils travaillent avec vos données. L'URI peut faire référence à un emplacement accessible, tel qu'un fichier de balisage dans Amazon S3, un document dans un référentiel git ou une page wiki, où vous stockez des connaissances, des références et des instructions relatives à l'organisation et au domaine spécifiques à un ou plusieurs ensembles de données.

Les utilisations courantes du contenu relatif aux compétences incluent :
+ Contexte organisationnel (par exemple, quelles équipes possèdent quels domaines de données, comment les équipes définissent les indicateurs clés et quels processus métier produisent les données)
+ Règles et contraintes d'utilisation des données spécifiques à votre organisation
+ Modèles de requête courants et exemples SQL pour vos ensembles de données

Vous associez les compétences aux actifs de données à l'aide du `amazon::RelatedTo` formulaire. Lorsqu'un agent récupère un actif, il trouve les identifiants de compétence associés, récupère la compétence et charge le contenu de l'URI dans son contexte de raisonnement.

Il existe deux types de compétences :
+ **Compétences personnalisées** : créées par vos soins, consultables via l'`SearchAssets`API. Les identifiants ne doivent pas commencer par `amazon.`
+ **Built-in compétences** — Amazon-owned, immuables, accessibles directement par identifiant (par exemple,`amazon.skill::querying-aws-s3`).

## Création et association d'une compétence
<a name="catalog-skill-assets-create"></a>

### Étape 1 : Création de la compétence
<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\"}"}}'
```

### Étape 2 : associer la compétence à un tableau
<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"]}'
```

## Comment les relations sont définies
<a name="catalog-skill-assets-relationships"></a>

Les relations utilisent le `amazon::RelatedTo` formulaire intégré. Une relation déclarée sur l'un ou l'autre des actifs apparaît symétriquement pour les deux dans le cadre d'une recherche basée sur les relations.

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

Attachez en ligne lors de la création de l'actif (`PutAsset --forms`) ou ultérieurement (`PutAttachment`).

## Recherche d'actifs de compétences
<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 compétences
<a name="catalog-skill-assets-builtin"></a>

Référencez les Amazon-owned compétences suivantes par identifiant :
+ `amazon.skill::querying-aws-s3`
+ `amazon.skill::querying-aws-cloudwatch`
+ `amazon.skill::querying-aws-sagemaker-catalog`

## Supprimer un actif de compétence
<a name="catalog-skill-assets-delete"></a>

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

**Note**  
La suppression d'un actif de compétence ne supprime pas le contenu de l'URI référencé.

## Considérations
<a name="catalog-skill-assets-considerations"></a>
+ Passez en revue le contenu des compétences lorsque vous renommez des colonnes, désapprouvez des tables ou modifiez des métriques.
+ Pendant la version préliminaire, l'accès est géré via des rôles IAM sans contrôle d'accès au niveau des actifs.
+ Les agents doivent avoir accès à l'URI de la compétence (par exemple, `s3:GetObject` pour les URI Amazon S3).
+ Veillez à ce que le contenu des compétences soit concis afin de minimiser l'utilisation des fenêtres contextuelles.