# Introducción al contexto empresarial en el Catálogo de datos
<a name="catalog-business-context-getting-started"></a>

**nota**  
El contexto empresarial y la búsqueda semántica se encuentran en una versión preliminar para AWS Glue, y están sujetos a cambios.

En este tutorial se explica cómo crear un glosario, etiquetar activos y utilizar la búsqueda semántica para detectar datos por su significado.

## Requisitos previos
<a name="business-context-getting-started-prereqs"></a>
+ Una cuenta de AWS con el Catálogo de datos de AWS Glue configurado en una región compatible.
+ La AWS CLI debe estar instalada y configurada.
+ Debe haber como mínimo una tabla registrada en el Catálogo de datos.
+ Un rol o usuario de IAM con permisos para las acciones del Catálogo de datos de AWS Glue.

Asocie la siguiente política de IAM para conceder los permisos necesarios:

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

## Paso 1: Crear un glosario y etiquetar un activo
<a name="business-context-step1-create-glossary"></a>

**Cómo crear un glosario**  
Use el siguiente comando:

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

Ejemplo de código de salida:

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

**Cómo crear un término del glosario**  
Sustituya el identificador del glosario por el `Id` del resultado anterior.

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

Ejemplo de código de salida:

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

**Cómo asociar el término a un activo**  
Use el siguiente comando:

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

## Paso 2: Buscar datos utilizando el contexto empresarial
<a name="business-context-step2-search"></a>

Utilice la API `SearchAssets` para buscar activos por significado empresarial.

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

Ejemplo de código de salida:

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

Cómo filtrar los resultados por tipo de activo:

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

Cómo filtrar solo las tablas de AWS Glue (excluyendo las tablas de otros sistemas de origen):

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

## Uso de los agentes de IA con el catálogo
<a name="business-context-getting-started-agent-toolkit"></a>

Los agentes de IA compatibles con MCP pueden detectar los activos del catálogo, recuperar el contexto empresarial y cargar el contenido relacionado con las habilidades del kit de herramientas de agentes para AWS. Puede obtener habilidades del catálogo de las siguientes formas:
+ **Agrupada con un complemento**: instale el complemento `aws-data-analytics`, que incluye un conjunto seleccionado de habilidades de catálogo disponibles para el agente inmediatamente después de la instalación. Para obtener instrucciones, consulte [Installing plugins](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/plugins.html#installing-plugins) en la Guía del usuario del Kit de herramientas de agentes para AWS.
+ **Instalada localmente**: descargue las habilidades individuales del Kit de herramientas de agentes para el repositorio de AWS en GitHub y agréguelas al directorio de habilidades de su agente. Las siguientes habilidades son compatibles con los flujos de trabajo del catálogo:
  + [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)

## Siguientes pasos
<a name="business-context-getting-started-next-steps"></a>
+ Adjunte formularios para estandarizar los campos de metadatos, como la residencia de datos o la política de retención.
+ Cree recursos de habilidades que proporcionen a los agentes de IA un contexto de dominio para sus datos.