# Ativos de habilidades para agentes de IA
<a name="catalog-skill-assets"></a>

**nota**  
O contexto de negócios e a pesquisa semântica estão em demonstração para o AWS Glue e estão sujeitos a alterações.

## O que são ativos de habilidades
<a name="catalog-skill-assets-overview"></a>

Os ativos de habilidades são os ativos do catálogo que apontam para um local de URI que contém o contexto que os agentes de IA usam ao trabalhar com seus dados. O URI pode fazer referência a um local acessível, como um arquivo markdown no Amazon S3, um documento em um repositório git ou uma página wiki, onde você armazena conhecimentos organizacionais e de domínio, referências e instruções específicas para um ou mais conjuntos de dados.

Os usos comuns do conteúdo de habilidades incluem:
+ Contexto organizacional (por exemplo, quais equipes possuem quais domínios de dados, como as equipes definem as principais métricas e quais processos de negócios produzem os dados)
+ Regras e restrições de uso de dados específicas para sua organização
+ Padrões de consulta comuns e exemplos de SQL para seus conjuntos de dados

Você associa habilidades a ativos de dados usando o formulário `amazon::RelatedTo`. Quando um agente recupera um ativo, ele encontra as IDs de habilidade associadas, busca a habilidade e carrega o conteúdo do URI em seu contexto de raciocínio.

Há dois tipos de habilidades:
+ **Habilidades personalizadas**: criadas por você, pesquisáveis por meio da API `SearchAssets`. Os identificadores não podem começar com `amazon.`
+ **Habilidades integradas**: de propriedade da Amazon, imutáveis, acessadas diretamente por ID (por exemplo, `amazon.skill::querying-aws-s3`).

## Criação e associação de uma habilidade
<a name="catalog-skill-assets-create"></a>

### Etapa 1: criar a habilidade
<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\"}"}}'
```

### Etapa 2: associar a habilidade à tabela
<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"]}'
```

## Como os relacionamentos são definidos
<a name="catalog-skill-assets-relationships"></a>

Os relacionamentos usam o formulário `amazon::RelatedTo` incorporado. Uma relação declarada em qualquer ativo aparece simetricamente para ambos na pesquisa baseada em relacionamento.

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

Anexe em linha ao criar o ativo (`PutAsset --forms`) ou depois (`PutAttachment`).

## Pesquisa de ativos de habilidades
<a name="catalog-skill-assets-list"></a>

```
aws glue search-assets \
    --filter-clause '{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Skill"}}}' \
    --max-results 20
```

## Habilidades integradas
<a name="catalog-skill-assets-builtin"></a>

Consulte as seguintes habilidades de propriedade da Amazon por ID:
+ `amazon.skill::querying-aws-s3`
+ `amazon.skill::querying-aws-cloudwatch`
+ `amazon.skill::querying-aws-sagemaker-catalog`

## Exclusão de um ativo de habilidade
<a name="catalog-skill-assets-delete"></a>

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

**nota**  
A exclusão de um ativo de habilidade não exclui o conteúdo no URI referenciado.

## Considerações
<a name="catalog-skill-assets-considerations"></a>
+ Analise o conteúdo da habilidade ao renomear colunas, descontinuar tabelas ou modificar métricas.
+ Durante a demonstração, o acesso é gerenciado por meio de perfis do IAM sem controle de acesso no nível do ativo.
+ Os agentes precisam ter acesso ao URI da habilidade (por exemplo, `s3:GetObject` para URIs do Amazon S3).
+ Mantenha o conteúdo das habilidades conciso para minimizar o uso da janela de contexto.