forked from Azure/azure-sdk-for-js
-
Notifications
You must be signed in to change notification settings - Fork 16
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
CodeGen from PR 31522 in Azure/azure-rest-api-specs
Merge 910c17175dd5f784f663d36bf260ee4639142330 into 894ad2b843adb5fe2efd44e70941f8c91997d112
- Loading branch information
SDKAuto
committed
Nov 16, 2024
1 parent
43142d2
commit 7c360c8
Showing
104 changed files
with
1,113 additions
and
6,558 deletions.
There are no files selected for viewing
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
153 changes: 3 additions & 150 deletions
153
sdk/documentintelligence/ai-document-intelligence-rest/CHANGELOG.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,154 +1,7 @@ | ||
| # Release History | ||
|
|
||
| ## 1.0.0-beta.3 (2024-08-20) | ||
| ## 1.0.0 (2024-11-16) | ||
|
|
||
| ### Features Added | ||
|
|
||
| - Added support for the Analyze Batch Documents API with the long-running operations, `/documentModels/{modelId}:analyzeBatch`. | ||
| - Added support for method `/documentModels/{modelId}/analyzeResults/{resultId}/pdf`. | ||
| - Added support for method `/documentModels/{modelId}/analyzeResults/{resultId}/figures/{figureId}`. | ||
| - Added support for the analysis method to specify other kinds of output through `AnalyzeDocumentFromStreamBodyParam#output` param : can be `pdf` and `figures`. | ||
| - Added property `id` to `Output` model. | ||
| - Added support for the Copy Classifier API with method `/documentClassifiers:authorizeCopy`. | ||
| - Added method `/documentClassifiers/{classifierId}:copyTo`. | ||
| - Added new enum type to `DocumentBuildMode`: `generative`. | ||
| - Added property `warnings` to `AnalyzeResultOutput ` model. | ||
| - Added properties `classifierId`, `split`, and `trainingHours` to `DocumentModelDetailsOutput` model. | ||
| - Added properties `confidenceThreshold`, `features`, `maxDocumentsToAnalyze`, `modelId`, and `queryFields` to `DocumentTypeDetailsOutput` model. | ||
| - Added properties `allowOverwrite` and `maxTrainingHours` to `BuildDocumentModelRequest` model. | ||
| - Added parameter `pages` to `ClassifyDocument` overloads. | ||
| - Added properties `classifierId`, `docTypes`, and `split` to `ComposeDocumentModelRequest`. | ||
| - Added property `allowOverwrite` to `BuildDocumentClassifierRequest`. | ||
| - Added property `getOperationId()` method to the pollers. | ||
|
|
||
| ### Other Changes | ||
|
|
||
| - The `@azure-rest/ai-document-intelligence` Rest Level Client Library, now targets the Azure AI Document Intelligence service API version `2024-07-31-preview`. Support for `2024-02-29-preview` has been removed. | ||
| - Removed support for extracting lists from analyzed documents: | ||
| - Removed models `DocumentListOutput` and `DocumentListItemOutput`. | ||
| - Removed property `lists` from `AnalyzeResultOutput`. | ||
| - Changes to the Compose Document API: | ||
| - Removed model `ComponentDocumentModelDetails`. | ||
| - Removed property `componentModels` from `ComposeDocumentModelRequest`. | ||
| - `ComposeDocumentModelRequest` now requires a map of `DocumentTypeDetails` and a classifier ID. | ||
| - Removed model `QuotaDetailsOutput`. | ||
| - Removed property `customNeuralDocumentModelBuilds` from `ResourceDetailsOutput`. | ||
| - Removed required property `fieldSchema` and from `DocumentTypeDetailsOuput`. | ||
| - `DocumentFieldType` is now a required property of `DocumentFieldSchema`. | ||
|
|
||
| ## 1.0.0-beta.2 (2024-03-06) | ||
|
|
||
| ### Features Added | ||
|
|
||
| - Support for "retry-after" header has been added for long-running operations, including `/documentModels/{modelId}:analyze`, `/documentModels:build`, and `/documentClassifiers:build`. | ||
| - `BuildDocumentClassifierContent` now includes a new property, `baseClassifierId`. | ||
| - `DocumentClassifierDetailsOutput` now includes a new property, `baseClassifierId`. | ||
| - A new property, `warnings`, has been added to `DocumentModelDetailsOutput` and `DocumentClassifierDetailsOutput`, represents an array of objects with `code`, `message`, and `target`. | ||
| - `DocumentFieldOutput` now includes a new property, `valueSelectionGroup`. | ||
| - A new member, `"completed"`, has been added to `OperationDetails#status`. | ||
|
|
||
| ### Breaking Changes | ||
|
|
||
| - The `@azure-rest/ai-document-intelligence` Rest Level Client Library, previously known as Form Recognizer, now targets the Azure AI Document Intelligence service API version `"2024-02-29-preview"`. Please note that support for `2023-10-31-preview` has been discontinued. | ||
|
|
||
| ## 1.0.0-beta.1 (2023-11-16) | ||
|
|
||
| ### Features Added | ||
|
|
||
| This marks the first preview of `@azure-rest/ai-document-intelligence` Rest Level Client Library for the Azure AI Document Intelligence service (formerly known as Form Recognizer), targeting service API version `"2023-10-31-preview"`. | ||
|
|
||
| _**Note: Form Recognizer has been rebranded to Document Intelligence.**_ | ||
|
|
||
| - Updates all REST API operation paths from `{endpoint}/formrecognizer` to `{endpoint}/documentintelligence`. SDK would handle this change automatically, users would not have to do additional work to support this. | ||
| - `@azure-rest/ai-document-intelligence` is the new package, replacing `@azure/ai-form-recognizer` package. The new package supports a Rest Level Client, which is part of the new generation of Azure SDKs to simplify the development experience. The new package is not compatible with the previous `@azure/ai-form-recognizer` package without necessary changes to your code. | ||
| - **Breaking Changes (with the `@azure/ai-form-recognizer` SDK)** - API shapes have been designed from scratch to support the new Rest Level Client for the Document Intelligence service. Please refer to the [Readme](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/documentintelligence/ai-document-intelligence-rest/README.md) and [Samples](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/documentintelligence/ai-document-intelligence-rest/samples) for more understanding. | ||
|
|
||
| ### `"2023-10-31-preview"` Service API version | ||
|
|
||
| The new `"2023-10-31-preview"` service version comes with some new features and a few breaking changes when compared to the API versions supported by the `@azure/ai-form-recognizer` library. | ||
|
|
||
| **New Features** | ||
|
|
||
| - **Markdown content format** | ||
|
|
||
| Supports output with Markdown content format along with the default plain _text_. For now, this is only supported for "prebuilt-layout". Markdown content format is deemed a more friendly format for LLM consumption in a chat or automation use scenario. | ||
|
|
||
| Service follows the GFM spec ([GitHub Flavored Markdown](https://github.github.com/gfm/)) for the Markdown format. Also introduces a new _contentFormat_ property with value "text" or "markdown" to indicate the result content format. | ||
|
|
||
| ```ts | ||
| import DocumentIntelligence from "@azure-rest/ai-document-intelligence"; | ||
| const client = DocumentIntelligence(process.env["DOCUMENT_INTELLIGENCE_ENDPOINT"], { | ||
| key: process.env["DOCUMENT_INTELLIGENCE_API_KEY"], | ||
| }); | ||
|
|
||
| const initialResponse = await client | ||
| .path("/documentModels/{modelId}:analyze", "prebuilt-layout") | ||
| .post({ | ||
| contentType: "application/json", | ||
| body: { | ||
| urlSource: | ||
| "https://raw.githubusercontent.com/Azure/azure-sdk-for-js/6704eff082aaaf2d97c1371a28461f512f8d748a/sdk/formrecognizer/ai-form-recognizer/assets/forms/Invoice_1.pdf", | ||
| }, | ||
| queryParameters: { outputContentFormat: "markdown" }, // <-- new query parameter | ||
| }); | ||
| ``` | ||
|
|
||
| - **Query Fields** | ||
|
|
||
| When this feature flag is specified, the service will further extract the values of the fields specified via the queryFields query parameter to supplement any existing fields defined by the model as fallback. | ||
|
|
||
| ```ts | ||
| await client.path("/documentModels/{modelId}:analyze", "prebuilt-layout").post({ | ||
| contentType: "application/json", | ||
| body: { urlSource: "..." }, | ||
| queryParameters: { | ||
| features: ["queryFields"], | ||
| queryFields: ["NumberOfGuests", "StoreNumber"], | ||
| }, // <-- new query parameter | ||
| }); | ||
| ``` | ||
|
|
||
| - **Split Options** | ||
|
|
||
| In the previous API versions supported by the older `@azure/ai-form-recognizer` library, document splitting and classification operation (`"/documentClassifiers/{classifierId}:analyze"`) always tried to split the input file into multiple documents. | ||
|
|
||
| To enable a wider set of scenarios, service introduces a "split" query parameter with the new "2023-10-31-preview" service version. The following values are supported: | ||
|
|
||
| - `split: "auto"` | ||
|
|
||
| Let service determine where to split. | ||
|
|
||
| - `split: "none"` | ||
|
|
||
| The entire file is treated as a single document. No splitting is performed. | ||
|
|
||
| - `split: "perPage"` | ||
|
|
||
| Each page is treated as a separate document. Each empty page is kept as its own document. | ||
|
|
||
| **Breaking Changes** | ||
|
|
||
| - **prebuilt-receipt** - Currency related fields have been updated. Currency symbol ("$") and code ("USD") are returned along with the amount as shown below. | ||
|
|
||
| ```json | ||
| { | ||
| "content": "$123.45", | ||
| "confidence": 0.995, | ||
| "type": "currency", | ||
| "valueCurrency": { | ||
| "amount": 123.45, | ||
| "currencySymbol": "$", | ||
| "currencyCode": "USD" | ||
| }, | ||
| ... | ||
| } | ||
| ``` | ||
|
|
||
| **Retirements/Deprecations** | ||
|
|
||
| - `"prebuilt-businessCard"` model is retired. | ||
| - `"prebuilt-document"` model is retired, this model is essentially `"prebuilt-layout"` with `features: ["keyValuePairs"]` specified. _(This is only supported as an optional feature for "prebuilt-layout" and "prebuilt-invoice".)_ | ||
|
|
||
| If you wish to still use these models, please rely on the older `@azure/ai-form-recognizer` library through the older service API versions. | ||
|
|
||
| If you were using the old `@azure/ai-form-recognizer` package, please refer [MIGRATION_GUIDE.MD](https://github.com/Azure/azure-sdk-for-js/blob/main/sdk/documentintelligence/ai-document-intelligence-rest/MIGRATION-FR_v4-DI_v1.md) for more details. | ||
| The package of @azure-rest/ai-document-intelligence is using our next generation design principles. To learn more, please refer to our documentation [Quick Start](https://aka.ms/azsdk/js/mgmt/quickstart). |
Oops, something went wrong.