View a markdown version of this page

AI 代理器的技能資產 - AWS Glue
什麼是技能資產建立和關聯技能如何定義關係搜尋技能資產內建技能刪除技能資產考量事項

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AI 代理器的技能資產

注意

商業內容和語意搜尋為 預覽版 AWS Glue ，可能會有所變更。

什麼是技能資產

技能資產是指向 URI 位置的目錄資產，其中包含 AI 代理器在使用您的資料時所使用的內容。URI 可以參考可存取的位置，例如 Amazon S3 中的 Markdown 檔案、git 儲存庫中的文件，或是存放一或多個資料集特定之組織和網域知識、參考和指示的 Wiki 頁面。

技能內容的常見用途包括：

  • 組織內容 （例如，哪些團隊擁有哪些資料網域、團隊如何定義關鍵指標，以及哪些業務流程產生資料）

  • 組織特定的資料使用規則和限制

  • 資料集的常見查詢模式和 SQL 範例

您可以使用 amazon::RelatedTo表單將技能與資料資產建立關聯。當代理程式擷取資產時，它會尋找相關聯的技能 IDs、擷取技能，並將 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:GetObjectAmazon S3 URIs)。

  • 保持技能內容簡潔，將內容時段用量降至最低。