Is “query fields” supported in Document Intelligence on‑premise containers (layout‑4.0)?

Question

We’re running Azure Document Intelligence on‑premise using the Docker containers, specifically the v4.0 layout container: - Image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout-4.0:2024-11-30 - API version: 2024-11-30

Normal layout requests work fine (both :analyze and :syncAnalyze), but when we try to use the new query fields feature as documented here: https://learn.microsoft.com/en-us/azure/ai-services/document-intelligence/concept/query-fields?view=doc-intel-4.0.0 e.g.:

POST /documentintelligence/documentModels/prebuilt-layout:analyze
    ?api-version=2024-11-30
    &features=queryFields
    &queryFields=Field1,Field2

the request never completes.

In the container logs we see: - Layout result Status="Completed" written as UpstreamFRResult - Then: NextQueueNames='queryfield-2022-08-31' queueName='queryfield-2022-08-31' - Followed by repeated CheckStreamingTaskAsync ... resultCode='Missed chunked streaming service' It looks like the layout container enqueues a query‑fields work item, but there is no downstream worker / service to process it, so the HTTP response is never finalized.

Given this:

1. Is the query fields feature officially supported in the Document Intelligence v4.0 layout container (on‑premise) at all?
2. If it is not supported in containers yet: - Is there any roadmap or planned container image that will support query fields?

Answer 1

Hi @Martin ,

Thanks for your question!

No, the queryFields feature is not supported in the on-premise Document Intelligence layout-4.0 container.

The layout container is designed strictly for offline text, table, and structure extraction. Features like queryFields rely on secondary microservices that only run in the cloud-managed service. In the container, the request hangs with Missed chunked streaming service because those required downstream processing queues do not exist locally.

To fix this, you will either need to use the cloud-hosted Azure endpoint for queryFields or run the layout-4.0 container as normal and parse the fields in your own application code. Microsoft currently has no announced plans to bring queryFields to on-premise containers.

References:

https://learn.microsoft.com/azure/ai-services/document-intelligence/containers/configuration

https://learn.microsoft.com/azure/ai-services/document-intelligence/concept/query-fields

I hope this helps! If this answers your question, please consider accepting it to help others.