View a markdown version of this page

AI 에이전트를 위한 스킬 자산 - AWS Glue
스킬 자산 정의스킬 생성 및 연결관계 정의 방법스킬 자산 검색내장 스킬스킬 자산 삭제고려 사항

AI 에이전트를 위한 스킬 자산

참고

AWS Glue의 비즈니스 컨텍스트와 시맨틱 검색은 미리 보기로 제공되며 변경될 수 있습니다.

스킬 자산 정의

스킬 자산은 AI 에이전트가 데이터 작업 시 사용하는 컨텍스트가 포함된 URI 위치를 가리키는 카탈로그 자산입니다. URI는 하나 이상의 데이터 세트에 특정한 조직 및 도메인 지식, 참조 및 지침을 저장하는 액세스 가능한 위치(예: Amazon S3의 마크다운 파일, git 리포지토리의 문서, wiki 페이지)를 참조할 수 있습니다.

스킬 콘텐츠의 일반적인 용도는 다음과 같습니다.

  • 조직 컨텍스트(예: 어느 팀이 어떤 데이터 도메인을 소유하는지, 어느 팀이 주요 지표를 정의하는지, 어느 비즈니스 프로세스가 데이터를 생성하는지)

  • 조직별 데이터 사용 규칙 및 제약 조건

  • 데이터 세트에 대한 일반적인 쿼리 패턴 및 SQL 예제

amazon::RelatedTo 양식을 사용하여 스킬을 데이터 자산과 연결합니다. 에이전트는 자산을 검색할 때 연결된 스킬 ID를 찾고, 스킬을 가져오고, URI 콘텐츠를 추론 컨텍스트에 로드합니다.

다음 두 가지 종류의 스킬이 있습니다.

  • 사용자 지정 스킬 - 사용자가 생성하며 SearchAssets API를 통해 검색할 수 있습니다. 식별자는 amazon.으로 시작해서는 안 됩니다.

  • 내장 스킬 - Amazon 소유이고, 변경 불가능하며, ID로 직접 액세스합니다(예: amazon.skill::querying-aws-s3).

스킬 생성 및 연결

1단계: 규칙 생성

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\"}"}}'

2단계: 테이블과 스킬 연결

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"]}'

관계 정의 방법

관계는 내장 amazon::RelatedTo 양식을 사용합니다. 관계 기반 검색에서 두 자산 중 하나에 선언된 관계는 양쪽 모두 대칭적으로 나타납니다.

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

자산을 생성할 때(PutAsset --forms) 또는 나중에(PutAttachment) 인라인으로 연결합니다.

스킬 자산 검색

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

내장 스킬

ID로 다음 Amazon 소유 스킬을 참조합니다.

  • amazon.skill::querying-aws-s3

  • amazon.skill::querying-aws-cloudwatch

  • amazon.skill::querying-aws-sagemaker-catalog

스킬 자산 삭제

aws glue delete-asset \
    --identifier skill-asset-id
참고

스킬 자산을 삭제해도 참조된 URI의 콘텐츠는 삭제되지 않습니다.

고려 사항

  • 열의 이름을 바꾸거나, 테이블을 사용 중지하거나, 지표를 수정할 때 스킬 콘텐츠를 검토합니다.

  • 미리 보기 중 자산 수준 액세스 제어 없이 IAM 역할을 통해 액세스가 관리됩니다.

  • 에이전트는 스킬 URI(예: s3:GetObject Amazon S3 URI)에 액세스할 수 있어야 합니다.

  • 스킬 콘텐츠를 간결하게 유지하여 컨텍스트 창 사용을 최소화합니다.