> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure Document Intelligence

> Connect a Document Intelligence resource to read text and layout from documents

Azure Document Intelligence reads scanned and digital documents and returns every word and line with its position on the page and a confidence score. Noxus uses it as an **OCR provider**, with the prebuilt **Read** model: document extraction fills your fields with the language model, and the boxes that show a reviewer where each value is printed come from Document Intelligence.

The processing runs in **your own Azure subscription**, in the region of the resource, and Azure bills that subscription directly.

## Set it up

<Steps>
  <Step title="Create a Document Intelligence resource">
    In the [Azure portal](https://portal.azure.com), create a **Document Intelligence** resource. Pick the region that matches your data residency.
  </Step>

  <Step title="Copy the endpoint and a key">
    Open the resource's **Keys and Endpoint** page. Copy the **Endpoint**, for example `https://my-resource.cognitiveservices.azure.com/`, and **KEY 1**.
  </Step>

  <Step title="Connect it in Noxus">
    Open **Workspace control → Connections**, click **Add connection**, and choose **Azure Document Intelligence**. Paste the **Endpoint** and the **Key**.

    Noxus checks the endpoint and key when you save. On success the status is **Active**, and the connection's **Metadata** tab shows the endpoint host, the model and the API version. The key itself is never shown again.
  </Step>
</Steps>

## When the connection is Invalid

The status shows **Invalid**, and the connection's **Metadata** tab shows the reason:

| Reason | What to do |
| :- | :- |
| Endpoint must be an https URL | Paste the full endpoint from the Keys and Endpoint page, including `https://`. |
| The key was refused by this endpoint | Copy KEY 1 or KEY 2 again from the same resource. |
| This endpoint is not a Document Intelligence resource | Use the endpoint of a Document Intelligence resource, not of another Azure AI service. |
| Could not reach the endpoint | Check the endpoint's spelling and that the resource allows public network access. |
| The endpoint must be a public address | Use the resource's public endpoint. Noxus does not connect to private network addresses. |

## Limits

* Up to **500 MB** per document on the standard tier.
* Pricing follows Azure's Document Intelligence Read price list and is charged to your subscription.