View a markdown version of this page

Ativos de habilidades para agentes de IA - AWS Glue
O que são ativos de habilidadesCriação e associação de uma habilidadeComo os relacionamentos são definidosPesquisa de ativos de habilidadesHabilidades integradasExclusão de um ativo de habilidadeConsiderações

Ativos de habilidades para agentes de IA

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

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

Etapa 1: criar a habilidade

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

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

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

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

Habilidades integradas

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

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

  • 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.