本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
將常見問答集 FAQs) 新增至索引
注意
功能支援會因索引類型和正在使用的搜尋 API 而有所不同。若要查看您所使用的索引類型和搜尋 API 是否支援此功能，請參閱索引類型。
您可以使用主控台或 CreateFaq API，直接將常見問答集 (FAQs) 新增至您的索引。將FAQs新增至索引是一種非同步操作。您可以將 FAQ 的資料放入存放在 Amazon Simple Storage Service 儲存貯體的檔案中。您可以使用 CSV 或 JSON 檔案做為常見問答集的輸入：
-
基本 CSV - CSV 檔案，其中每一列都包含問題、答案和選用的來源 URI。
-
自訂 CSV - CSV 檔案，其中包含自訂欄位/屬性的問題、答案和標頭，可用於構面、顯示或排序常見問答集回應。您也可以定義存取控制欄位，將常見問答集回應限制為允許查看常見問答集回應的特定使用者和群組。
-
JSON - JSON 檔案，其中包含問題、答案和自訂欄位/屬性，可用於構面、顯示或排序常見問答集回應。您也可以定義存取控制欄位，將常見問答集回應限制為允許查看常見問答集回應的特定使用者和群組。
例如，以下是基本 CSV 檔案，提供美國華盛頓州斯波坎市和美國密蘇里州山景市免費診所相關問題的答案。
How many free clinics are in Spokane WA?, 13
How many free clinics are there in Mountain View Missouri?, 7注意
常見問答集檔案必須是 UTF-8-encoded的檔案。
建立常見問答集檔案的索引欄位
注意
功能支援會因索引類型和正在使用的搜尋 API 而有所不同。若要查看您所使用的索引類型和搜尋 API 是否支援此功能，請參閱索引類型。
當您使用自訂 CSV 或 JSON 檔案進行輸入時，您可以為常見問答集問題宣告自訂欄位。例如，您可以建立自訂欄位，將每個常見問答集問題指派給業務單位。回應中傳回常見問答集時，您可以使用 部門做為構面，將搜尋範圍縮小為僅「HR」或「財務」。
自訂欄位必須對應至索引欄位。在 主控台中，您可以使用面向定義頁面來建立索引欄位。使用 API 時，您必須先使用 UpdateIndex API 建立索引欄位。
常見問答集檔案中的欄位/屬性類型必須符合相關聯的索引欄位類型。例如，「部門」欄位是STRING_LIST類型欄位。因此，您必須提供部門欄位的值做為 FAQ 檔案中的字串清單。您可以使用主控台中的面向定義頁面或使用 DescribeIndex API 來檢查索引欄位的類型。
當您建立映射到自訂屬性的索引欄位時，您可以標記它可顯示、可面向或可排序。您無法將自訂屬性設為可搜尋。
除了自訂屬性之外，您也可以使用 Amazon Kendra 自訂 CSV 或 JSON 檔案中的預留或常用欄位。如需詳細資訊，請參閱文件屬性或欄位。
基本 CSV 檔案
當您想要為FAQs使用簡單的結構時，請使用基本 CSV 檔案。在基本 CSV 檔案中，每一列有兩個或三個欄位：問題、答案和選用來源 URI，指向具有更多資訊的文件。
檔案的內容必須遵循逗號分隔值 (CSV) 檔案的 RFC 4180 通用格式和 MIME 類型
以下是基本 CSV 格式的常見問答集檔案。
How many free clinics are in Spokane WA?, 13, https://s3.region.company.com/bucket-name/directory/faq.csv
How many free clinics are there in Mountain View Missouri?, 7, https://s3.region.company.com/bucket-name/directory/faq.csv自訂 CSV 檔案
當您想要將自訂欄位/屬性新增至常見問答集問題時，請使用自訂 CSV 檔案。對於自訂 CSV 檔案，您可以使用 CSV 檔案中的標頭列來定義其他屬性。
CSV 檔案必須包含下列兩個必要欄位：
-
_question- 常見問題 -
_answer- 常見問題的答案
您的自訂 CSV 檔案可以同時包含 Amazon Kendra 預留欄位 （除了 _faq_id、_document_title、 _data_source_id和 _file_type) 和任何自訂欄位。
以下是自訂 CSV 檔案的範例。
_question,_answer,_last_updated_at,custom_string
How many free clinics are in Spokane WA?, 13, 2012-03-25T12:30:10+01:00, Note: Some free clinics require you to meet certain criteria in order to use their services
How many free clinics are there in Mountain View Missouri?, 7, 2012-03-25T12:30:10+01:00, Note: Some free clinics require you to meet certain criteria in order to use their services自訂檔案的內容必須遵循逗號分隔值 (CSV) 檔案的 RFC 4180 通用格式和 MIME 類型
下列列出自訂欄位的類型：
-
日期 — ISO 8601 編碼的日期和時間值。
例如，2012-03-25T12 月 25 日下午 12：30 （加上 10 秒），歐洲中部時區的 2012 年 3 月 35 日 ISO 8601 日期時間格式為 2012 年 3 月 30 日 12：30。
-
長 - 數字，例如
1234。 -
字串 - 字串值。如果您的字串包含逗號，請以雙引號 (") 括住整個值 （例如
"custom attribute, and more")。 -
字串清單 - 字串值的清單。列出逗號分隔清單中以引號 (") 括住的值 （例如
"item1, item2, item3")。如果清單只包含單一項目，您可以省略引號 （例如item1)。
自訂 CSV 檔案可以包含使用者存取控制欄位。您可以使用這些欄位，將常見問答集的存取權限制為特定使用者和群組。若要篩選使用者內容，使用者必須在查詢中提供使用者和群組資訊。否則，會傳回所有相關FAQs。如需詳細資訊，請參閱使用者內容篩選。
下列列出FAQs的使用者內容篩選條件：
-
_acl_user_allow—允許清單中的使用者可以在查詢回應中查看常見問答集。常見問答集不會傳回給其他使用者。 -
_acl_user_deny- 拒絕清單中的使用者無法在查詢回應中看到常見問答集。常見問答集會在與查詢相關時傳回給所有其他使用者。 -
_acl_group_allow- 屬於允許群組成員的使用者可以在查詢回應中查看常見問答集。常見問答集不會傳回給屬於其他群組的使用者。 -
_acl_group_deny- 作為拒絕群組成員的使用者在查詢回應中看不到常見問答集。當常見問答集與查詢相關時，會傳回給其他群組。
在以逗號分隔的清單中提供允許和拒絕清單的值，以引號括住 （例如，"user1,user2,user3")。您可以在允許清單或拒絕清單中包含使用者或群組，但不能同時包含個別允許相同使用者，也拒絕群組的使用者。如果您在這兩者中都包含使用者或群組，您會收到錯誤。
以下是具有使用者內容資訊的自訂 CSV 檔案範例。
_question, _answer, _acl_user_allow, _acl_user_deny, _acl_group_allow, _acl_group_deny How many free clinics are in Spokane WA?, 13, "userID6201,userID7552", "userID1001,userID2020", groupBasicPlusRate, groupPremiumRate
JSON 檔案
您可以使用 JSON 檔案來提供索引的問題、答案和欄位。您可以將任何 Amazon Kendra 預留欄位或自訂欄位新增至常見問答集。
以下是 JSON 檔案的結構描述。
{
"SchemaVersion": 1,
"FaqDocuments": [
{
"Question": string,
"Answer": string,
"Attributes": {
string: object
additional attributes
},
"AccessControlList": [
{
"Name": string,
"Type": enum( "GROUP" | "USER" ),
"Access": enum( "ALLOW" | "DENY" )
},
additional user context
]
},
additional FAQ documents
]
}下列範例 JSON 檔案顯示兩個常見問答集文件。其中一個文件只有必要的問題和答案。其他文件也包含其他欄位和使用者內容或存取控制資訊。
{
"SchemaVersion": 1,
"FaqDocuments": [
{
"Question": "How many free clinics are in Spokane WA?",
"Answer": "13"
},
{
"Question": "How many free clinics are there in Mountain View Missouri?",
"Answer": "7",
"Attributes": {
"_source_uri": "https://s3.region.company.com/bucket-name/directory/faq.csv",
"_category": "Charitable Clinics"
},
"AccessControlList": [
{
"Name": "user@amazon.com",
"Type": "USER",
"Access": "ALLOW"
},
{
"Name": "Admin",
"Type": "GROUP",
"Access": "ALLOW"
}
]
}
]
}下列列出自訂欄位的類型：
-
Date - 具有 ISO 8601 編碼日期和時間值的 JSON 字串值。例如，2012-03-25T12 月 25 日下午 12：30 （加上 10 秒），歐洲中部時區的 2012 年 3 月 35 日 ISO 8601 日期時間格式為 2012 年 3 月 30 日 12：30。
-
長 - JSON 數值，例如
1234。 -
字串 - JSON 字串值 （例如
"custom attribute")。 -
字串清單 - 字串值的 JSON 陣列 （例如
["item1,item2,item3"])。
JSON 檔案可以包含使用者存取控制欄位。您可以使用這些欄位，將常見問答集的存取權限制為特定使用者和群組。若要篩選使用者內容，使用者必須在查詢中提供使用者和群組資訊。否則，會傳回所有相關FAQs。如需詳細資訊，請參閱使用者內容篩選。
您可以在允許清單或拒絕清單中包含使用者或群組，但不能同時包含個別允許相同使用者，也拒絕群組的使用者。如果您在這兩者中都包含使用者或群組，您會收到錯誤。
以下是包含 JSON 常見問答集使用者存取控制的範例。
"AccessControlList": [
{
"Name": "group or user name",
"Type": "GROUP | USER",
"Access": "ALLOW | DENY"
},
additional user context
]
使用您的常見問答集檔案
將常見問答集輸入檔案存放在 S3 儲存貯體之後，您可以使用 主控台或 CreateFaq API 將問題和答案放入您的索引。如果您想要更新常見問答集，請刪除常見問答集並再次建立。您可以使用 DeleteFaq API 來刪除常見問答集。
您必須提供可存取包含來源檔案之 S3 儲存貯體 IAM 的角色。您可以在 主控台或 RoleArn 參數中指定角色。以下是將常見問答集檔案新增至索引的範例。
import boto3
kendra = boto3.client("kendra")
# Provide the index ID
index_id = "index-id"
# Provide the IAM role ARN required to index documents in an S3 bucket
role_arn = "arn:aws:iam::${accountId}:role/${roleName}"
# Provide the S3 bucket path information to the FAQ file
faq_path = {
"Bucket": "bucket-name",
"Key": "FreeClinicsUSA.csv"
}
response = kendra.create_faq(
S3Path = faq_path,
Name = "FreeClinicsUSA",
IndexId = index_id,
RoleArn = role_arn
)
print(response)英文以外語言的常見問答集檔案
您可以用支援的語言為常見問答集編製索引。如果您未指定語言，則根據預設，您可以使用英文為FAQs編製 Amazon Kendra 索引。您可以在呼叫 CreateFaq 操作時指定語言代碼，也可以在常見問答集中繼資料中包含常見問答集的語言代碼做為欄位。如果常見問答集在其中繼資料欄位中指定的中繼資料中沒有語言代碼，則常見問答集會使用您呼叫 CreateFAQ操作時指定的語言代碼編製索引。若要在主控台中以支援的語言編製常見問答集文件索引，請前往FAQs，然後選取新增常見問答集。您可以從下拉式清單中選擇語言。
