# 在 Data Catalog 中开始使用业务上下文
<a name="catalog-business-context-getting-started"></a>

**注意**  
业务上下文和语义搜索目前为预览 AWS Glue 状态，可能会发生更改。

本教程将引导您创建术语表、标记资产以及使用语义搜索按含义发现数据。

## 先决条件
<a name="business-context-getting-started-prereqs"></a>
+ 在支持的区域中配置了 AWS Glue Data Catalog 的 AWS 账户。
+ AWS CLI 已安装并配置完成。
+ Data Catalog 中至少注册了一个表。
+ 具有 AWS Glue Data Catalog 操作权限的 IAM 角色或用户。

请附加以下 IAM 策略以授予所需的权限：

```
{
    "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": "*"
    }]
}
```

## 第 1 步：创建术语表并标记资产
<a name="business-context-step1-create-glossary"></a>

**创建术语表**  
运行以下命令：

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

输出示例：

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

**创建术语表条目**  
将术语表标识符替换为前面输出中的`Id`。

```
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."
```

输出示例：

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

**将术语与资产相关联**  
运行以下命令：

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

## 第 2 步：使用业务上下文搜索数据
<a name="business-context-step2-search"></a>

使用 `SearchAssets` API 按业务含义查找资产。

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

输出示例：

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

按资产类型筛选结果：

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

要仅筛选到 AWS Glue 表（不包括来自其他源系统的表），请执行以下操作：

```
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
```

## 将人工智能代理与目录配合使用
<a name="business-context-getting-started-agent-toolkit"></a>

兼容 MCP 的人工智能代理可以使用 AWS 代理工具包中的技能发现目录资产、检索业务上下文和加载技能内容。您可以通过下列方式获得目录技能：
+ **与插件捆绑在一起**–安装 `aws-data-analytics` 插件，其中包括一组精选的目录技能，供代理在安装后立即使用。有关说明，请参阅《AWS代理工具包用户指南》中的[安装插件](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/plugins.html#installing-plugins)。
+ **本地安装**–从 GitHub 上的 AWS 存储库的代理工具包下载单个技能，然后将其添加到代理的技能目录中。以下技能支持目录工作流程：
  + [exploring-data-catalog](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills/exploring-data-catalog)
  + [finding-data-lake-assets](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills/finding-data-lake-assets)

## 后续步骤
<a name="business-context-getting-started-next-steps"></a>
+ 附加表单以标准化元数据字段，例如数据驻留或保留政策。
+ 创建技能资产，为人工智能代理提供数据域上下文。