文件智慧查詢欄位擷取

**文件智慧服務現支援查詢欄位，可擴充任何預建模型的結構描述，以擷取您需要的特定欄位。 查詢欄位也可以新增至配置，以從表單或文件擷取欄位和結構。

查詢欄位或索引鍵值組

查詢欄位和索引鍵值組會執行類似函式，在決定要選擇的功能時，有幾個差異要注意。

• 金鑰值組僅適用於配置和發票模型。 若想要擴充預建模型的結構描述，請使用查詢欄位。

• 您不知道要擷取的特定欄位，或欄位數量很多 (大於20 個)，則索引鍵值組可能是更好的解決方案。

• 索引鍵值組會擷取索引鍵和值，因為它們存在於表單或文件中，您需要規劃任何索引鍵變化。 例如，值 First Name 或 Given Name。 使用查詢欄位時，您可以定義索引鍵，而模型只會擷取對應的值。

• 無法將您所需的值描述為檔案中的索引鍵值組時，請使用查詢欄位。 例如，合約日期。

針對查詢欄位擷取，請指定您要擷取的欄位，而文件智慧會據以分析文件。 以下是範例：

• 如果您要在 Document Intelligence Studio 中處理合約，請使用 2024-11-30 （GA）API 版本：

  

• 您可以傳遞欄位標籤清單，例如 Party1、Party2、TermsOfUse、PaymentTerms、PaymentDate 和 TermEndDate，作為 AnalyzeDocument 要求的一部分。

  

• 除了查詢欄位之外，回應還包含模型輸出。 如需每個模型所擷取的功能或結構描述清單，請參閱模型分析功能。

查詢欄位 REST API 要求**

使用查詢欄位功能搭配一般文件模型，並將欄位新增至擷取流程，無需定型自訂模型：

POST https://{endpoint}/documentintelligence/documentModels/prebuilt-layout:analyze?api-version=2024-02-29-preview&features=queryFields&queryFields=Terms,PaymentDate HTTP/1.1
Host: *.cognitiveservices.azure.com
Content-Type: application/json
Ocp-Apim-Subscription-Key:

{
  "urlSource": "https://raw.githubusercontent.com/Azure-Samples/cognitive-services-REST-api-samples/master/curl/form-recognizer/sample-layout.pdf"
}

下一步