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.

# Commencer à utiliser le contexte commercial dans le catalogue de données
<a name="catalog-business-context-getting-started"></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.

Ce didacticiel vous explique comment créer un glossaire, étiqueter les actifs et utiliser la recherche sémantique pour découvrir les données par leur signification.

## Conditions préalables
<a name="business-context-getting-started-prereqs"></a>
+ Un AWS compte avec le catalogue de AWS Glue données configuré dans une région prise en charge.
+ Le AWS CLI installé et configuré.
+ Au moins une table est enregistrée dans le catalogue de données.
+ Rôle ou utilisateur IAM autorisé à effectuer des actions dans le catalogue de AWS Glue données.

Joignez la politique IAM suivante pour accorder les autorisations requises :

```
{
    "Version": "2012-10-17",
    "Statement": [{
        "Effect": "Allow",
        "Action": [
            "glue:SearchAssets", "glue:PutAsset", "glue:GetAsset", "glue:DeleteAsset",
            "glue:PutAssetType", "glue:GetAssetType", "glue:DeleteAssetType", "glue:ListAssetTypes",
            "glue:CreateGlossary", "glue:UpdateGlossary", "glue:GetGlossary", "glue:ListGlossaries", "glue:DeleteGlossary",
            "glue:CreateGlossaryTerm", "glue:UpdateGlossaryTerm", "glue:GetGlossaryTerm", "glue:ListGlossaryTerms", "glue:DeleteGlossaryTerm",
            "glue:AssociateGlossaryTerms", "glue:DisassociateGlossaryTerms",
            "glue:PutFormType", "glue:GetFormType", "glue:DeleteFormType", "glue:ListFormTypes",
            "glue:PutAttachment", "glue:DeleteAttachment",
            "glue:ListIterableForms", "glue:BatchGetIterableForms"
        ],
        "Resource": "*"
    }]
}
```

## Étape 1 : créer un glossaire et étiqueter une ressource
<a name="business-context-step1-create-glossary"></a>

**Pour créer un glossaire**  
Exécutez la commande suivante :

```
aws glue create-glossary \
  --name "Enterprise Data Glossary" \
  --description "Standardized business definitions for enterprise data assets."
```

Exemple de sortie :

```
{
    "Id": "d7xm3np5rk2w9j",
    "Name": "Enterprise Data Glossary"
}
```

**Pour créer un terme du glossaire**  
Remplacez l'identifiant du glossaire par celui `Id` de la sortie précédente.

```
aws glue create-glossary-term \
  --glossary-identifier "d7xm3np5rk2w9j" \
  --name "Active User" \
  --short-description "A user with at least one login in the last 30 days." \
  --long-description "An account that has logged in at least once within the trailing 30-day window."
```

Exemple de sortie :

```
{
    "Id": "c2fymbu18rtsx5",
    "GlossaryId": "d7xm3np5rk2w9j",
    "Name": "Active User"
}
```

**Pour associer le terme à un actif**  
Exécutez la commande suivante :

```
aws glue associate-glossary-terms \
  --identifier "arn:aws:glue:us-east-1:123456789012:table/mydb/sales_transactions" \
  --glossary-term-identifiers "c2fymbu18rtsx5"
```

## Étape 2 : Rechercher des données à l'aide du contexte commercial
<a name="business-context-step2-search"></a>

Utilisez l'`SearchAssets`API pour rechercher des actifs par sens commercial.

```
aws glue search-assets \
  --search-text "active users"
```

Exemple de sortie :

```
{
    "Items": [
        {"Id": "c9vq7sh2fk4t2h", "AssetName": "Customer Sales Transactions", "AssetTypeId": "Table"}
    ]
}
```

Pour filtrer les résultats par type de ressource :

```
aws glue search-assets \
  --search-text "active users" \
  --filter-clause '{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Table"}}}' \
  --max-results 10
```

Pour filtrer uniquement les AWS Glue tables (à l'exclusion des tables provenant d'autres systèmes sources) :

```
aws glue search-assets \
  --search-text "active users" \
  --filter-clause '{"AndAllFilters":[{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Table"}}},{"AttributeFilter":{"Attribute":"namespace","Operator":"equals","Value":{"StringValue":"amazon.glue"}}}]}' \
  --max-results 10
```

## Utilisation d'agents d'IA avec le catalogue
<a name="business-context-getting-started-agent-toolkit"></a>

MCP-compatible Les agents d'intelligence artificielle peuvent découvrir les actifs du catalogue, récupérer le contexte commercial et charger du contenu de compétences en utilisant les compétences du kit d'outils des AWS agents. Vous pouvez acquérir des compétences en matière de catalogue de différentes manières :
+ **Fourni avec un plugin** : installez le `aws-data-analytics` plugin, qui inclut un ensemble de compétences de catalogue sélectionnées à la disposition de l'agent immédiatement après l'installation. Pour obtenir des instructions, consultez la section [Installation de plug-ins](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/plugins.html#installing-plugins) dans le guide de l'utilisateur de l' AWS Agent Toolkit.
+ **Installé localement** : téléchargez les compétences individuelles depuis le kit d'outils de l'agent pour AWS les stocker GitHub et ajoutez-les au répertoire des compétences de votre agent. Les compétences suivantes prennent en charge les flux de travail du catalogue :
  + [exploration du catalogue de données](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills/exploring-data-catalog)
  + [trouver des actifs dans un lac de données](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills/finding-data-lake-assets)

## Étapes suivantes
<a name="business-context-getting-started-next-steps"></a>
+ Joignez des formulaires pour standardiser les champs de métadonnées tels que la résidence des données ou la politique de rétention.
+ Créez des actifs de compétences qui fournissent aux agents d'intelligence artificielle un contexte de domaine pour vos données.